@vercel/factory 0.0.13 → 0.0.15

package/dist/change-verification/eve-tool.mjs

@@ -0,0 +1,101 @@
+import { changeIdSchema, taskIdSchema } from "../schema/id.mjs";
+import { requireTaskExecution } from "../eve/task-execution.mjs";
+import { changeEvidenceSchema, changeLevelSchema } from "../schema/change.mjs";
+import { z } from "zod";
+import { defineTool } from "eve/tools";
+//#region src/change-verification/eve-tool.ts
+/**
+* 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
+* verifying with the evidence recorded, and the verification task itself
+* ends with a receipt either way. The change's own code_change task follows
+* the verdict too: succeeded on pass, failed on fail with the verifier's
+* summary as the reason, so the ledger never shows a verified-and-rejected fix
+* as still in progress. Fail closed: the agent cannot mark a change ready
+* without supplying every evidence field. Requires the authenticated current
+* Task execution and matching parent, Change, and repository associations.
+*/
+function createRecordVerificationTool(stores, options = {}) {
+	return defineTool({
+		description: "Record the outcome of a verification task: the evidence you gathered and whether the change passed. Pass moves the change to ready for human review; fail keeps it out of review.",
+		inputSchema: z.object({
+			taskId: taskIdSchema.describe("Your verification task."),
+			changeId: changeIdSchema.describe("The change you verified."),
+			verdict: z.enum(["pass", "fail"]),
+			evidence: changeEvidenceSchema,
+			confidence: changeLevelSchema.describe("How certain you are in the verdict."),
+			summary: z.string().min(1).max(2e3).describe("What you checked and what you found.")
+		}),
+		async execute({ taskId, changeId, verdict, evidence, confidence, summary }, ctx) {
+			const task = await requireTaskExecution(stores, ctx, taskId);
+			const change = await stores.changes.get(changeId);
+			if (change === null) return {
+				recorded: false,
+				reason: `change ${changeId} does not exist`
+			};
+			if (change.state !== "verifying" && change.state !== "ready") return {
+				recorded: false,
+				reason: `change is ${change.state}, not open for verification; nothing to record`
+			};
+			const parent = task.parentTaskId === void 0 ? null : await stores.tasks.get(task.parentTaskId);
+			if (task.changeId !== changeId || parent === null || parent.changeId !== changeId || parent.state !== "verifying" || task.rootTaskId !== parent.rootTaskId || task.repositoryIds.length !== 1 || task.repositoryIds[0] !== change.repositoryId || parent.repositoryIds.length !== 1 || parent.repositoryIds[0] !== change.repositoryId) return {
+				recorded: false,
+				reason: "Verification Task, parent, Change, and repository must match"
+			};
+			await requireTaskExecution(stores, ctx, taskId);
+			let updatedChange = change;
+			if (verdict === "pass" && change.state === "verifying") updatedChange = await stores.changes.transition(changeId, "ready", {
+				patch: {
+					evidence,
+					confidence
+				},
+				reason: summary
+			});
+			else if (verdict === "fail" && change.state === "ready") updatedChange = await stores.changes.transition(changeId, "verifying", { reason: summary });
+			const output = {
+				changeId,
+				verdict,
+				evidence,
+				confidence,
+				summary
+			};
+			if (verdict === "pass") await stores.tasks.transition(taskId, "succeeded", {
+				expectFrom: "running",
+				expectAttempt: task.attempt,
+				expectExecution: task.execution,
+				output
+			});
+			else await stores.tasks.transition(taskId, "failed", {
+				expectFrom: "running",
+				expectAttempt: task.attempt,
+				expectExecution: task.execution,
+				reason: summary
+			});
+			await (verdict === "pass" ? stores.tasks.transition(parent.id, "succeeded", {
+				expectFrom: "verifying",
+				expectAttempt: parent.attempt,
+				output
+			}) : stores.tasks.transition(parent.id, "failed", {
+				expectFrom: "verifying",
+				expectAttempt: parent.attempt,
+				reason: `verification failed: ${summary}`
+			})).catch(() => void 0);
+			await options.presentResult?.({
+				taskId,
+				changeId,
+				verdict,
+				summary
+			});
+			return {
+				recorded: true,
+				verdict,
+				changeState: updatedChange.state,
+				taskState: verdict === "pass" ? "succeeded" : "failed"
+			};
+		}
+	});
+}
+//#endregion
+export { createRecordVerificationTool };
+
+//# sourceMappingURL=eve-tool.mjs.map

