@vercel/factory 0.0.1 → 0.0.3

package/dist/{chunk-LBEYCOSR.js → chunk-EFL4PDDE.js}

@@ -1,24 +1,24 @@
+import {
+  changeIdSchema,
+  isoDateTimeSchema,
+  replyToSchema,
+  repositoryIdSchema,
+  repositoryIdsSchema,
+  schemaVersionSchema,
+  signalIdSchema,
+  taskIdSchema,
+  usdSchema,
+  vocabularySchema
+} from "./chunk-2JFES6BA.js";
 import {
   RecordNotFoundError
 } from "./chunk-CEF6VJZC.js";
 
-// src/schema/common.ts
-import { z } from "zod";
-var SCHEMA_VERSION = 1;
-var schemaVersionSchema = z.literal(SCHEMA_VERSION).describe("Version of the entity schema this row was written with.");
-var isoDateTimeSchema = z.iso.datetime().describe("UTC timestamp in ISO 8601 format, e.g. 2026-08-26T12:00:00Z.");
-var usdSchema = z.number().finite().nonnegative().describe("Amount in US dollars.");
-var vocabularySchema = z.string().regex(/^[a-z][a-z0-9_]{0,63}$/, "must be lowercase snake_case starting with a letter").describe("Lowercase snake_case name, e.g. github_issue or sentry_alert.");
-var replyToSchema = z.strictObject({
-  channel: z.string().min(1).describe("Connector that should carry replies, e.g. github or slack."),
-  address: z.string().min(1).describe("Connector-specific reply address, e.g. acme/web#41 or a Slack thread id.")
-});
-
 // src/schema/finding.ts
 import { createHash } from "crypto";