package/dist/change-verification/eve-tool.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"eve-tool.mjs","names":[],"sources":["../../src/change-verification/eve-tool.ts"],"sourcesContent":["import { defineTool, type ToolContext, type ToolDefinition } from \"eve/tools\";\nimport { z } from \"zod\";\nimport {\n  changeEvidenceSchema,\n  changeLevelSchema,\n  type ChangeEvidence,\n  type ChangeLevel,\n  type ChangeState,\n} from \"../schema/change\";\nimport { changeIdSchema, taskIdSchema } from \"../schema/id\";\nimport type { ChangeId, TaskId } from \"../schema/id\";\nimport type { FactoryStores } from \"../store/engine\";\nimport { requireTaskExecution } from \"../eve/task-execution\";\n\n/** Change and Task capabilities required by the verification-result tool. */\nexport type RecordVerificationToolStores = Pick<FactoryStores, \"changes\" | \"tasks\">;\n\n/** Verified outcome presented after its Task and Change updates commit. */\nexport interface PresentVerificationResultInput {\n  taskId: TaskId;\n  changeId: ChangeId;\n  verdict: \"pass\" | \"fail\";\n  summary: string;\n}\n\n/** Configures presentation after a verification verdict has been durably recorded. */\nexport interface RecordVerificationToolOptions {\n  presentResult?: (input: PresentVerificationResultInput) => Promise<void>;\n}\n\n/** Evidence and verdict supplied by the verifier for one Change. */\nexport interface RecordVerificationInput {\n  taskId: TaskId;\n  changeId: ChangeId;\n  verdict: \"pass\" | \"fail\";\n  evidence: ChangeEvidence;\n  confidence: ChangeLevel;\n  summary: string;\n}\n\n/** Bounded refusal returned when a verification result cannot be associated safely. */\nexport interface RecordVerificationRefusal {\n  readonly recorded: false;\n  readonly reason: string;\n}\n\n/** Durable lifecycle state returned after a verification verdict is recorded. */\nexport interface RecordVerificationSuccess {\n  readonly recorded: true;\n  readonly verdict: \"pass\" | \"fail\";\n  readonly changeState: ChangeState;\n  readonly taskState: \"succeeded\" | \"failed\";\n}\n\n/** Recorded verification state or bounded association refusal. */\nexport type RecordVerificationResult = RecordVerificationRefusal | RecordVerificationSuccess;\n\n/** Eve outcome tool that records evidence and a verdict for one Change. */\nexport interface RecordVerificationTool extends ToolDefinition<\n  RecordVerificationInput,\n  RecordVerificationResult\n> {\n  execute(input: RecordVerificationInput, ctx: ToolContext): Promise<RecordVerificationResult>;\n}\n\n/**\n * The verifier's outcome tool. Writes evidence onto the change and moves it\n * to ready only when the verdict is pass; a failed verdict leaves the change\n * verifying with the evidence recorded, and the verification task itself\n * ends with a receipt either way. The change's own code_change task follows\n * the verdict too: succeeded on pass, failed on fail with the verifier's\n * summary as the reason, so the ledger never shows a verified-and-rejected fix\n * as still in progress. Fail closed: the agent cannot mark a change ready\n * without supplying every evidence field. Requires the authenticated current\n * Task execution and matching parent, Change, and repository associations.\n */\nexport function createRecordVerificationTool(\n  stores: RecordVerificationToolStores,\n  options: RecordVerificationToolOptions = {},\n): RecordVerificationTool {\n  return defineTool({\n    description:\n      \"Record the outcome of a verification task: the evidence you gathered and whether the change passed. Pass moves the change to ready for human review; fail keeps it out of review.\",\n    inputSchema: z.object({\n      taskId: taskIdSchema.describe(\"Your verification task.\"),\n      changeId: changeIdSchema.describe(\"The change you verified.\"),\n      verdict: z.enum([\"pass\", \"fail\"]),\n      evidence: changeEvidenceSchema,\n      confidence: changeLevelSchema.describe(\"How certain you are in the verdict.\"),\n      summary: z.string().min(1).max(2000).describe(\"What you checked and what you found.\"),\n    }),\n    async execute(\n      { taskId, changeId, verdict, evidence, confidence, summary },\n      ctx,\n    ): Promise<RecordVerificationResult> {\n      const task = await requireTaskExecution(stores, ctx, taskId);\n      const change = await stores.changes.get(changeId);\n      if (change === null) {\n        return { recorded: false as const, reason: `change ${changeId} does not exist` };\n      }\n      if (change.state !== \"verifying\" && change.state !== \"ready\") {\n        return {\n          recorded: false as const,\n          reason: `change is ${change.state}, not open for verification; nothing to record`,\n        };\n      }\n\n      const parent =\n        task.parentTaskId === undefined ? null : await stores.tasks.get(task.parentTaskId);\n      if (\n        task.changeId !== changeId ||\n        parent === null ||\n        parent.changeId !== changeId ||\n        parent.state !== \"verifying\" ||\n        task.rootTaskId !== parent.rootTaskId ||\n        task.repositoryIds.length !== 1 ||\n        task.repositoryIds[0] !== change.repositoryId ||\n        parent.repositoryIds.length !== 1 ||\n        parent.repositoryIds[0] !== change.repositoryId\n      ) {\n        return {\n          recorded: false as const,\n          reason: \"Verification Task, parent, Change, and repository must match\",\n        };\n      }\n\n      await requireTaskExecution(stores, ctx, taskId);\n\n      let updatedChange = change;\n      if (verdict === \"pass\" && change.state === \"verifying\") {\n        updatedChange = await stores.changes.transition(changeId, \"ready\", {\n          patch: { evidence, confidence },\n          reason: summary,\n        });\n      } else if (verdict === \"fail\" && change.state === \"ready\") {\n        updatedChange = await stores.changes.transition(changeId, \"verifying\", {\n          reason: summary,\n        });\n      }\n\n      const output = { changeId, verdict, evidence, confidence, summary };\n      if (verdict === \"pass\") {\n        await stores.tasks.transition(taskId, \"succeeded\", {\n          expectFrom: \"running\",\n          expectAttempt: task.attempt,\n          expectExecution: task.execution,\n          output,\n        });\n      } else {\n        await stores.tasks.transition(taskId, \"failed\", {\n          expectFrom: \"running\",\n          expectAttempt: task.attempt,\n          expectExecution: task.execution,\n          reason: summary,\n        });\n      }\n\n      await (\n        verdict === \"pass\"\n          ? stores.tasks.transition(parent.id, \"succeeded\", {\n              expectFrom: \"verifying\",\n              expectAttempt: parent.attempt,\n              output,\n            })\n          : stores.tasks.transition(parent.id, \"failed\", {\n              expectFrom: \"verifying\",\n              expectAttempt: parent.attempt,\n              reason: `verification failed: ${summary}`,\n            })\n      ).catch(() => undefined);\n\n      await options.presentResult?.({ taskId, changeId, verdict, summary });\n\n      return {\n        recorded: true as const,\n        verdict,\n        changeState: updatedChange.state,\n        taskState: verdict === \"pass\" ? (\"succeeded\" as const) : (\"failed\" as const),\n      };\n    },\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA4EA,SAAgB,6BACd,QACA,UAAyC,CAAC,GAClB;CACxB,OAAO,WAAW;EAChB,aACE;EACF,aAAa,EAAE,OAAO;GACpB,QAAQ,aAAa,SAAS,yBAAyB;GACvD,UAAU,eAAe,SAAS,0BAA0B;GAC5D,SAAS,EAAE,KAAK,CAAC,QAAQ,MAAM,CAAC;GAChC,UAAU;GACV,YAAY,kBAAkB,SAAS,qCAAqC;GAC5E,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAI,CAAC,CAAC,SAAS,sCAAsC;EACtF,CAAC;EACD,MAAM,QACJ,EAAE,QAAQ,UAAU,SAAS,UAAU,YAAY,WACnD,KACmC;GACnC,MAAM,OAAO,MAAM,qBAAqB,QAAQ,KAAK,MAAM;GAC3D,MAAM,SAAS,MAAM,OAAO,QAAQ,IAAI,QAAQ;GAChD,IAAI,WAAW,MACb,OAAO;IAAE,UAAU;IAAgB,QAAQ,UAAU,SAAS;GAAiB;GAEjF,IAAI,OAAO,UAAU,eAAe,OAAO,UAAU,SACnD,OAAO;IACL,UAAU;IACV,QAAQ,aAAa,OAAO,MAAM;GACpC;GAGF,MAAM,SACJ,KAAK,iBAAiB,KAAA,IAAY,OAAO,MAAM,OAAO,MAAM,IAAI,KAAK,YAAY;GACnF,IACE,KAAK,aAAa,YAClB,WAAW,QACX,OAAO,aAAa,YACpB,OAAO,UAAU,eACjB,KAAK,eAAe,OAAO,cAC3B,KAAK,cAAc,WAAW,KAC9B,KAAK,cAAc,OAAO,OAAO,gBACjC,OAAO,cAAc,WAAW,KAChC,OAAO,cAAc,OAAO,OAAO,cAEnC,OAAO;IACL,UAAU;IACV,QAAQ;GACV;GAGF,MAAM,qBAAqB,QAAQ,KAAK,MAAM;GAE9C,IAAI,gBAAgB;GACpB,IAAI,YAAY,UAAU,OAAO,UAAU,aACzC,gBAAgB,MAAM,OAAO,QAAQ,WAAW,UAAU,SAAS;IACjE,OAAO;KAAE;KAAU;IAAW;IAC9B,QAAQ;GACV,CAAC;QACI,IAAI,YAAY,UAAU,OAAO,UAAU,SAChD,gBAAgB,MAAM,OAAO,QAAQ,WAAW,UAAU,aAAa,EACrE,QAAQ,QACV,CAAC;GAGH,MAAM,SAAS;IAAE;IAAU;IAAS;IAAU;IAAY;GAAQ;GAClE,IAAI,YAAY,QACd,MAAM,OAAO,MAAM,WAAW,QAAQ,aAAa;IACjD,YAAY;IACZ,eAAe,KAAK;IACpB,iBAAiB,KAAK;IACtB;GACF,CAAC;QAED,MAAM,OAAO,MAAM,WAAW,QAAQ,UAAU;IAC9C,YAAY;IACZ,eAAe,KAAK;IACpB,iBAAiB,KAAK;IACtB,QAAQ;GACV,CAAC;GAGH,OACE,YAAY,SACR,OAAO,MAAM,WAAW,OAAO,IAAI,aAAa;IAC9C,YAAY;IACZ,eAAe,OAAO;IACtB;GACF,CAAC,IACD,OAAO,MAAM,WAAW,OAAO,IAAI,UAAU;IAC3C,YAAY;IACZ,eAAe,OAAO;IACtB,QAAQ,wBAAwB;GAClC,CAAC,EAAA,CACL,YAAY,KAAA,CAAS;GAEvB,MAAM,QAAQ,gBAAgB;IAAE;IAAQ;IAAU;IAAS;GAAQ,CAAC;GAEpE,OAAO;IACL,UAAU;IACV;IACA,aAAa,cAAc;IAC3B,WAAW,YAAY,SAAU,cAAyB;GAC5D;EACF;CACF,CAAC;AACH"}

package/dist/changes/eve-record-change.d.mts

@@ -0,0 +1,56 @@
+import { Task } from "../schema/task.mjs";
+import { Change } from "../schema/change.mjs";
+import { FactoryStores } from "../store/engine.mjs";
+import { ChangePresenter } from "./presentation.mjs";
+import { PullRequestPublicationGateResult } from "../pull-requests/contracts.mjs";
+import { z } from "zod";
+import { ToolContext, ToolDefinition } from "eve/tools";
+//#region src/changes/eve-record-change.d.ts
+/** Change and Task capabilities required by the record-change tool. */
+type RecordChangeToolStores = Pick<FactoryStores, "changes" | "tasks">;
+declare const recordChangeInputSchema: z.ZodObject<{
+  taskId: z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>;
+  repositoryId: z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>;
+  prNumber: z.ZodNumber;
+  prUrl: z.ZodURL;
+  risk: z.ZodEnum<{
+    low: "low";
+    medium: "medium";
+    high: "high";
+  }>;
+  confidence: z.ZodEnum<{
+    low: "low";
+    medium: "medium";
+    high: "high";
+  }>;
+  summary: z.ZodString;
+}, z.core.$strip>;
+/** Validated input accepted by the tool that links a pull request to its producing Task. */
+type RecordChangeInput = z.infer<typeof recordChangeInputSchema>;
+/** Configures policy gates and durable presentation for the software record-change tool. */
+interface RecordChangeToolOptions {
+  /**
+   * Pre-action gate for record_change, run as an Eve approval policy before
+   * the tool executes. Refusals reach the model as a denial with the reason.
+   * Gates must fail closed: when they cannot verify, they refuse.
+   */
+  recordChangeGate?: (input: RecordChangeInput) => Promise<PullRequestPublicationGateResult>;
+  /** Whether recorded code changes wait for an independent verification task. Default: required. */
+  verification?: "required" | "disabled";
+  /** Present the pull request after record_change persists its durable state. */
+  presentChange?: ChangePresenter;
+}
+/** Change and producing Task returned after a pull request is recorded. */
+interface RecordChangeResult {
+  readonly change: Change;
+  readonly task: Task;
+}
+/** Eve outcome tool that links a pull request to its producing Task. */
+interface RecordChangeTool extends ToolDefinition<RecordChangeInput, RecordChangeResult> {
+  execute(input: RecordChangeInput, ctx: ToolContext): Promise<RecordChangeResult>;
+}
+/** Create the supplied software workflow's pull-request outcome tool. */
+declare function createRecordChangeTool(stores: RecordChangeToolStores, options?: RecordChangeToolOptions): RecordChangeTool;
+//#endregion
+export { RecordChangeInput, RecordChangeResult, RecordChangeTool, RecordChangeToolOptions, RecordChangeToolStores, createRecordChangeTool };
+//# sourceMappingURL=eve-record-change.d.mts.map