-import { z as z2 } from "zod";
-var findingPrioritySchema = z2.enum(["P0", "P1", "P2", "P3"]).describe("Urgency of a finding: P0 is drop-everything, P3 is nice-to-have.");
-var findingCategorySchema = z2.enum([
+import { z } from "zod";
+var findingPrioritySchema = z.enum(["P0", "P1", "P2", "P3"]).describe("Urgency of a finding: P0 is drop-everything, P3 is nice-to-have.");
+var findingCategorySchema = z.enum([
   "security",
   "correctness",
   "reliability",
@@ -30,10 +30,10 @@ var findingCategorySchema = z2.enum([
   "testing",
   "usability"
 ]);
-var findingVerificationLevelSchema = z2.enum(["unverified", "supported", "confirmed"]).describe(
+var findingVerificationLevelSchema = z.enum(["unverified", "supported", "confirmed"]).describe(
   "How sure the reporter is: unverified = suspected from reading; supported = evidence points to it; confirmed = demonstrated."
 );
-var findingVerificationMethodSchema = z2.enum([
+var findingVerificationMethodSchema = z.enum([
   "code_inspection",
   "static_analysis",
   "manual_reproduction",
@@ -43,23 +43,23 @@ var findingVerificationMethodSchema = z2.enum([
   "runtime_observation",
   "documentation"
 ]);
-var findingVerificationSchema = z2.strictObject({
+var findingVerificationSchema = z.strictObject({
   level: findingVerificationLevelSchema,
   method: findingVerificationMethodSchema,
-  summary: z2.string().min(1).max(2e3).describe("What was checked and what it showed."),
-  limitations: z2.string().min(1).max(2e3).optional().describe("What could not be checked.")
+  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.")
 });
-var findingSchema = z2.strictObject({
-  title: z2.string().min(1).max(200),
-  body: z2.string().min(1).max(8e3).describe("The problem, its impact, and how to fix it. Markdown."),
-  path: z2.string().min(1).max(500).optional().describe("Repository-relative file path."),
-  line: z2.number().int().min(1).optional(),
-  endLine: z2.number().int().min(1).optional(),
+var 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: z2.string().min(1).max(100).optional().describe("Scanner that produced it, e.g. deepsec."),
-  ruleId: z2.string().min(1).max(200).optional().describe("Scanner rule or check id, when there is one.")
+  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.")
 });
 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] : [
@@ -73,14 +73,14 @@ function findingFingerprint(repositoryId, finding) {
 }
 
 // src/approval.ts
-import { z as z3 } from "zod";
-var approvalRuleSchema = z3.strictObject({
+import { z as z2 } from "zod";
+var approvalRuleSchema = z2.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: z3.array(findingPrioritySchema).min(1).optional().describe("Finding priorities the rule applies to."),
-  require: z3.boolean().describe("Whether matching tasks wait for a human before dispatch.")
+  priority: z2.array(findingPrioritySchema).min(1).optional().describe("Finding priorities the rule applies to."),
+  require: z2.boolean().describe("Whether matching tasks wait for a human before dispatch.")
 });
-var approvalPolicySchema = z3.array(approvalRuleSchema).describe("First-match rules deciding which tasks need a human before they run.");
+var approvalPolicySchema = z2.array(approvalRuleSchema).describe("First-match rules deciding which tasks need a human before they run.");
 var defaultApprovalPolicy = [
   { kind: "verification", require: false },
   { source: "security_scan", require: true },
@@ -98,19 +98,6 @@ function requiresApproval(policy, subject) {
   return false;
 }
 
-// src/schema/id.ts
-import { z as z4 } from "zod";
-function idSchema(prefix) {
-  return z4.string().regex(new RegExp(`^${prefix}_[a-z0-9]{6,64}$`));
-}
-var factoryIdSchema = idSchema("fac");
-var repositoryIdSchema = idSchema("repo");
-var signalIdSchema = idSchema("sig");
-var taskIdSchema = idSchema("task");
-var changeIdSchema = idSchema("chg");
-var receiptIdSchema = idSchema("rcpt");
-var repositoryIdsSchema = z4.array(repositoryIdSchema).min(1);
-
 // src/dispatch.ts
 var DispatchRefusedError = class extends Error {
   taskId;
@@ -160,9 +147,9 @@ async function dispatchTask(stores, taskId, options) {
 }
 
 // src/schema/change.ts
-import { z as z5 } from "zod";
-var levelSchema = z5.enum(["low", "medium", "high"]);
-var changeStateSchema = z5.enum([
+import { z as z3 } from "zod";
+var levelSchema = z3.enum(["low", "medium", "high"]);
+var changeStateSchema = z3.enum([
   "verifying",
   "ready",
   "merged",
@@ -172,28 +159,28 @@ var changeStateSchema = z5.enum([
   "closed"
 ]);
 var postMergeStates = ["merged", "deployed", "rolled_out", "rolled_back"];
-var changeEvidenceSchema = z5.strictObject({
-  reproVerified: z5.boolean(),
-  testsAdded: z5.number().int().min(0),
-  checksGreen: z5.boolean(),
-  attackPassed: z5.boolean(),
-  scopeMatches: z5.boolean(),
-  previewUrl: z5.url().optional()
+var changeEvidenceSchema = z3.strictObject({
+  reproVerified: z3.boolean(),
+  testsAdded: z3.number().int().min(0),
+  checksGreen: z3.boolean(),
+  attackPassed: z3.boolean(),
+  scopeMatches: z3.boolean(),
+  previewUrl: z3.url().optional()
 });
-var changeSchema = z5.strictObject({
+var changeSchema = z3.strictObject({
   schemaVersion: schemaVersionSchema,
   id: changeIdSchema,
   repositoryId: repositoryIdSchema,
   taskId: taskIdSchema.optional(),
   groupId: taskIdSchema.optional(),
-  prNumber: z5.number().int().min(1),
-  prUrl: z5.url(),
-  author: z5.string().min(1),
+  prNumber: z3.number().int().min(1),
+  prUrl: z3.url(),
+  author: z3.string().min(1),
   risk: levelSchema,
   confidence: levelSchema,
   evidence: changeEvidenceSchema,
   state: changeStateSchema,
-  decidedBy: z5.string().min(1).optional(),
+  decidedBy: z3.string().min(1).optional(),
   createdAt: isoDateTimeSchema,
   updatedAt: isoDateTimeSchema
 }).superRefine((change, ctx) => {
@@ -207,7 +194,7 @@ var changeSchema = z5.strictObject({
 });
 
 // src/schema/task.ts
-import { z as z6 } from "zod";
+import { z as z4 } from "zod";
 var standardTaskKinds = [
   "code_change",
   "verification",
@@ -217,48 +204,48 @@ var standardTaskKinds = [
 var taskKindSchema = vocabularySchema.describe(
   "What kind of work this is, e.g. code_change, question, or a registered custom kind."
 );
-var taskStateSchema = z6.enum(["queued", "running", "verifying", "succeeded", "failed", "needs_human", "cancelled"]).describe("Lifecycle state. Transitions are fixed; see taskTransitions.");
-var taskApprovalSchema = z6.enum(["required", "granted", "denied"]).describe(
+var taskStateSchema = z4.enum(["queued", "running", "verifying", "succeeded", "failed", "needs_human", "cancelled"]).describe("Lifecycle state. Transitions are fixed; see taskTransitions.");
+var taskApprovalSchema = z4.enum(["required", "granted", "denied"]).describe(
   "Human approval status. Absent means no approval is needed. Stamped required at creation by policy; granted or denied by an operator."
 );
-var harnessSchema = z6.string().min(1).describe("Coding harness used in the devbox, e.g. claude-code or codex.");
-var taskOriginSchema = z6.strictObject({
+var harnessSchema = z4.string().min(1).describe("Coding harness used in the devbox, e.g. claude-code or codex.");
+var taskOriginSchema = z4.strictObject({
   signalId: signalIdSchema.optional().describe("Signal that led to this task."),
   parentTaskId: taskIdSchema.optional().describe("Parent task that planned this child."),
-  operator: z6.string().min(1).optional().describe("Human operator who requested it.")
+  operator: z4.string().min(1).optional().describe("Human operator who requested it.")
 }).refine(
   (origin) => origin.signalId !== void 0 || origin.parentTaskId !== void 0 || origin.operator !== void 0,
   { message: "origin requires a signalId, parentTaskId, or operator" }
 );
-var taskDevboxSchema = z6.strictObject({
-  devboxId: z6.string().min(1).describe("Devbox running or having run this task."),
-  remoteId: z6.string().min(1).describe("Provider-side id of the execution."),
+var taskDevboxSchema = z4.strictObject({
+  devboxId: z4.string().min(1).describe("Devbox running or having run this task."),
+  remoteId: z4.string().min(1).describe("Provider-side id of the execution."),
   harness: harnessSchema
 });
-var taskQuestionSchema = z6.strictObject({
-  text: z6.string().min(1).describe("The question a human must answer."),
-  options: z6.array(z6.string().min(1)).describe("Suggested answers; free-text is also allowed."),
-  answer: z6.string().min(1).optional(),
-  answeredBy: z6.string().min(1).optional().describe("Authenticated operator who answered.")
+var taskQuestionSchema = z4.strictObject({
+  text: z4.string().min(1).describe("The question a human must answer."),
+  options: z4.array(z4.string().min(1)).describe("Suggested answers; free-text is also allowed."),
+  answer: z4.string().min(1).optional(),
+  answeredBy: z4.string().min(1).optional().describe("Authenticated operator who answered.")
 });
-var taskSchema = z6.strictObject({
+var taskSchema = z4.strictObject({
   schemaVersion: schemaVersionSchema,
   id: taskIdSchema,
   repositoryIds: repositoryIdsSchema.optional().describe("Repositories the task works on; absent only on a multi-repo parent."),
   kind: taskKindSchema,
-  area: z6.string().min(1).optional().describe("Investigation area, e.g. onboarding or security. Investigation tasks only."),
+  area: z4.string().min(1).optional().describe("Investigation area, e.g. onboarding or security. Investigation tasks only."),
   state: taskStateSchema,
   approval: taskApprovalSchema.optional(),
   origin: taskOriginSchema,
-  dependsOn: z6.array(taskIdSchema).min(1).optional().describe("Sibling tasks that must produce a change before this one may run."),
+  dependsOn: z4.array(taskIdSchema).min(1).optional().describe("Sibling tasks that must produce a change before this one may run."),
   replyTo: replyToSchema,
   devbox: taskDevboxSchema.optional(),
-  attempt: z6.number().int().min(1).describe("Execution attempt, starting at 1; bumps on retry."),
+  attempt: z4.number().int().min(1).describe("Execution attempt, starting at 1; bumps on retry."),
   reservedUsd: usdSchema.optional().describe("Budget reserved before dispatch."),
   settledUsd: usdSchema.optional().describe("Measured cost settled after execution."),
   question: taskQuestionSchema.optional(),
   changeId: changeIdSchema.optional().describe("Change this code_change task produced."),
-  reportRef: z6.string().min(1).optional().describe("Reference to the report artifact an investigation produced."),
+  reportRef: z4.string().min(1).optional().describe("Reference to the report artifact an investigation produced."),
   createdAt: isoDateTimeSchema,
   updatedAt: isoDateTimeSchema
 }).superRefine((task, ctx) => {
@@ -308,12 +295,6 @@ var taskSchema = z6.strictObject({
 });
 
 export {
-  SCHEMA_VERSION,
-  schemaVersionSchema,
-  isoDateTimeSchema,
-  usdSchema,
-  vocabularySchema,
-  replyToSchema,
   findingPrioritySchema,
   findingCategorySchema,
   findingVerificationLevelSchema,
@@ -325,13 +306,6 @@ export {
   approvalPolicySchema,
   defaultApprovalPolicy,
   requiresApproval,
-  factoryIdSchema,
-  repositoryIdSchema,
-  signalIdSchema,
-  taskIdSchema,
-  changeIdSchema,
-  receiptIdSchema,
-  repositoryIdsSchema,
   DispatchRefusedError,
   dispatchTask,
   levelSchema,
@@ -348,4 +322,4 @@ export {
   taskQuestionSchema,
   taskSchema
 };
-//# sourceMappingURL=chunk-LBEYCOSR.js.map
+//# sourceMappingURL=chunk-EFL4PDDE.js.map

package/dist/chunk-EFL4PDDE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema/finding.ts","../src/approval.ts","../src/dispatch.ts","../src/schema/change.ts","../src/schema/task.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","import type { TaskId } from \"./schema/id\";\nimport type { Task } from \"./schema/task\";\nimport { RecordNotFoundError } from \"./store/driver\";\nimport type { FactoryStores } from \"./store/engine\";\n\nexport class DispatchRefusedError extends Error {\n  readonly taskId: TaskId;\n  readonly reason: string;\n\n  constructor(taskId: TaskId, reason: string) {\n    super(`dispatch of \"${taskId}\" refused: ${reason}`);\n    this.name = \"DispatchRefusedError\";\n    this.taskId = taskId;\n    this.reason = reason;\n  }\n}\n\nexport interface DispatchOptions {\n  /**\n   * Starts the durable execution for the task (an Eve agent run). Runs after\n   * the task has won the queued -> running transition. The execution owns its\n   * own provisioning: it creates its Devbox as its first step and patches the\n   * task record with the result.\n   */\n  launch: (task: Task) => Promise<void>;\n}\n\n/**\n * The handshake between recorded work and execution: win the store-gated\n * transition (at most one dispatcher can succeed), then start the run. A\n * launch failure moves the task to failed; a crash between the transition and\n * the launch leaves a running task with no execution, which the sweep reaps.\n */\nexport async function dispatchTask(\n  stores: FactoryStores,\n  taskId: TaskId,\n  options: DispatchOptions,\n): Promise<Task> {\n  const task = await stores.tasks.get(taskId);\n  if (task === null) {\n    throw new RecordNotFoundError(\"tasks\", taskId);\n  }\n  if (task.kind === \"question\") {\n    throw new DispatchRefusedError(taskId, \"question tasks are answered, not dispatched\");\n  }\n  if (task.approval === \"required\") {\n    throw new DispatchRefusedError(taskId, \"awaiting human approval\");\n  }\n  if (task.approval === \"denied\") {\n    throw new DispatchRefusedError(taskId, \"approval was denied\");\n  }\n  for (const dependencyId of task.dependsOn ?? []) {\n    const dependency = await stores.tasks.get(dependencyId);\n    if (dependency === null) {\n      throw new DispatchRefusedError(taskId, `dependency \"${dependencyId}\" does not exist`);\n    }\n    if (dependency.changeId === undefined) {\n      throw new DispatchRefusedError(\n        taskId,\n        `dependency \"${dependencyId}\" has not produced a change`,\n      );\n    }\n  }\n\n  const running = await stores.tasks.transition(taskId, \"running\");\n  try {\n    await options.launch(running);\n  } catch (error) {\n    const reason = (error instanceof Error ? error.message : String(error)).slice(0, 500);\n    await stores.tasks\n      .transition(taskId, \"failed\", { reason: `launch failed: ${reason}` })\n      .catch(() => undefined);\n    throw error;\n  }\n  return running;\n}\n","import { z } from \"zod\";\nimport { isoDateTimeSchema, schemaVersionSchema } from \"./common\";\nimport { changeIdSchema, repositoryIdSchema, taskIdSchema } from \"./id\";\n\nexport const levelSchema = z.enum([\"low\", \"medium\", \"high\"]);\n\nexport const changeStateSchema = z.enum([\n  \"verifying\",\n  \"ready\",\n  \"merged\",\n  \"deployed\",\n  \"rolled_out\",\n  \"rolled_back\",\n  \"closed\",\n]);\n\nconst postMergeStates: readonly string[] = [\"merged\", \"deployed\", \"rolled_out\", \"rolled_back\"];\n\nexport const changeEvidenceSchema = z.strictObject({\n  reproVerified: z.boolean(),\n  testsAdded: z.number().int().min(0),\n  checksGreen: z.boolean(),\n  attackPassed: z.boolean(),\n  scopeMatches: z.boolean(),\n  previewUrl: z.url().optional(),\n});\n\nexport const changeSchema = z\n  .strictObject({\n    schemaVersion: schemaVersionSchema,\n    id: changeIdSchema,\n    repositoryId: repositoryIdSchema,\n    taskId: taskIdSchema.optional(),\n    groupId: taskIdSchema.optional(),\n    prNumber: z.number().int().min(1),\n    prUrl: z.url(),\n    author: z.string().min(1),\n    risk: levelSchema,\n    confidence: levelSchema,\n    evidence: changeEvidenceSchema,\n    state: changeStateSchema,\n    decidedBy: z.string().min(1).optional(),\n    createdAt: isoDateTimeSchema,\n    updatedAt: isoDateTimeSchema,\n  })\n  .superRefine((change, ctx) => {\n    if (postMergeStates.includes(change.state) && change.decidedBy === undefined) {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"decidedBy\"],\n        message: `${change.state} changes require decidedBy`,\n      });\n    }\n  });\n\nexport type Level = z.infer<typeof levelSchema>;\nexport type ChangeState = z.infer<typeof changeStateSchema>;\nexport type ChangeEvidence = z.infer<typeof changeEvidenceSchema>;\nexport type Change = z.infer<typeof changeSchema>;\n","import { z } from \"zod\";\nimport {\n  isoDateTimeSchema,\n  replyToSchema,\n  schemaVersionSchema,\n  usdSchema,\n  vocabularySchema,\n} from \"./common\";\nimport { changeIdSchema, repositoryIdsSchema, signalIdSchema, taskIdSchema } from \"./id\";\n\n/**\n * Kinds the standard loop understands. Any vocabulary value is valid; the\n * kind-scoped rules below apply only to these standard kinds.\n */\nexport const standardTaskKinds = [\n  \"code_change\",\n  \"verification\",\n  \"investigation\",\n  \"question\",\n] as const;\n\nexport const taskKindSchema = vocabularySchema.describe(\n  \"What kind of work this is, e.g. code_change, question, or a registered custom kind.\",\n);\n\nexport const taskStateSchema = z\n  .enum([\"queued\", \"running\", \"verifying\", \"succeeded\", \"failed\", \"needs_human\", \"cancelled\"])\n  .describe(\"Lifecycle state. Transitions are fixed; see taskTransitions.\");\n\nexport const taskApprovalSchema = z\n  .enum([\"required\", \"granted\", \"denied\"])\n  .describe(\n    \"Human approval status. Absent means no approval is needed. Stamped required at creation by policy; granted or denied by an operator.\",\n  );\n\nexport const harnessSchema = z\n  .string()\n  .min(1)\n  .describe(\"Coding harness used in the devbox, e.g. claude-code or codex.\");\n\nexport const taskOriginSchema = z\n  .strictObject({\n    signalId: signalIdSchema.optional().describe(\"Signal that led to this task.\"),\n    parentTaskId: taskIdSchema.optional().describe(\"Parent task that planned this child.\"),\n    operator: z.string().min(1).optional().describe(\"Human operator who requested it.\"),\n  })\n  .refine(\n    (origin) =>\n      origin.signalId !== undefined ||\n      origin.parentTaskId !== undefined ||\n      origin.operator !== undefined,\n    { message: \"origin requires a signalId, parentTaskId, or operator\" },\n  );\n\nexport const taskDevboxSchema = z.strictObject({\n  devboxId: z.string().min(1).describe(\"Devbox running or having run this task.\"),\n  remoteId: z.string().min(1).describe(\"Provider-side id of the execution.\"),\n  harness: harnessSchema,\n});\n\nexport const taskQuestionSchema = z.strictObject({\n  text: z.string().min(1).describe(\"The question a human must answer.\"),\n  options: z.array(z.string().min(1)).describe(\"Suggested answers; free-text is also allowed.\"),\n  answer: z.string().min(1).optional(),\n  answeredBy: z.string().min(1).optional().describe(\"Authenticated operator who answered.\"),\n});\n\nexport const taskSchema = z\n  .strictObject({\n    schemaVersion: schemaVersionSchema,\n    id: taskIdSchema,\n    repositoryIds: repositoryIdsSchema\n      .optional()\n      .describe(\"Repositories the task works on; absent only on a multi-repo parent.\"),\n    kind: taskKindSchema,\n    area: z\n      .string()\n      .min(1)\n      .optional()\n      .describe(\"Investigation area, e.g. onboarding or security. Investigation tasks only.\"),\n    state: taskStateSchema,\n    approval: taskApprovalSchema.optional(),\n    origin: taskOriginSchema,\n    dependsOn: z\n      .array(taskIdSchema)\n      .min(1)\n      .optional()\n      .describe(\"Sibling tasks that must produce a change before this one may run.\"),\n    replyTo: replyToSchema,\n    devbox: taskDevboxSchema.optional(),\n    attempt: z\n      .number()\n      .int()\n      .min(1)\n      .describe(\"Execution attempt, starting at 1; bumps on retry.\"),\n    reservedUsd: usdSchema.optional().describe(\"Budget reserved before dispatch.\"),\n    settledUsd: usdSchema.optional().describe(\"Measured cost settled after execution.\"),\n    question: taskQuestionSchema.optional(),\n    changeId: changeIdSchema.optional().describe(\"Change this code_change task produced.\"),\n    reportRef: z\n      .string()\n      .min(1)\n      .optional()\n      .describe(\"Reference to the report artifact an investigation produced.\"),\n    createdAt: isoDateTimeSchema,\n    updatedAt: isoDateTimeSchema,\n  })\n  .superRefine((task, ctx) => {\n    if (task.area !== undefined && task.kind !== \"investigation\") {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"area\"],\n        message: \"area is only valid on investigation tasks\",\n      });\n    }\n    if (task.kind === \"question\") {\n      if (task.question === undefined) {\n        ctx.addIssue({\n          code: \"custom\",\n          path: [\"question\"],\n          message: \"question tasks require a question\",\n        });\n      }\n      if (task.devbox !== undefined) {\n        ctx.addIssue({\n          code: \"custom\",\n          path: [\"devbox\"],\n          message: \"question tasks never run in a devbox\",\n        });\n      }\n    } else if (task.question !== undefined) {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"question\"],\n        message: \"question is only valid on question tasks\",\n      });\n    }\n    if (task.changeId !== undefined && task.kind !== \"code_change\") {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"changeId\"],\n        message: \"changeId is only valid on code_change tasks\",\n      });\n    }\n    if (task.reportRef !== undefined && task.kind !== \"investigation\") {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"reportRef\"],\n        message: \"reportRef is only valid on investigation tasks\",\n      });\n    }\n  });\n\nexport type TaskApproval = z.infer<typeof taskApprovalSchema>;\nexport type TaskKind = z.infer<typeof taskKindSchema>;\nexport type TaskState = z.infer<typeof taskStateSchema>;\nexport type Task = z.infer<typeof taskSchema>;\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA,SAAS,kBAAkB;AAC3B,SAAS,SAAS;AAEX,IAAM,wBAAwB,EAClC,KAAK,CAAC,MAAM,MAAM,MAAM,IAAI,CAAC,EAC7B,SAAS,kEAAkE;AAEvE,IAAM,wBAAwB,EAAE,KAAK;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,IAAM,iCAAiC,EAC3C,KAAK,CAAC,cAAc,aAAa,WAAW,CAAC,EAC7C;AAAA,EACC;AACF;AAEK,IAAM,kCAAkC,EAAE,KAAK;AAAA,EACpD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAOM,IAAM,4BAA4B,EAAE,aAAa;AAAA,EACtD,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAI,EAAE,SAAS,sCAAsC;AAAA,EACpF,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAI,EAAE,SAAS,EAAE,SAAS,4BAA4B;AAC3F,CAAC;AAGM,IAAM,gBAAgB,EAAE,aAAa;AAAA,EAC1C,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EAChC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAI,EAAE,SAAS,uDAAuD;AAAA,EAClG,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,EAAE,SAAS,gCAAgC;AAAA,EACrF,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,SAAS;AAAA,EACvC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,SAAS;AAAA,EAC1C,UAAU;AAAA,EACV,UAAU;AAAA,EACV,cAAc;AAAA,EACd,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,EAAE,SAAS,yCAAyC;AAAA,EAC9F,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,EAAE,SAAS,8CAA8C;AACvG,CAAC;AAcM,SAAS,mBAAmB,cAAsB,SAA0B;AACjF,QAAM,QACJ,QAAQ,SAAS,UAAa,QAAQ,WAAW,UAAa,QAAQ,SAAS,SAC3E,CAAC,cAAc,QAAQ,MAAM,QAAQ,QAAQ,QAAQ,IAAI,IACzD;AAAA,IACE;AAAA,IACA,QAAQ,QAAQ;AAAA,IAChB,QAAQ,UAAU;AAAA,IAClB,QAAQ,QAAQ;AAAA,IAChB,QAAQ,MAAM,KAAK,EAAE,YAAY,EAAE,WAAW,SAAS,GAAG;AAAA,EAC5D;AACN,SAAO,WAAW,QAAQ,EAAE,OAAO,MAAM,KAAK,GAAG,CAAC,EAAE,OAAO,KAAK,EAAE,MAAM,GAAG,EAAE;AAC/E;;;ACvFA,SAAS,KAAAA,UAAS;AAQX,IAAM,qBAAqBC,GAAE,aAAa;AAAA,EAC/C,QAAQ,iBAAiB,SAAS,EAAE,SAAS,oDAAoD;AAAA,EACjG,MAAM,iBAAiB,SAAS,EAAE,SAAS,8BAA8B;AAAA,EACzE,UAAUA,GACP,MAAM,qBAAqB,EAC3B,IAAI,CAAC,EACL,SAAS,EACT,SAAS,yCAAyC;AAAA,EACrD,SAASA,GAAE,QAAQ,EAAE,SAAS,0DAA0D;AAC1F,CAAC;AAEM,IAAM,uBAAuBA,GACjC,MAAM,kBAAkB,EACxB,SAAS,sEAAsE;AAU3E,IAAM,wBAAwC;AAAA,EACnD,EAAE,MAAM,gBAAgB,SAAS,MAAM;AAAA,EACvC,EAAE,QAAQ,iBAAiB,SAAS,KAAK;AAAA,EACzC,EAAE,SAAS,MAAM;AACnB;AAaO,SAAS,iBAAiB,QAAwB,SAAmC;AAC1F,aAAW,QAAQ,QAAQ;AACzB,QAAI,KAAK,WAAW,UAAa,KAAK,WAAW,QAAQ,OAAQ;AACjE,QAAI,KAAK,SAAS,UAAa,KAAK,SAAS,QAAQ,KAAM;AAC3D,QAAI,KAAK,aAAa,QAAW;AAC/B,UAAI,QAAQ,aAAa,UAAa,CAAC,KAAK,SAAS,SAAS,QAAQ,QAAQ,EAAG;AAAA,IACnF;AACA,WAAO,KAAK;AAAA,EACd;AACA,SAAO;AACT;;;ACrDO,IAAM,uBAAN,cAAmC,MAAM;AAAA,EACrC;AAAA,EACA;AAAA,EAET,YAAY,QAAgB,QAAgB;AAC1C,UAAM,gBAAgB,MAAM,cAAc,MAAM,EAAE;AAClD,SAAK,OAAO;AACZ,SAAK,SAAS;AACd,SAAK,SAAS;AAAA,EAChB;AACF;AAkBA,eAAsB,aACpB,QACA,QACA,SACe;AACf,QAAM,OAAO,MAAM,OAAO,MAAM,IAAI,MAAM;AAC1C,MAAI,SAAS,MAAM;AACjB,UAAM,IAAI,oBAAoB,SAAS,MAAM;AAAA,EAC/C;AACA,MAAI,KAAK,SAAS,YAAY;AAC5B,UAAM,IAAI,qBAAqB,QAAQ,6CAA6C;AAAA,EACtF;AACA,MAAI,KAAK,aAAa,YAAY;AAChC,UAAM,IAAI,qBAAqB,QAAQ,yBAAyB;AAAA,EAClE;AACA,MAAI,KAAK,aAAa,UAAU;AAC9B,UAAM,IAAI,qBAAqB,QAAQ,qBAAqB;AAAA,EAC9D;AACA,aAAW,gBAAgB,KAAK,aAAa,CAAC,GAAG;AAC/C,UAAM,aAAa,MAAM,OAAO,MAAM,IAAI,YAAY;AACtD,QAAI,eAAe,MAAM;AACvB,YAAM,IAAI,qBAAqB,QAAQ,eAAe,YAAY,kBAAkB;AAAA,IACtF;AACA,QAAI,WAAW,aAAa,QAAW;AACrC,YAAM,IAAI;AAAA,QACR;AAAA,QACA,eAAe,YAAY;AAAA,MAC7B;AAAA,IACF;AAAA,EACF;AAEA,QAAM,UAAU,MAAM,OAAO,MAAM,WAAW,QAAQ,SAAS;AAC/D,MAAI;AACF,UAAM,QAAQ,OAAO,OAAO;AAAA,EAC9B,SAAS,OAAO;AACd,UAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG,MAAM,GAAG,GAAG;AACpF,UAAM,OAAO,MACV,WAAW,QAAQ,UAAU,EAAE,QAAQ,kBAAkB,MAAM,GAAG,CAAC,EACnE,MAAM,MAAM,MAAS;AACxB,UAAM;AAAA,EACR;AACA,SAAO;AACT;;;AC3EA,SAAS,KAAAC,UAAS;AAIX,IAAM,cAAcC,GAAE,KAAK,CAAC,OAAO,UAAU,MAAM,CAAC;AAEpD,IAAM,oBAAoBA,GAAE,KAAK;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,IAAM,kBAAqC,CAAC,UAAU,YAAY,cAAc,aAAa;AAEtF,IAAM,uBAAuBA,GAAE,aAAa;AAAA,EACjD,eAAeA,GAAE,QAAQ;AAAA,EACzB,YAAYA,GAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC;AAAA,EAClC,aAAaA,GAAE,QAAQ;AAAA,EACvB,cAAcA,GAAE,QAAQ;AAAA,EACxB,cAAcA,GAAE,QAAQ;AAAA,EACxB,YAAYA,GAAE,IAAI,EAAE,SAAS;AAC/B,CAAC;AAEM,IAAM,eAAeA,GACzB,aAAa;AAAA,EACZ,eAAe;AAAA,EACf,IAAI;AAAA,EACJ,cAAc;AAAA,EACd,QAAQ,aAAa,SAAS;AAAA,EAC9B,SAAS,aAAa,SAAS;AAAA,EAC/B,UAAUA,GAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC;AAAA,EAChC,OAAOA,GAAE,IAAI;AAAA,EACb,QAAQA,GAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACxB,MAAM;AAAA,EACN,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,OAAO;AAAA,EACP,WAAWA,GAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS;AAAA,EACtC,WAAW;AAAA,EACX,WAAW;AACb,CAAC,EACA,YAAY,CAAC,QAAQ,QAAQ;AAC5B,MAAI,gBAAgB,SAAS,OAAO,KAAK,KAAK,OAAO,cAAc,QAAW;AAC5E,QAAI,SAAS;AAAA,MACX,MAAM;AAAA,MACN,MAAM,CAAC,WAAW;AAAA,MAClB,SAAS,GAAG,OAAO,KAAK;AAAA,IAC1B,CAAC;AAAA,EACH;AACF,CAAC;;;ACrDH,SAAS,KAAAC,UAAS;AAcX,IAAM,oBAAoB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,iBAAiB,iBAAiB;AAAA,EAC7C;AACF;AAEO,IAAM,kBAAkBC,GAC5B,KAAK,CAAC,UAAU,WAAW,aAAa,aAAa,UAAU,eAAe,WAAW,CAAC,EAC1F,SAAS,8DAA8D;AAEnE,IAAM,qBAAqBA,GAC/B,KAAK,CAAC,YAAY,WAAW,QAAQ,CAAC,EACtC;AAAA,EACC;AACF;AAEK,IAAM,gBAAgBA,GAC1B,OAAO,EACP,IAAI,CAAC,EACL,SAAS,+DAA+D;AAEpE,IAAM,mBAAmBA,GAC7B,aAAa;AAAA,EACZ,UAAU,eAAe,SAAS,EAAE,SAAS,+BAA+B;AAAA,EAC5E,cAAc,aAAa,SAAS,EAAE,SAAS,sCAAsC;AAAA,EACrF,UAAUA,GAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,kCAAkC;AACpF,CAAC,EACA;AAAA,EACC,CAAC,WACC,OAAO,aAAa,UACpB,OAAO,iBAAiB,UACxB,OAAO,aAAa;AAAA,EACtB,EAAE,SAAS,wDAAwD;AACrE;AAEK,IAAM,mBAAmBA,GAAE,aAAa;AAAA,EAC7C,UAAUA,GAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,yCAAyC;AAAA,EAC9E,UAAUA,GAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,oCAAoC;AAAA,EACzE,SAAS;AACX,CAAC;AAEM,IAAM,qBAAqBA,GAAE,aAAa;AAAA,EAC/C,MAAMA,GAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,mCAAmC;AAAA,EACpE,SAASA,GAAE,MAAMA,GAAE,OAAO,EAAE,IAAI,CAAC,CAAC,EAAE,SAAS,+CAA+C;AAAA,EAC5F,QAAQA,GAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS;AAAA,EACnC,YAAYA,GAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,sCAAsC;AAC1F,CAAC;AAEM,IAAM,aAAaA,GACvB,aAAa;AAAA,EACZ,eAAe;AAAA,EACf,IAAI;AAAA,EACJ,eAAe,oBACZ,SAAS,EACT,SAAS,qEAAqE;AAAA,EACjF,MAAM;AAAA,EACN,MAAMA,GACH,OAAO,EACP,IAAI,CAAC,EACL,SAAS,EACT,SAAS,4EAA4E;AAAA,EACxF,OAAO;AAAA,EACP,UAAU,mBAAmB,SAAS;AAAA,EACtC,QAAQ;AAAA,EACR,WAAWA,GACR,MAAM,YAAY,EAClB,IAAI,CAAC,EACL,SAAS,EACT,SAAS,mEAAmE;AAAA,EAC/E,SAAS;AAAA,EACT,QAAQ,iBAAiB,SAAS;AAAA,EAClC,SAASA,GACN,OAAO,EACP,IAAI,EACJ,IAAI,CAAC,EACL,SAAS,mDAAmD;AAAA,EAC/D,aAAa,UAAU,SAAS,EAAE,SAAS,kCAAkC;AAAA,EAC7E,YAAY,UAAU,SAAS,EAAE,SAAS,wCAAwC;AAAA,EAClF,UAAU,mBAAmB,SAAS;AAAA,EACtC,UAAU,eAAe,SAAS,EAAE,SAAS,wCAAwC;AAAA,EACrF,WAAWA,GACR,OAAO,EACP,IAAI,CAAC,EACL,SAAS,EACT,SAAS,6DAA6D;AAAA,EACzE,WAAW;AAAA,EACX,WAAW;AACb,CAAC,EACA,YAAY,CAAC,MAAM,QAAQ;AAC1B,MAAI,KAAK,SAAS,UAAa,KAAK,SAAS,iBAAiB;AAC5D,QAAI,SAAS;AAAA,MACX,MAAM;AAAA,MACN,MAAM,CAAC,MAAM;AAAA,MACb,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACA,MAAI,KAAK,SAAS,YAAY;AAC5B,QAAI,KAAK,aAAa,QAAW;AAC/B,UAAI,SAAS;AAAA,QACX,MAAM;AAAA,QACN,MAAM,CAAC,UAAU;AAAA,QACjB,SAAS;AAAA,MACX,CAAC;AAAA,IACH;AACA,QAAI,KAAK,WAAW,QAAW;AAC7B,UAAI,SAAS;AAAA,QACX,MAAM;AAAA,QACN,MAAM,CAAC,QAAQ;AAAA,QACf,SAAS;AAAA,MACX,CAAC;AAAA,IACH;AAAA,EACF,WAAW,KAAK,aAAa,QAAW;AACtC,QAAI,SAAS;AAAA,MACX,MAAM;AAAA,MACN,MAAM,CAAC,UAAU;AAAA,MACjB,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACA,MAAI,KAAK,aAAa,UAAa,KAAK,SAAS,eAAe;AAC9D,QAAI,SAAS;AAAA,MACX,MAAM;AAAA,MACN,MAAM,CAAC,UAAU;AAAA,MACjB,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACA,MAAI,KAAK,cAAc,UAAa,KAAK,SAAS,iBAAiB;AACjE,QAAI,SAAS;AAAA,MACX,MAAM;AAAA,MACN,MAAM,CAAC,WAAW;AAAA,MAClB,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACF,CAAC;","names":["z","z","z","z","z","z"]}

package/dist/connectors/index.d.ts

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+
+declare const communicationOutcomes: readonly ["accepted", "started", "succeeded", "failed", "needs_human", "question", "digest", "rolled_back", "budget_warning", "budget_exhausted", "message"];
+declare const communicationOutcomeSchema: z.ZodEnum<{
+    accepted: "accepted";
+    started: "started";
+    succeeded: "succeeded";
+    failed: "failed";
+    needs_human: "needs_human";
+    question: "question";
+    digest: "digest";
+    rolled_back: "rolled_back";
+    budget_warning: "budget_warning";
+    budget_exhausted: "budget_exhausted";
+    message: "message";
+}>;
+declare const communicationEventSchema: z.ZodObject<{
+    eventId: z.ZodString;
+    repositoryId: z.ZodString;
+    taskId: z.ZodOptional<z.ZodString>;
+    changeId: z.ZodOptional<z.ZodString>;
+    replyTo: z.ZodObject<{
+        channel: z.ZodString;
+        address: z.ZodString;
+    }, z.core.$strict>;
+    outcome: z.ZodEnum<{
+        accepted: "accepted";
+        started: "started";
+        succeeded: "succeeded";
+        failed: "failed";
+        needs_human: "needs_human";
+        question: "question";
+        digest: "digest";
+        rolled_back: "rolled_back";
+        budget_warning: "budget_warning";
+        budget_exhausted: "budget_exhausted";
+        message: "message";
+    }>;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>;
+type CommunicationOutcome = z.infer<typeof communicationOutcomeSchema>;
+type CommunicationEvent = z.infer<typeof communicationEventSchema>;
+interface CommunicationAdapter {
+    readonly channel: string;
+    deliver(event: CommunicationEvent): Promise<void>;
+}
+interface CommunicationRouter {
+    readonly channels: readonly string[];
+    deliver(event: CommunicationEvent): Promise<void>;
+}
+declare function createCommunicationRouter(adapters: readonly CommunicationAdapter[]): CommunicationRouter;
+
+export { type CommunicationAdapter, type CommunicationEvent, type CommunicationOutcome, type CommunicationRouter, communicationEventSchema, communicationOutcomeSchema, communicationOutcomes, createCommunicationRouter };

package/dist/connectors/index.js

@@ -0,0 +1,64 @@
+import {
+  changeIdSchema,
+  replyToSchema,
+  repositoryIdSchema,
+  taskIdSchema
+} from "../chunk-2JFES6BA.js";
+
+// src/connectors/index.ts
+import { z } from "zod";
+var communicationOutcomes = [
+  "accepted",
+  "started",
+  "succeeded",
+  "failed",
+  "needs_human",
+  "question",
+  "digest",
+  "rolled_back",
+  "budget_warning",
+  "budget_exhausted",
+  "message"
+];
+var communicationOutcomeSchema = z.enum(communicationOutcomes).describe("Lifecycle outcome a connector should render and deliver.");
+var communicationEventSchema = z.strictObject({
+  eventId: z.string().min(1).describe("Stable idempotency key for this delivery."),
+  repositoryId: repositoryIdSchema,
+  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 createCommunicationRouter(adapters) {
+  const byChannel = /* @__PURE__ */ new Map();
+  for (const adapter of adapters) {
+    const channel = adapter.channel.trim();
+    if (channel.length === 0) {
+      throw new Error("Communication adapter channel is required.");
+    }
+    if (byChannel.has(channel)) {
+      throw new Error(`Communication adapter ${channel} is registered more than once.`);
+    }
+    byChannel.set(channel, adapter);
+  }
+  const channels = Object.freeze([...byChannel.keys()]);
+  return Object.freeze({
+    channels,
+    async deliver(input) {
+      const event = communicationEventSchema.parse(input);
+      const adapter = byChannel.get(event.replyTo.channel);
+      if (adapter === void 0) {
+        throw new Error(`No communication adapter is registered for ${event.replyTo.channel}.`);
+      }
+      await adapter.deliver(event);
+    }
+  });
+}
+export {
+  communicationEventSchema,
+  communicationOutcomeSchema,
+  communicationOutcomes,
+  createCommunicationRouter
+};
+//# sourceMappingURL=index.js.map

package/dist/connectors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/connectors/index.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { changeIdSchema, repositoryIdSchema, taskIdSchema } from \"../schema/id\";\nimport { replyToSchema } from \"../schema/common\";\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":";;;;;;;;AAAA,SAAS,SAAS;AAIX,IAAM,wBAAwB;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,6BAA6B,EACvC,KAAK,qBAAqB,EAC1B,SAAS,0DAA0D;AAE/D,IAAM,2BAA2B,EAAE,aAAa;AAAA,EACrD,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,2CAA2C;AAAA,EAC/E,cAAc;AAAA,EACd,QAAQ,aAAa,SAAS;AAAA,EAC9B,UAAU,eAAe,SAAS;AAAA,EAClC,SAAS;AAAA,EACT,SAAS;AAAA,EACT,MAAM,EACH,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,EAC9B,SAAS,2DAA2D;AACzE,CAAC;AAeM,SAAS,0BACd,UACqB;AACrB,QAAM,YAAY,oBAAI,IAAkC;AACxD,aAAW,WAAW,UAAU;AAC9B,UAAM,UAAU,QAAQ,QAAQ,KAAK;AACrC,QAAI,QAAQ,WAAW,GAAG;AACxB,YAAM,IAAI,MAAM,4CAA4C;AAAA,IAC9D;AACA,QAAI,UAAU,IAAI,OAAO,GAAG;AAC1B,YAAM,IAAI,MAAM,yBAAyB,OAAO,gCAAgC;AAAA,IAClF;AACA,cAAU,IAAI,SAAS,OAAO;AAAA,EAChC;AACA,QAAM,WAAW,OAAO,OAAO,CAAC,GAAG,UAAU,KAAK,CAAC,CAAC;AAEpD,SAAO,OAAO,OAAO;AAAA,IACnB;AAAA,IACA,MAAM,QAAQ,OAA0C;AACtD,YAAM,QAAQ,yBAAyB,MAAM,KAAK;AAClD,YAAM,UAAU,UAAU,IAAI,MAAM,QAAQ,OAAO;AACnD,UAAI,YAAY,QAAW;AACzB,cAAM,IAAI,MAAM,8CAA8C,MAAM,QAAQ,OAAO,GAAG;AAAA,MACxF;AACA,YAAM,QAAQ,QAAQ,KAAK;AAAA,IAC7B;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/eve/index.d.ts

@@ -2,6 +2,7 @@ import * as eve_hooks from 'eve/hooks';
 import * as eve_tools from 'eve/tools';
 import { z } from 'zod';
 import { F as FactoryStores, A as ApprovalPolicy, a as Finding } from '../approval-Z7iaWibT.js';
+import { GitHubReviewComment } from '../github.js';
 import '../common-CaHaEOAS.js';
 import '../driver-tRNggCCJ.js';
 
@@ -58,6 +59,69 @@ declare function fetchPullRequestTool<S extends CommandSandbox>(stores: FactoryS
     }, ctx: eve_tools.ToolContext): Promise<FetchPullRequestResult>;
 };
 
+declare const mergeConflictPayloadSchema: z.ZodObject<{
+    repository: z.ZodString;
+    prNumber: z.ZodNumber;
+    prUrl: z.ZodURL;
+    headBranch: z.ZodString;
+    headSha: z.ZodString;
+    baseBranch: z.ZodString;
+    baseSha: z.ZodString;
+}, z.core.$strict>;
+type MergeConflictPayload = z.infer<typeof mergeConflictPayloadSchema>;
+interface MergeConflictToolOptions<S extends CommandSandbox = CommandSandbox> {
+    withCredential: (sandbox: S, repository: string, command: string) => Promise<{
+        stdout: string;
+        stderr?: string;
+        exitCode?: number;
+    }>;
+    repoPath?: string;
+}
+declare function mergeConflictTools<S extends CommandSandbox>(stores: FactoryStores, options: MergeConflictToolOptions<S>): {
+    fetch_merge_conflict: eve_tools.ToolDefinition<{
+        taskId: string;
+    }, {
+        conflictedFiles: string[];
+        repository: string;
+        prNumber: number;
+        prUrl: string;
+        headBranch: string;
+        headSha: string;
+        baseBranch: string;
+        baseSha: string;
+    }> & {
+        execute(input: {
+            taskId: string;
+        }, ctx: eve_tools.ToolContext): Promise<{
+            conflictedFiles: string[];
+            repository: string;
+            prNumber: number;
+            prUrl: string;
+            headBranch: string;
+            headSha: string;
+            baseBranch: string;
+            baseSha: string;
+        }>;
+    };
+    publish_merge_resolution: eve_tools.ToolDefinition<{
+        taskId: string;
+        summary: string;
+    }, {
+        updated: true;
+        prNumber: number;
+        prUrl: string;
+    }> & {
+        execute(input: {
+            taskId: string;
+            summary: string;
+        }, ctx: eve_tools.ToolContext): Promise<{
+            updated: true;
+            prNumber: number;
+            prUrl: string;
+        }>;
+    };
+};
+
 interface RecordFindingOptions {
     /** Signal source the findings are recorded under. Defaults to security_scan. */
     source?: string;
@@ -314,6 +378,33 @@ declare function invokeAgentTool(stores: FactoryStores, options: InvokeAgentOpti
     }>;
 };
 
+interface ReviewCommentToolOptions {
+    tokenForRepository: (repository: string) => Promise<string>;
+    fetch?: typeof globalThis.fetch;
+}
+declare function reviewCommentTools(stores: FactoryStores, options: ReviewCommentToolOptions): {
+    read_review_comment: eve_tools.ToolDefinition<{
+        changeId: string;
+        commentId: number;
+    }, GitHubReviewComment> & {
+        execute(input: {
+            changeId: string;
+            commentId: number;
+        }, ctx: eve_tools.ToolContext): Promise<GitHubReviewComment>;
+    };
+    answer_review_comment: eve_tools.ToolDefinition<{
+        changeId: string;
+        commentId: number;
+        body: string;
+    }, GitHubReviewComment> & {
+        execute(input: {
+            changeId: string;
+            commentId: number;
+            body: string;
+        }, ctx: eve_tools.ToolContext): Promise<GitHubReviewComment>;
+    };
+};
+
 /**
  * The verifier's outcome tool. Writes evidence onto the change and moves it
  * to ready only when the verdict is pass; a failed verdict leaves the change
@@ -959,4 +1050,4 @@ declare function factoryHooks(stores: FactoryStores): {
 };
 type FactoryHooks = ReturnType<typeof factoryHooks>;
 
-export { type CommandSandbox, type DeepsecScanOptions, type FactoryHooks, type FactoryTools, type FactoryToolsOptions, type FetchPullRequestOptions, type FetchPullRequestResult, type GateVerdict, type InvokeAgentOptions, type RecordChangeInput, type RecordFindingOptions, type RecordFindingResult, deepsecScanTool, factoryHooks, factoryTools, fetchPullRequestTool, findingFromDeepsec, invokeAgentTool, recordFinding, recordFindingTool, recordVerificationTool };
+export { type CommandSandbox, type DeepsecScanOptions, type FactoryHooks, type FactoryTools, type FactoryToolsOptions, type FetchPullRequestOptions, type FetchPullRequestResult, type GateVerdict, type InvokeAgentOptions, type MergeConflictPayload, type MergeConflictToolOptions, type RecordChangeInput, type RecordFindingOptions, type RecordFindingResult, type ReviewCommentToolOptions, deepsecScanTool, factoryHooks, factoryTools, fetchPullRequestTool, findingFromDeepsec, invokeAgentTool, mergeConflictPayloadSchema, mergeConflictTools, recordFinding, recordFindingTool, recordVerificationTool, reviewCommentTools };