package/dist/changes/eve-record-change.mjs

@@ -0,0 +1,97 @@
+import { repositoryIdSchema, taskIdSchema } from "../schema/id.mjs";
+import { changeLevelSchema } from "../schema/change.mjs";
+import { z } from "zod";
+import { defineTool } from "eve/tools";
+//#region src/changes/eve-record-change.ts
+const recordChangeInputSchema = z.object({
+	taskId: taskIdSchema,
+	repositoryId: repositoryIdSchema,
+	prNumber: z.number().int().min(1),
+	prUrl: z.url(),
+	risk: changeLevelSchema.describe("Blast radius of the change if it is wrong."),
+	confidence: changeLevelSchema.describe("How certain you are the change is correct."),
+	summary: z.string().min(1).describe("One-sentence description of the change.")
+});
+/** Create the supplied software workflow's pull-request outcome tool. */
+function createRecordChangeTool(stores, options = {}) {
+	const recordChangeGate = options.recordChangeGate;
+	const verification = options.verification ?? "required";
+	return defineTool({
+		description: verification === "required" ? "Record the pull request produced for a code_change task. Creates the change, links it to the task, and moves the task to verifying." : "Record the pull request produced for a code_change task. Creates the change and marks it ready for human review without independent verification.",
+		inputSchema: recordChangeInputSchema,
+		...recordChangeGate === void 0 ? {} : { approval: async ({ toolInput }) => {
+			const parsed = recordChangeInputSchema.safeParse(toolInput);
+			if (!parsed.success) return {
+				type: "denied",
+				reason: "record_change input is malformed; fix the arguments and retry"
+			};
+			const verdict = await recordChangeGate(parsed.data);
+			return verdict.ok ? "not-applicable" : {
+				type: "denied",
+				reason: verdict.reason
+			};
+		} },
+		async execute({ taskId, repositoryId, prNumber, prUrl, risk, confidence, summary }) {
+			const currentTask = await stores.tasks.get(taskId);
+			if (currentTask === null) throw new Error(`task ${taskId} does not exist`);
+			if (currentTask.state !== "running" && currentTask.state !== "verifying" && currentTask.state !== "succeeded") throw new Error(`task ${taskId} is ${currentTask.state}, not running`);
+			const linkedChange = currentTask.changeId === void 0 ? void 0 : await stores.changes.get(currentTask.changeId);
+			if (currentTask.changeId !== void 0 && linkedChange === null) throw new Error(`change ${currentTask.changeId} does not exist`);
+			let change = linkedChange ?? (await stores.changes.list()).find((candidate) => candidate.taskId === taskId);
+			if (change === void 0) {
+				if (currentTask.state !== "running") throw new Error(`task ${taskId} has no recorded change`);
+				change = await stores.changes.create({
+					repositoryId,
+					taskId,
+					prNumber,
+					prUrl,
+					author: "factory",
+					risk,
+					confidence,
+					evidence: {
+						reproVerified: false,
+						testsAdded: 0,
+						checksGreen: false,
+						attackPassed: false,
+						scopeMatches: false
+					}
+				});
+			}
+			if (change === void 0) throw new Error(`task ${taskId} has no recorded change`);
+			let recordedChange = change;
+			if (currentTask.state === "running") await options.presentChange?.({
+				taskId,
+				changeId: recordedChange.id,
+				verification,
+				summary
+			});
+			let task = currentTask;
+			if (task.state === "running") task = await stores.tasks.transition(taskId, "verifying", {
+				patch: { changeId: recordedChange.id },
+				reason: summary
+			});
+			if (verification === "required") return {
+				change: recordedChange,
+				task
+			};
+			if (recordedChange.state === "verifying") recordedChange = await stores.changes.transition(recordedChange.id, "ready", { reason: "independent verification is not configured" });
+			if (task.state === "verifying") task = await stores.tasks.transition(taskId, "succeeded", {
+				reason: "change recorded for human review without independent verification",
+				output: {
+					changeId: recordedChange.id,
+					prUrl: recordedChange.prUrl,
+					summary,
+					verification
+				}
+			});
+			return {
+				change: recordedChange,
+				task
+			};
+		}
+	});
+}
+//#endregion
+export { createRecordChangeTool };
+
+//# sourceMappingURL=eve-record-change.mjs.map

package/dist/changes/eve-record-change.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"eve-record-change.mjs","names":[],"sources":["../../src/changes/eve-record-change.ts"],"sourcesContent":["import { defineTool, type ToolContext, type ToolDefinition } from \"eve/tools\";\nimport { z } from \"zod\";\nimport type { ChangePresenter } from \"./presentation\";\nimport { changeLevelSchema, type Change } from \"../schema/change\";\nimport { repositoryIdSchema, taskIdSchema } from \"../schema/id\";\nimport type { Task } from \"../schema/task\";\nimport type { PullRequestPublicationGateResult } from \"../pull-requests/contracts\";\nimport type { FactoryStores } from \"../store/engine\";\n\n/** Change and Task capabilities required by the record-change tool. */\nexport type RecordChangeToolStores = Pick<FactoryStores, \"changes\" | \"tasks\">;\n\nconst recordChangeInputSchema = z.object({\n  taskId: taskIdSchema,\n  repositoryId: repositoryIdSchema,\n  prNumber: z.number().int().min(1),\n  prUrl: z.url(),\n  risk: changeLevelSchema.describe(\"Blast radius of the change if it is wrong.\"),\n  confidence: changeLevelSchema.describe(\"How certain you are the change is correct.\"),\n  summary: z.string().min(1).describe(\"One-sentence description of the change.\"),\n});\n\n/** Validated input accepted by the tool that links a pull request to its producing Task. */\nexport type RecordChangeInput = z.infer<typeof recordChangeInputSchema>;\n\n/** Configures policy gates and durable presentation for the software record-change tool. */\nexport interface RecordChangeToolOptions {\n  /**\n   * Pre-action gate for record_change, run as an Eve approval policy before\n   * the tool executes. Refusals reach the model as a denial with the reason.\n   * Gates must fail closed: when they cannot verify, they refuse.\n   */\n  recordChangeGate?: (input: RecordChangeInput) => Promise<PullRequestPublicationGateResult>;\n  /** Whether recorded code changes wait for an independent verification task. Default: required. */\n  verification?: \"required\" | \"disabled\";\n  /** Present the pull request after record_change persists its durable state. */\n  presentChange?: ChangePresenter;\n}\n\n/** Change and producing Task returned after a pull request is recorded. */\nexport interface RecordChangeResult {\n  readonly change: Change;\n  readonly task: Task;\n}\n\n/** Eve outcome tool that links a pull request to its producing Task. */\nexport interface RecordChangeTool extends ToolDefinition<RecordChangeInput, RecordChangeResult> {\n  execute(input: RecordChangeInput, ctx: ToolContext): Promise<RecordChangeResult>;\n}\n\n/** Create the supplied software workflow's pull-request outcome tool. */\nexport function createRecordChangeTool(\n  stores: RecordChangeToolStores,\n  options: RecordChangeToolOptions = {},\n): RecordChangeTool {\n  const recordChangeGate = options.recordChangeGate;\n  const verification = options.verification ?? \"required\";\n  return defineTool({\n    description:\n      verification === \"required\"\n        ? \"Record the pull request produced for a code_change task. Creates the change, links it to the task, and moves the task to verifying.\"\n        : \"Record the pull request produced for a code_change task. Creates the change and marks it ready for human review without independent verification.\",\n    inputSchema: recordChangeInputSchema,\n    ...(recordChangeGate === undefined\n      ? {}\n      : {\n          approval: async ({ toolInput }: { toolInput?: unknown }) => {\n            const parsed = recordChangeInputSchema.safeParse(toolInput);\n            if (!parsed.success) {\n              return {\n                type: \"denied\" as const,\n                reason: \"record_change input is malformed; fix the arguments and retry\",\n              };\n            }\n            const verdict = await recordChangeGate(parsed.data);\n            return verdict.ok\n              ? (\"not-applicable\" as const)\n              : { type: \"denied\" as const, reason: verdict.reason };\n          },\n        }),\n    async execute({\n      taskId,\n      repositoryId,\n      prNumber,\n      prUrl,\n      risk,\n      confidence,\n      summary,\n    }): Promise<RecordChangeResult> {\n      const currentTask = await stores.tasks.get(taskId);\n      if (currentTask === null) throw new Error(`task ${taskId} does not exist`);\n      if (\n        currentTask.state !== \"running\" &&\n        currentTask.state !== \"verifying\" &&\n        currentTask.state !== \"succeeded\"\n      ) {\n        throw new Error(`task ${taskId} is ${currentTask.state}, not running`);\n      }\n      const linkedChange =\n        currentTask.changeId === undefined\n          ? undefined\n          : await stores.changes.get(currentTask.changeId);\n      if (currentTask.changeId !== undefined && linkedChange === null) {\n        throw new Error(`change ${currentTask.changeId} does not exist`);\n      }\n      let change =\n        linkedChange ??\n        (await stores.changes.list()).find((candidate) => candidate.taskId === taskId);\n\n      if (change === undefined) {\n        if (currentTask.state !== \"running\") {\n          throw new Error(`task ${taskId} has no recorded change`);\n        }\n        change = await stores.changes.create({\n          repositoryId,\n          taskId,\n          prNumber,\n          prUrl,\n          author: \"factory\",\n          risk,\n          confidence,\n          evidence: {\n            reproVerified: false,\n            testsAdded: 0,\n            checksGreen: false,\n            attackPassed: false,\n            scopeMatches: false,\n          },\n        });\n      }\n      if (change === undefined) throw new Error(`task ${taskId} has no recorded change`);\n      let recordedChange = change;\n\n      if (currentTask.state === \"running\") {\n        await options.presentChange?.({\n          taskId,\n          changeId: recordedChange.id,\n          verification,\n          summary,\n        });\n      }\n\n      let task: Task = currentTask;\n      if (task.state === \"running\") {\n        task = await stores.tasks.transition(taskId, \"verifying\", {\n          patch: { changeId: recordedChange.id },\n          reason: summary,\n        });\n      }\n      if (verification === \"required\") return { change: recordedChange, task };\n\n      if (recordedChange.state === \"verifying\") {\n        recordedChange = await stores.changes.transition(recordedChange.id, \"ready\", {\n          reason: \"independent verification is not configured\",\n        });\n      }\n      if (task.state === \"verifying\") {\n        task = await stores.tasks.transition(taskId, \"succeeded\", {\n          reason: \"change recorded for human review without independent verification\",\n          output: {\n            changeId: recordedChange.id,\n            prUrl: recordedChange.prUrl,\n            summary,\n            verification,\n          },\n        });\n      }\n      return { change: recordedChange, task };\n    },\n  });\n}\n"],"mappings":"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"}

package/dist/changes/presentation.d.mts

@@ -0,0 +1,14 @@
+import { ChangeId, TaskId } from "../schema/id.mjs";
+//#region src/changes/presentation.d.ts
+/** Details presented after a pull request is durably recorded as a Change. */
+interface PresentChangeInput {
+  taskId: TaskId;
+  changeId: ChangeId;
+  verification: "required" | "disabled";
+  summary: string;
+}
+/** Presents a newly recorded Change through an application-owned channel. */
+type ChangePresenter = (input: PresentChangeInput) => Promise<void>;
+//#endregion
+export { ChangePresenter, PresentChangeInput };
+//# sourceMappingURL=presentation.d.mts.map

package/dist/changes.d.mts

@@ -0,0 +1,23 @@
+import { ChangeId, RepositoryId, changeIdSchema } from "./schema/id.mjs";
+import { Change, ChangeEvidence, ChangeInState, ChangeLevel, ChangeState, changeEvidenceSchema, changeLevelSchema, changeSchema, changeStateSchema } from "./schema/change.mjs";
+import { ChangeAssociationError, ChangePatch, ChangeTransitionArguments, ChangeTransitionOptions, CreateChangeInput, FactoryStores } from "./store/engine.mjs";
+import { changeInitialState, changeTransitions } from "./schema/transitions.mjs";
+import { ChangePresenter, PresentChangeInput } from "./changes/presentation.mjs";
+import { RecordChangeInput, RecordChangeResult, RecordChangeTool, RecordChangeToolOptions, RecordChangeToolStores, createRecordChangeTool } from "./changes/eve-record-change.mjs";
+import { formatChangeVerificationBrief } from "./change-verification/brief.mjs";
+import { ChangeVerificationStores, EnsureChangeVerificationTasksOptions, EnsureChangeVerificationTasksResult, ensureChangeVerificationTasks } from "./change-verification/dispatch.mjs";
+import { PresentVerificationResultInput, RecordVerificationInput, RecordVerificationRefusal, RecordVerificationResult, RecordVerificationSuccess, RecordVerificationTool, RecordVerificationToolOptions, RecordVerificationToolStores, createRecordVerificationTool } from "./change-verification/eve-tool.mjs";
+import { CreateMultiRepositoryChangeTasksInput, CreateMultiRepositoryChangeTasksStores, MultiRepositoryChangePlan, ReconcileMultiRepositoryChangeTasksResult, ReconcileMultiRepositoryChangeTasksStores, createMultiRepositoryChangeTasks, reconcileMultiRepositoryChangeTasks } from "./multi-repository-changes/coordination.mjs";
+//#region src/changes.d.ts
+/** Provider identity and author required to represent an existing pull request as a Change. */
+interface AdoptPullRequestInput {
+  repositoryId: RepositoryId;
+  prNumber: number;
+  prUrl: string;
+  author: string;
+}
+/** Create a conservative, unverified Change for a pull request not authored by Factory. */
+declare function adoptPullRequest(stores: Pick<FactoryStores, "changes">, input: AdoptPullRequestInput): Promise<Change>;
+//#endregion
+export { AdoptPullRequestInput, type Change, ChangeAssociationError, type ChangeEvidence, type ChangeId, type ChangeInState, type ChangeLevel, type ChangePatch, type ChangePresenter, type ChangeState, type ChangeTransitionArguments, type ChangeTransitionOptions, type ChangeVerificationStores, type CreateChangeInput, type CreateMultiRepositoryChangeTasksInput, type CreateMultiRepositoryChangeTasksStores, type EnsureChangeVerificationTasksOptions, type EnsureChangeVerificationTasksResult, type MultiRepositoryChangePlan, type PresentChangeInput, type PresentVerificationResultInput, type ReconcileMultiRepositoryChangeTasksResult, type ReconcileMultiRepositoryChangeTasksStores, type RecordChangeInput, type RecordChangeResult, type RecordChangeTool, type RecordChangeToolOptions, type RecordChangeToolStores, type RecordVerificationInput, type RecordVerificationRefusal, type RecordVerificationResult, type RecordVerificationSuccess, type RecordVerificationTool, type RecordVerificationToolOptions, type RecordVerificationToolStores, adoptPullRequest, changeEvidenceSchema, changeIdSchema, changeInitialState, changeLevelSchema, changeSchema, changeStateSchema, changeTransitions, createMultiRepositoryChangeTasks, createRecordChangeTool, createRecordVerificationTool, ensureChangeVerificationTasks, formatChangeVerificationBrief, reconcileMultiRepositoryChangeTasks };
+//# sourceMappingURL=changes.d.mts.map

package/dist/changes.mjs

@@ -0,0 +1,29 @@
+import { changeIdSchema } from "./schema/id.mjs";
+import { changeInitialState, changeTransitions } from "./schema/transitions.mjs";
+import { changeEvidenceSchema, changeLevelSchema, changeSchema, changeStateSchema } from "./schema/change.mjs";
+import { ChangeAssociationError } from "./store/engine.mjs";
+import { createRecordChangeTool } from "./changes/eve-record-change.mjs";
+import { formatChangeVerificationBrief } from "./change-verification/brief.mjs";
+import { ensureChangeVerificationTasks } from "./change-verification/dispatch.mjs";
+import { createRecordVerificationTool } from "./change-verification/eve-tool.mjs";
+import { createMultiRepositoryChangeTasks, reconcileMultiRepositoryChangeTasks } from "./multi-repository-changes/coordination.mjs";
+//#region src/changes.ts
+/** Create a conservative, unverified Change for a pull request not authored by Factory. */
+async function adoptPullRequest(stores, input) {
+	return stores.changes.create({
+		...input,
+		risk: "low",
+		confidence: "low",
+		evidence: {
+			reproVerified: false,
+			testsAdded: 0,
+			checksGreen: false,
+			attackPassed: false,
+			scopeMatches: false
+		}
+	});
+}
+//#endregion
+export { ChangeAssociationError, adoptPullRequest, changeEvidenceSchema, changeIdSchema, changeInitialState, changeLevelSchema, changeSchema, changeStateSchema, changeTransitions, createMultiRepositoryChangeTasks, createRecordChangeTool, createRecordVerificationTool, ensureChangeVerificationTasks, formatChangeVerificationBrief, reconcileMultiRepositoryChangeTasks };
+
+//# sourceMappingURL=changes.mjs.map

package/dist/changes.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"changes.mjs","names":[],"sources":["../src/changes.ts"],"sourcesContent":["import type { Change } from \"./schema/change\";\nimport type { RepositoryId } from \"./schema/id\";\nimport type { FactoryStores } from \"./store/engine\";\n\nexport { type ChangePresenter, type PresentChangeInput } from \"./changes/presentation\";\nexport {\n  createRecordChangeTool,\n  type RecordChangeInput,\n  type RecordChangeResult,\n  type RecordChangeTool,\n  type RecordChangeToolStores,\n  type RecordChangeToolOptions,\n} from \"./changes/eve-record-change\";\nexport { formatChangeVerificationBrief } from \"./change-verification/brief\";\nexport {\n  ensureChangeVerificationTasks,\n  type ChangeVerificationStores,\n  type EnsureChangeVerificationTasksOptions,\n  type EnsureChangeVerificationTasksResult,\n} from \"./change-verification/dispatch\";\nexport {\n  createRecordVerificationTool,\n  type PresentVerificationResultInput,\n  type RecordVerificationInput,\n  type RecordVerificationRefusal,\n  type RecordVerificationResult,\n  type RecordVerificationSuccess,\n  type RecordVerificationTool,\n  type RecordVerificationToolStores,\n  type RecordVerificationToolOptions,\n} from \"./change-verification/eve-tool\";\nexport {\n  createMultiRepositoryChangeTasks,\n  reconcileMultiRepositoryChangeTasks,\n  type CreateMultiRepositoryChangeTasksInput,\n  type CreateMultiRepositoryChangeTasksStores,\n  type MultiRepositoryChangePlan,\n  type ReconcileMultiRepositoryChangeTasksResult,\n  type ReconcileMultiRepositoryChangeTasksStores,\n} from \"./multi-repository-changes/coordination\";\n\n/** Provider identity and author required to represent an existing pull request as a Change. */\nexport interface AdoptPullRequestInput {\n  repositoryId: RepositoryId;\n  prNumber: number;\n  prUrl: string;\n  author: string;\n}\n\n/** Create a conservative, unverified Change for a pull request not authored by Factory. */\nexport async function adoptPullRequest(\n  stores: Pick<FactoryStores, \"changes\">,\n  input: AdoptPullRequestInput,\n): Promise<Change> {\n  return stores.changes.create({\n    ...input,\n    risk: \"low\",\n    confidence: \"low\",\n    evidence: {\n      reproVerified: false,\n      testsAdded: 0,\n      checksGreen: false,\n      attackPassed: false,\n      scopeMatches: false,\n    },\n  });\n}\n\nexport {\n  changeEvidenceSchema,\n  changeSchema,\n  changeStateSchema,\n  changeLevelSchema,\n  type Change,\n  type ChangeEvidence,\n  type ChangeInState,\n  type ChangeState,\n  type ChangeLevel,\n} from \"./schema/change\";\nexport { changeIdSchema, type ChangeId } from \"./schema/id\";\nexport { changeInitialState, changeTransitions } from \"./schema/transitions\";\nexport {\n  ChangeAssociationError,\n  type ChangePatch,\n  type ChangeTransitionOptions,\n  type ChangeTransitionArguments,\n  type CreateChangeInput,\n} from \"./store/engine\";\n"],"mappings":";;;;;;;;;;;AAkDA,eAAsB,iBACpB,QACA,OACiB;CACjB,OAAO,OAAO,QAAQ,OAAO;EAC3B,GAAG;EACH,MAAM;EACN,YAAY;EACZ,UAAU;GACR,eAAe;GACf,YAAY;GACZ,aAAa;GACb,cAAc;GACd,cAAc;EAChB;CACF,CAAC;AACH"}

package/dist/client-events.d.mts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+//#region src/client-events.d.ts
+/** Validates one newline-delimited event from a Factory execution stream. */
+declare const streamEventSchema: z.ZodObject<{
+  type: z.ZodString;
+  data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  meta: z.ZodOptional<z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    at: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+/** One validated event received from a Factory execution stream. */
+type StreamEvent = z.infer<typeof streamEventSchema>;
+/** Parses validated newline-delimited events from a response body. */
+declare function readEvents(body: ReadableStream<Uint8Array>): AsyncGenerator<StreamEvent>;
+//#endregion
+export { StreamEvent, readEvents, streamEventSchema };
+//# sourceMappingURL=client-events.d.mts.map

package/dist/client-events.mjs

@@ -0,0 +1,41 @@
+import { z } from "zod";
+//#region src/client-events.ts
+/** Validates one newline-delimited event from a Factory execution stream. */
+const streamEventSchema = z.object({
+	type: z.string(),
+	data: z.record(z.string(), z.unknown()),
+	meta: z.object({
+		id: z.string().optional(),
+		at: z.string().optional()
+	}).optional()
+});
+/** Parses validated newline-delimited events from a response body. */
+async function* readEvents(body) {
+	const reader = body.getReader();
+	const decoder = new TextDecoder();
+	let pending = "";
+	try {
+		for (;;) {
+			const { done, value } = await reader.read();
+			pending += done ? decoder.decode() : decoder.decode(value, { stream: true });
+			let newline;
+			while ((newline = pending.indexOf("\n")) >= 0) {
+				const line = pending.slice(0, newline).trim();
+				pending = pending.slice(newline + 1);
+				if (line) yield streamEventSchema.parse(JSON.parse(line));
+			}
+			if (pending.length > 2e6) throw new Error("Stream event exceeds the 2 MB limit");
+			if (done) {
+				if (pending.trim()) yield streamEventSchema.parse(JSON.parse(pending));
+				return;
+			}
+		}
+	} finally {
+		await reader.cancel().catch(() => {});
+		reader.releaseLock();
+	}
+}
+//#endregion
+export { readEvents, streamEventSchema };
+
+//# sourceMappingURL=client-events.mjs.map

package/dist/client-events.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-events.mjs","names":[],"sources":["../src/client-events.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/** Validates one newline-delimited event from a Factory execution stream. */\nexport const streamEventSchema = z.object({\n  type: z.string(),\n  data: z.record(z.string(), z.unknown()),\n  meta: z.object({ id: z.string().optional(), at: z.string().optional() }).optional(),\n});\n/** One validated event received from a Factory execution stream. */\nexport type StreamEvent = z.infer<typeof streamEventSchema>;\n\n/** Parses validated newline-delimited events from a response body. */\nexport async function* readEvents(body: ReadableStream<Uint8Array>): AsyncGenerator<StreamEvent> {\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n  let pending = \"\";\n  try {\n    for (;;) {\n      const { done, value } = await reader.read();\n      pending += done ? decoder.decode() : decoder.decode(value, { stream: true });\n      let newline: number;\n      while ((newline = pending.indexOf(\"\\n\")) >= 0) {\n        const line = pending.slice(0, newline).trim();\n        pending = pending.slice(newline + 1);\n        if (line) yield streamEventSchema.parse(JSON.parse(line));\n      }\n      if (pending.length > 2_000_000) throw new Error(\"Stream event exceeds the 2 MB limit\");\n      if (done) {\n        if (pending.trim()) yield streamEventSchema.parse(JSON.parse(pending));\n        return;\n      }\n    }\n  } finally {\n    await reader.cancel().catch(() => {});\n    reader.releaseLock();\n  }\n}\n"],"mappings":";;;AAGA,MAAa,oBAAoB,EAAE,OAAO;CACxC,MAAM,EAAE,OAAO;CACf,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC;CACtC,MAAM,EAAE,OAAO;EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,SAAS;EAAG,IAAI,EAAE,OAAO,CAAC,CAAC,SAAS;CAAE,CAAC,CAAC,CAAC,SAAS;AACpF,CAAC;;AAKD,gBAAuB,WAAW,MAA+D;CAC/F,MAAM,SAAS,KAAK,UAAU;CAC9B,MAAM,UAAU,IAAI,YAAY;CAChC,IAAI,UAAU;CACd,IAAI;EACF,SAAS;GACP,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,KAAK;GAC1C,WAAW,OAAO,QAAQ,OAAO,IAAI,QAAQ,OAAO,OAAO,EAAE,QAAQ,KAAK,CAAC;GAC3E,IAAI;GACJ,QAAQ,UAAU,QAAQ,QAAQ,IAAI,MAAM,GAAG;IAC7C,MAAM,OAAO,QAAQ,MAAM,GAAG,OAAO,CAAC,CAAC,KAAK;IAC5C,UAAU,QAAQ,MAAM,UAAU,CAAC;IACnC,IAAI,MAAM,MAAM,kBAAkB,MAAM,KAAK,MAAM,IAAI,CAAC;GAC1D;GACA,IAAI,QAAQ,SAAS,KAAW,MAAM,IAAI,MAAM,qCAAqC;GACrF,IAAI,MAAM;IACR,IAAI,QAAQ,KAAK,GAAG,MAAM,kBAAkB,MAAM,KAAK,MAAM,OAAO,CAAC;IACrE;GACF;EACF;CACF,UAAU;EACR,MAAM,OAAO,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC;EACpC,OAAO,YAAY;CACrB;AACF"}

package/dist/client-stream.d.mts

@@ -0,0 +1,28 @@
+import { TaskId } from "./schema/id.mjs";
+import { AgentSessionId } from "./schema/session.mjs";
+import { Transcript } from "./client-transcript.mjs";
+import { FactoryClient } from "./client.mjs";
+import { SessionView } from "./api-contracts.mjs";
+//#region src/client-stream.d.ts
+/** Client operations required to hydrate and follow a Factory session stream. */
+type SessionStreamClient = Pick<FactoryClient, "getSessionTranscriptResponse" | "getSessionEventStreamResponse">;
+/** Callbacks and exact execution identity used while following a session stream. */
+interface FollowSessionStreamOptions {
+  readonly sessionId: AgentSessionId;
+  readonly executionId: string | null;
+  readonly taskId?: TaskId;
+  readonly history?: readonly NonNullable<SessionView["history"]>[number][];
+  readonly transcript: Transcript;
+  readonly signal: AbortSignal;
+  readonly pollIntervalMs?: number;
+  readonly onHydrated: () => void;
+  readonly onChange: () => void;
+  readonly onConnection: (state: "connected" | "reconnecting") => void;
+  readonly onError: (error: unknown) => void;
+  readonly onConflict: () => Promise<void>;
+}
+/** Hydrates a transcript and follows its current execution until completion or disconnection. */
+declare function followSessionStream(client: SessionStreamClient, options: FollowSessionStreamOptions): Promise<void>;
+//#endregion
+export { FollowSessionStreamOptions, SessionStreamClient, followSessionStream };
+//# sourceMappingURL=client-stream.d.mts.map