@vercel/factory 0.0.16 → 0.0.18

package/dist/store/transcripts.mjs

@@ -0,0 +1,308 @@
+import { executionReferenceSchema } from "../schema/task.mjs";
+import { RecordExistsError, VersionConflictError } from "./driver.mjs";
+import { transcriptBlockSchema, transcriptSnapshotSchema } from "../schema/transcript.mjs";
+import { projectIndexedRecord } from "./indexed-projections.mjs";
+import { createHash, randomUUID } from "node:crypto";
+import { z } from "zod";
+//#region src/store/transcripts.ts
+const partBytes = 49152;
+const previewBytes = 4096;
+const headSchema = z.strictObject({
+	schemaVersion: z.literal(1),
+	execution: executionReferenceSchema,
+	snapshot: transcriptSnapshotSchema,
+	blockCount: z.number().int().nonnegative(),
+	updatedAt: z.iso.datetime()
+});
+const blockSchema = z.strictObject({
+	executionId: z.string(),
+	blockId: z.string(),
+	digest: z.string().regex(/^[a-f0-9]{64}$/u),
+	ordinal: z.number().int().nonnegative(),
+	parts: z.number().int().positive(),
+	bytes: z.number().int().positive(),
+	preview: transcriptBlockSchema
+});
+const chunkSchema = z.strictObject({ data: z.string() });
+function jsonValue(value) {
+	return JSON.parse(JSON.stringify(value));
+}
+const transcriptPageQuerySchema = z.strictObject({
+	limit: z.number().int().min(1).max(100),
+	cursor: z.string().max(8192).optional()
+});
+function digest(value) {
+	return createHash("sha256").update(value).digest("hex");
+}
+function executionId(execution) {
+	executionReferenceSchema.parse(execution);
+	return `transcript_${digest(JSON.stringify([execution.provider, execution.sessionId])).slice(0, 32)}`;
+}
+function blockKey(id, blockId) {
+	return `block_${digest(JSON.stringify([id, blockId]))}`;
+}
+function chunkKey(id, hash, part) {
+	return `chunk_${digest(JSON.stringify([
+		id,
+		hash,
+		part
+	]))}`;
+}
+function blockIndex(id) {
+	return `transcript-blocks:${id}`;
+}
+function transcriptBlockPreview(block) {
+	const bytes = Buffer.byteLength(JSON.stringify(block));
+	if (bytes <= previewBytes) return block;
+	const clipped = (text, length) => Array.from(text.replace(/[\uD800-\uDFFF]/gu, "�")).slice(0, length).join("");
+	const base = {
+		id: block.id,
+		title: clipped(block.title, 120),
+		text: clipped(block.text, 240),
+		createdAt: block.createdAt,
+		contentRef: {
+			blockId: block.id,
+			bytes
+		}
+	};
+	return transcriptBlockSchema.parse(block.kind === "tool" ? {
+		...base,
+		kind: "tool",
+		tool: {
+			callId: block.tool.callId,
+			name: block.tool.name,
+			inputText: clipped(block.tool.inputText, 240),
+			state: block.tool.state
+		}
+	} : {
+		...base,
+		kind: block.kind,
+		...block.kind === "user" ? { attachments: block.attachments } : {}
+	});
+}
+function pageTranscriptSnapshot(execution, snapshot, input) {
+	const query = transcriptPageQuerySchema.parse(input);
+	const id = executionId(execution);
+	const before = query.cursor === void 0 ? snapshot.blocks.length : z.strictObject({
+		id: z.literal(id),
+		before: z.number().int().nonnegative()
+	}).parse(JSON.parse(Buffer.from(query.cursor, "base64url").toString("utf8"))).before;
+	const start = Math.max(0, before - query.limit);
+	return {
+		snapshot: {
+			...snapshot,
+			blocks: snapshot.blocks.slice(start, before).map(transcriptBlockPreview)
+		},
+		nextCursor: start > 0 ? Buffer.from(JSON.stringify({
+			id,
+			before: start
+		})).toString("base64url") : null,
+		totalBlocks: snapshot.blocks.length
+	};
+}
+function createIndexedTranscriptStore(store, now) {
+	async function head(transaction, execution) {
+		const record = await transaction.get("transcripts", executionId(execution));
+		if (record === null) return null;
+		const value = headSchema.parse(record.value);
+		if (value.execution.provider !== execution.provider || value.execution.sessionId !== execution.sessionId) throw new Error("Transcript execution key does not match its stored value");
+		return {
+			value,
+			version: record.version
+		};
+	}
+	async function readBlock(transaction, id, block) {
+		if (block.executionId !== id) throw new Error("Transcript block execution mismatch");
+		const chunks = [];
+		for (let part = 0; part < block.parts; part++) {
+			const record = await transaction.get("transcriptChunks", chunkKey(id, block.digest, part));
+			if (record === null) throw new Error("Committed transcript content is missing");
+			chunks.push(Buffer.from(chunkSchema.parse(record.value).data, "base64"));
+		}
+		const encoded = Buffer.concat(chunks);
+		if (encoded.byteLength !== block.bytes || digest(encoded) !== block.digest) throw new Error("Transcript content checksum mismatch");
+		const value = transcriptBlockSchema.parse(JSON.parse(encoded.toString("utf8")));
+		if (value.id !== block.blockId || value.contentRef !== void 0) throw new Error("Transcript block identity mismatch");
+		return value;
+	}
+	async function readSnapshot(transaction, execution) {
+		const record = await head(transaction, execution);
+		if (record === null) return null;
+		const id = executionId(execution);
+		const blocks = [];
+		let cursor;
+		do {
+			const page = await transaction.query({
+				index: blockIndex(id),
+				limit: 100,
+				order: "asc",
+				cursor
+			});
+			for (const entry of page.entries) blocks.push(await readBlock(transaction, id, blockSchema.parse(entry.summary)));
+			cursor = page.nextCursor ?? void 0;
+		} while (cursor !== void 0);
+		if (blocks.length !== record.value.blockCount) throw new Error("Transcript block count mismatch");
+		return {
+			...record.value.snapshot,
+			blocks
+		};
+	}
+	return {
+		get(execution) {
+			return store.transaction((transaction) => readSnapshot(transaction, execution));
+		},
+		async head(execution) {
+			const record = await head(store, execution);
+			return record === null ? null : {
+				...record.value.snapshot,
+				blockCount: record.value.blockCount
+			};
+		},
+		async page(execution, input) {
+			const query = transcriptPageQuerySchema.parse(input);
+			return store.transaction(async (transaction) => {
+				const record = await head(transaction, execution);
+				if (record === null) return null;
+				const id = executionId(execution);
+				const page = await transaction.query({
+					index: blockIndex(id),
+					...query,
+					order: "desc"
+				});
+				const blocks = page.entries.map((entry) => {
+					const block = blockSchema.parse(entry.summary);
+					if (block.executionId !== id) throw new Error("Transcript page execution mismatch");
+					return block.preview;
+				}).reverse();
+				return {
+					snapshot: {
+						...record.value.snapshot,
+						blocks
+					},
+					nextCursor: page.nextCursor,
+					totalBlocks: record.value.blockCount
+				};
+			});
+		},
+		block(execution, blockId) {
+			return store.transaction(async (transaction) => {
+				const id = executionId(execution);
+				if (await head(transaction, execution) === null) return null;
+				const record = await transaction.get("transcriptBlocks", blockKey(id, blockId));
+				if (record === null) return null;
+				const block = blockSchema.parse(record.value);
+				if (block.blockId !== blockId) throw new Error("Transcript block key mismatch");
+				return readBlock(transaction, id, block);
+			});
+		},
+		async put(execution, input) {
+			const snapshot = transcriptSnapshotSchema.parse(input);
+			const id = executionId(execution);
+			const seen = /* @__PURE__ */ new Set();
+			const encoded = snapshot.blocks.map((block, ordinal) => {
+				if (block.contentRef !== void 0) throw new Error("Cannot persist a transcript preview as full content");
+				if (seen.has(block.id)) throw new Error("Duplicate transcript block identity");
+				seen.add(block.id);
+				const bytes = Buffer.from(JSON.stringify(block));
+				return {
+					key: blockKey(id, block.id),
+					bytes,
+					header: blockSchema.parse(jsonValue({
+						executionId: id,
+						blockId: block.id,
+						digest: digest(bytes),
+						ordinal,
+						parts: Math.ceil(bytes.length / partBytes),
+						bytes: bytes.length,
+						preview: transcriptBlockPreview(block)
+					}))
+				};
+			});
+			for (let attempt = 0;; attempt++) try {
+				return await store.transaction(async (transaction) => {
+					const previous = await head(transaction, execution);
+					if (previous !== null && previous.value.snapshot.cursor >= snapshot.cursor) return await readSnapshot(transaction, execution);
+					const old = /* @__PURE__ */ new Map();
+					let cursor;
+					do {
+						const page = await transaction.query({
+							index: blockIndex(id),
+							limit: 100,
+							cursor
+						});
+						for (const entry of page.entries) old.set(entry.id, {
+							value: blockSchema.parse(entry.summary),
+							version: entry.version
+						});
+						cursor = page.nextCursor ?? void 0;
+					} while (cursor !== void 0);
+					for (const block of encoded) {
+						const current = old.get(block.key);
+						old.delete(block.key);
+						if (current?.value.digest === block.header.digest && current.value.ordinal === block.header.ordinal) continue;
+						if (current?.value.digest !== block.header.digest) for (let part = 0; part < block.header.parts; part++) {
+							const key = chunkKey(id, block.header.digest, part);
+							if (await transaction.get("transcriptChunks", key) === null) await transaction.write({
+								collection: "transcriptChunks",
+								id: key,
+								expectedVersion: 0,
+								operationId: randomUUID(),
+								value: { data: block.bytes.subarray(part * partBytes, (part + 1) * partBytes).toString("base64") },
+								indexes: []
+							});
+						}
+						const inactive = current === void 0 ? await transaction.get("transcriptBlocks", block.key) : null;
+						await transaction.write({
+							collection: "transcriptBlocks",
+							id: block.key,
+							expectedVersion: current?.version ?? inactive?.version ?? 0,
+							operationId: randomUUID(),
+							value: block.header,
+							indexes: [{
+								index: blockIndex(id),
+								sortKey: String(block.header.ordinal).padStart(16, "0"),
+								summary: block.header
+							}]
+						});
+					}
+					for (const [key, previous] of old) await transaction.write({
+						collection: "transcriptBlocks",
+						id: key,
+						expectedVersion: previous.version,
+						operationId: randomUUID(),
+						value: previous.value,
+						indexes: []
+					});
+					const value = headSchema.parse(jsonValue({
+						schemaVersion: 1,
+						execution,
+						snapshot: {
+							...snapshot,
+							blocks: []
+						},
+						blockCount: snapshot.blocks.length,
+						updatedAt: now()
+					}));
+					await transaction.write({
+						collection: "transcripts",
+						id,
+						expectedVersion: previous?.version ?? 0,
+						operationId: randomUUID(),
+						value,
+						indexes: projectIndexedRecord("transcripts", id, value).map((entry) => ({
+							...entry,
+							summary: jsonValue(entry.summary)
+						}))
+					});
+					return snapshot;
+				});
+			} catch (error) {
+				if (attempt >= 4 || !(error instanceof VersionConflictError || error instanceof RecordExistsError)) throw error;
+			}
+		}
+	};
+}
+//#endregion
+export { createIndexedTranscriptStore, pageTranscriptSnapshot };
+
+//# sourceMappingURL=transcripts.mjs.map

package/dist/store/transcripts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcripts.mjs","names":[],"sources":["../../src/store/transcripts.ts"],"sourcesContent":["import { createHash, randomUUID } from \"node:crypto\";\nimport { z } from \"zod\";\nimport {\n  transcriptBlockSchema,\n  transcriptSnapshotSchema,\n  type TranscriptBlock,\n  type TranscriptPageQuery,\n  type TranscriptSnapshot,\n} from \"../schema/transcript\";\nimport { executionReferenceSchema, type ExecutionReference } from \"../schema/task\";\nimport { RecordExistsError, VersionConflictError } from \"./driver\";\nimport type { FactoryStores } from \"./engine\";\nimport type { IndexedStore } from \"./indexed\";\nimport { projectIndexedRecord } from \"./indexed-projections\";\n\nconst partBytes = 48 * 1024;\nconst previewBytes = 4 * 1024;\nconst headSchema = z.strictObject({\n  schemaVersion: z.literal(1),\n  execution: executionReferenceSchema,\n  snapshot: transcriptSnapshotSchema,\n  blockCount: z.number().int().nonnegative(),\n  updatedAt: z.iso.datetime(),\n});\nconst blockSchema = z.strictObject({\n  executionId: z.string(),\n  blockId: z.string(),\n  digest: z.string().regex(/^[a-f0-9]{64}$/u),\n  ordinal: z.number().int().nonnegative(),\n  parts: z.number().int().positive(),\n  bytes: z.number().int().positive(),\n  preview: transcriptBlockSchema,\n});\nconst chunkSchema = z.strictObject({ data: z.string() });\nfunction jsonValue(value: unknown): unknown {\n  return JSON.parse(JSON.stringify(value)) as unknown;\n}\nconst transcriptPageQuerySchema = z.strictObject({\n  limit: z.number().int().min(1).max(100),\n  cursor: z.string().max(8192).optional(),\n});\n\nfunction digest(value: string | Buffer): string {\n  return createHash(\"sha256\").update(value).digest(\"hex\");\n}\n\nfunction executionId(execution: ExecutionReference): string {\n  executionReferenceSchema.parse(execution);\n  return `transcript_${digest(JSON.stringify([execution.provider, execution.sessionId])).slice(0, 32)}`;\n}\n\nfunction blockKey(id: string, blockId: string): string {\n  return `block_${digest(JSON.stringify([id, blockId]))}`;\n}\n\nfunction chunkKey(id: string, hash: string, part: number): string {\n  return `chunk_${digest(JSON.stringify([id, hash, part]))}`;\n}\n\nfunction blockIndex(id: string): string {\n  return `transcript-blocks:${id}`;\n}\n\nfunction transcriptBlockPreview(block: TranscriptBlock): TranscriptBlock {\n  const bytes = Buffer.byteLength(JSON.stringify(block));\n  if (bytes <= previewBytes) return block;\n  const clipped = (text: string, length: number) =>\n    Array.from(text.replace(/[\\uD800-\\uDFFF]/gu, \"�\"))\n      .slice(0, length)\n      .join(\"\");\n  const base = {\n    id: block.id,\n    title: clipped(block.title, 120),\n    text: clipped(block.text, 240),\n    createdAt: block.createdAt,\n    contentRef: { blockId: block.id, bytes },\n  };\n  return transcriptBlockSchema.parse(\n    block.kind === \"tool\"\n      ? {\n          ...base,\n          kind: \"tool\",\n          tool: {\n            callId: block.tool.callId,\n            name: block.tool.name,\n            inputText: clipped(block.tool.inputText, 240),\n            state: block.tool.state,\n          },\n        }\n      : {\n          ...base,\n          kind: block.kind,\n          ...(block.kind === \"user\" ? { attachments: block.attachments } : {}),\n        },\n  );\n}\n\nexport function pageTranscriptSnapshot(\n  execution: ExecutionReference,\n  snapshot: TranscriptSnapshot,\n  input: TranscriptPageQuery,\n) {\n  const query = transcriptPageQuerySchema.parse(input);\n  const id = executionId(execution);\n  const before =\n    query.cursor === undefined\n      ? snapshot.blocks.length\n      : z\n          .strictObject({\n            id: z.literal(id),\n            before: z.number().int().nonnegative(),\n          })\n          .parse(JSON.parse(Buffer.from(query.cursor, \"base64url\").toString(\"utf8\"))).before;\n  const start = Math.max(0, before - query.limit);\n  return {\n    snapshot: {\n      ...snapshot,\n      blocks: snapshot.blocks.slice(start, before).map(transcriptBlockPreview),\n    },\n    nextCursor:\n      start > 0 ? Buffer.from(JSON.stringify({ id, before: start })).toString(\"base64url\") : null,\n    totalBlocks: snapshot.blocks.length,\n  };\n}\n\nexport function createIndexedTranscriptStore(\n  store: IndexedStore,\n  now: () => string,\n): FactoryStores[\"transcripts\"] {\n  async function head(transaction: IndexedStore, execution: ExecutionReference) {\n    const record = await transaction.get(\"transcripts\", executionId(execution));\n    if (record === null) return null;\n    const value = headSchema.parse(record.value);\n    if (\n      value.execution.provider !== execution.provider ||\n      value.execution.sessionId !== execution.sessionId\n    )\n      throw new Error(\"Transcript execution key does not match its stored value\");\n    return { value, version: record.version };\n  }\n\n  async function readBlock(\n    transaction: IndexedStore,\n    id: string,\n    block: z.infer<typeof blockSchema>,\n  ) {\n    if (block.executionId !== id) throw new Error(\"Transcript block execution mismatch\");\n    const chunks: Buffer[] = [];\n    for (let part = 0; part < block.parts; part++) {\n      const record = await transaction.get(\"transcriptChunks\", chunkKey(id, block.digest, part));\n      if (record === null) throw new Error(\"Committed transcript content is missing\");\n      chunks.push(Buffer.from(chunkSchema.parse(record.value).data, \"base64\"));\n    }\n    const encoded = Buffer.concat(chunks);\n    if (encoded.byteLength !== block.bytes || digest(encoded) !== block.digest)\n      throw new Error(\"Transcript content checksum mismatch\");\n    const value = transcriptBlockSchema.parse(JSON.parse(encoded.toString(\"utf8\")));\n    if (value.id !== block.blockId || value.contentRef !== undefined)\n      throw new Error(\"Transcript block identity mismatch\");\n    return value;\n  }\n\n  async function readSnapshot(\n    transaction: IndexedStore,\n    execution: ExecutionReference,\n  ): Promise<TranscriptSnapshot | null> {\n    const record = await head(transaction, execution);\n    if (record === null) return null;\n    const id = executionId(execution);\n    const blocks: TranscriptBlock[] = [];\n    let cursor: string | undefined;\n    do {\n      const page = await transaction.query({\n        index: blockIndex(id),\n        limit: 100,\n        order: \"asc\",\n        cursor,\n      });\n      for (const entry of page.entries)\n        blocks.push(await readBlock(transaction, id, blockSchema.parse(entry.summary)));\n      cursor = page.nextCursor ?? undefined;\n    } while (cursor !== undefined);\n    if (blocks.length !== record.value.blockCount)\n      throw new Error(\"Transcript block count mismatch\");\n    return { ...record.value.snapshot, blocks };\n  }\n\n  return {\n    get(execution) {\n      return store.transaction((transaction) => readSnapshot(transaction, execution));\n    },\n    async head(execution) {\n      const record = await head(store, execution);\n      return record === null\n        ? null\n        : { ...record.value.snapshot, blockCount: record.value.blockCount };\n    },\n    async page(execution, input) {\n      const query = transcriptPageQuerySchema.parse(input);\n      return store.transaction(async (transaction) => {\n        const record = await head(transaction, execution);\n        if (record === null) return null;\n        const id = executionId(execution);\n        const page = await transaction.query({ index: blockIndex(id), ...query, order: \"desc\" });\n        const blocks = page.entries\n          .map((entry) => {\n            const block = blockSchema.parse(entry.summary);\n            if (block.executionId !== id) throw new Error(\"Transcript page execution mismatch\");\n            return block.preview;\n          })\n          .reverse();\n        return {\n          snapshot: { ...record.value.snapshot, blocks },\n          nextCursor: page.nextCursor,\n          totalBlocks: record.value.blockCount,\n        };\n      });\n    },\n    block(execution, blockId) {\n      return store.transaction(async (transaction) => {\n        const id = executionId(execution);\n        if ((await head(transaction, execution)) === null) return null;\n        const record = await transaction.get(\"transcriptBlocks\", blockKey(id, blockId));\n        if (record === null) return null;\n        const block = blockSchema.parse(record.value);\n        if (block.blockId !== blockId) throw new Error(\"Transcript block key mismatch\");\n        return readBlock(transaction, id, block);\n      });\n    },\n    async put(execution, input) {\n      const snapshot = transcriptSnapshotSchema.parse(input);\n      const id = executionId(execution);\n      const seen = new Set<string>();\n      const encoded = snapshot.blocks.map((block, ordinal) => {\n        if (block.contentRef !== undefined)\n          throw new Error(\"Cannot persist a transcript preview as full content\");\n        if (seen.has(block.id)) throw new Error(\"Duplicate transcript block identity\");\n        seen.add(block.id);\n        const bytes = Buffer.from(JSON.stringify(block));\n        return {\n          key: blockKey(id, block.id),\n          bytes,\n          header: blockSchema.parse(\n            jsonValue({\n              executionId: id,\n              blockId: block.id,\n              digest: digest(bytes),\n              ordinal,\n              parts: Math.ceil(bytes.length / partBytes),\n              bytes: bytes.length,\n              preview: transcriptBlockPreview(block),\n            }),\n          ),\n        };\n      });\n      for (let attempt = 0; ; attempt++) {\n        try {\n          return await store.transaction(async (transaction) => {\n            const previous = await head(transaction, execution);\n            if (previous !== null && previous.value.snapshot.cursor >= snapshot.cursor)\n              return (await readSnapshot(transaction, execution))!;\n            const old = new Map<string, { value: z.infer<typeof blockSchema>; version: number }>();\n            let cursor: string | undefined;\n            do {\n              const page = await transaction.query({ index: blockIndex(id), limit: 100, cursor });\n              for (const entry of page.entries)\n                old.set(entry.id, {\n                  value: blockSchema.parse(entry.summary),\n                  version: entry.version,\n                });\n              cursor = page.nextCursor ?? undefined;\n            } while (cursor !== undefined);\n            for (const block of encoded) {\n              const current = old.get(block.key);\n              old.delete(block.key);\n              if (\n                current?.value.digest === block.header.digest &&\n                current.value.ordinal === block.header.ordinal\n              )\n                continue;\n              if (current?.value.digest !== block.header.digest) {\n                for (let part = 0; part < block.header.parts; part++) {\n                  const key = chunkKey(id, block.header.digest, part);\n                  if ((await transaction.get(\"transcriptChunks\", key)) === null)\n                    await transaction.write({\n                      collection: \"transcriptChunks\",\n                      id: key,\n                      expectedVersion: 0,\n                      operationId: randomUUID(),\n                      value: {\n                        data: block.bytes\n                          .subarray(part * partBytes, (part + 1) * partBytes)\n                          .toString(\"base64\"),\n                      },\n                      indexes: [],\n                    });\n                }\n              }\n              const inactive =\n                current === undefined ? await transaction.get(\"transcriptBlocks\", block.key) : null;\n              await transaction.write({\n                collection: \"transcriptBlocks\",\n                id: block.key,\n                expectedVersion: current?.version ?? inactive?.version ?? 0,\n                operationId: randomUUID(),\n                value: block.header,\n                indexes: [\n                  {\n                    index: blockIndex(id),\n                    sortKey: String(block.header.ordinal).padStart(16, \"0\"),\n                    summary: block.header,\n                  },\n                ],\n              });\n            }\n            for (const [key, previous] of old)\n              await transaction.write({\n                collection: \"transcriptBlocks\",\n                id: key,\n                expectedVersion: previous.version,\n                operationId: randomUUID(),\n                value: previous.value,\n                indexes: [],\n              });\n            const value = headSchema.parse(\n              jsonValue({\n                schemaVersion: 1,\n                execution,\n                snapshot: { ...snapshot, blocks: [] },\n                blockCount: snapshot.blocks.length,\n                updatedAt: now(),\n              }),\n            );\n            await transaction.write({\n              collection: \"transcripts\",\n              id,\n              expectedVersion: previous?.version ?? 0,\n              operationId: randomUUID(),\n              value,\n              indexes: projectIndexedRecord(\"transcripts\", id, value).map((entry) => ({\n                ...entry,\n                summary: jsonValue(entry.summary),\n              })),\n            });\n            return snapshot;\n          });\n        } catch (error) {\n          if (\n            attempt >= 4 ||\n            !(error instanceof VersionConflictError || error instanceof RecordExistsError)\n          )\n            throw error;\n        }\n      }\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/sweep.d.mts

@@ -1,7 +1,7 @@
 import { TaskId } from "./schema/id.mjs";
-import { Repository } from "./schema/repository.mjs";
 import { ExecutionReference, Task } from "./schema/task.mjs";
 import { AgentRouteKey } from "./agent-routes.mjs";
+import { Repository } from "./schema/repository.mjs";
 import { FactoryStores } from "./store/engine.mjs";
 import { DispatchBudget, DispatchRefusalCode } from "./dispatch.mjs";
 //#region src/sweep.d.ts

package/dist/sweep.mjs

@@ -1,6 +1,8 @@
+import { collectFactoryRecords } from "./store/iterate.mjs";
+import { budgetTasks } from "./budget.mjs";
+import { VersionConflictError } from "./store/driver.mjs";
 import { InvalidTransitionError } from "./schema/transitions.mjs";
 import { routeKey } from "./agent-routes.mjs";
-import { VersionConflictError } from "./store/driver.mjs";
 import { DispatchRefusedError, dispatchTask } from "./dispatch.mjs";
 import { TaskAttemptConflictError } from "./store/engine.mjs";
 //#region src/sweep.ts
@@ -61,9 +63,12 @@ async function sweepQueued(stores, options) {
 	const maxDispatches = options.maxDispatches ?? Number.POSITIVE_INFINITY;
 	if (!(Number.isInteger(maxDispatches) || maxDispatches === Number.POSITIVE_INFINITY) || maxDispatches < 1) throw new Error("maxDispatches must be a positive integer");
 	let attempted = 0;
-	const taskSnapshot = options.tasks ?? await stores.tasks.list();
-	const budgetSnapshot = options.budget?.tasks ?? (options.budget && options.tasks ? await stores.tasks.list() : taskSnapshot);
-	const budgetTasks = new Map(budgetSnapshot.map((task) => [task.id, task]));
+	const taskSnapshot = options.tasks ?? await collectFactoryRecords(stores.tasks.list, {
+		limit: 100,
+		match: { state: "queued" }
+	});
+	const budgetSnapshot = options.budget?.tasks ?? (options.budget && options.budget.enforce !== false ? await budgetTasks(stores) : []);
+	const budgetTasks$1 = new Map(budgetSnapshot.map((task) => [task.id, task]));
 	const queued = taskSnapshot.filter((task) => task.state === "queued").sort((a, b) => b.attempt - a.attempt || a.createdAt.localeCompare(b.createdAt));
 	for (const task of queued) {
 		const route = task.work.route;
@@ -130,15 +135,15 @@ async function sweepQueued(stores, options) {
 				},
 				budget: options.budget === void 0 ? void 0 : {
 					...options.budget,
-					tasks: [...budgetTasks.values()]
+					tasks: [...budgetTasks$1.values()]
 				}
 			});
-			budgetTasks.set(dispatched.id, dispatched);
+			budgetTasks$1.set(dispatched.id, dispatched);
 			result.dispatched.push(task.id);
 		} catch (error) {
 			if (options.budget !== void 0) {
 				const current = await stores.tasks.get(task.id).catch(() => null);
-				if (current !== null) budgetTasks.set(current.id, current);
+				if (current !== null) budgetTasks$1.set(current.id, current);
 			}
 			if (error instanceof DispatchRefusedError) {
 				result.skipped.push({

package/dist/sweep.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"sweep.mjs","names":[],"sources":["../src/sweep.ts"],"sourcesContent":["import { routeKey, type AgentRouteKey } from \"./agent-routes\";\nimport { dispatchTask, DispatchRefusedError, type DispatchBudget } from \"./dispatch\";\nimport type { DispatchRefusalCode } from \"./dispatch\";\nimport type { TaskId } from \"./schema/id\";\nimport type { Repository } from \"./schema/repository\";\nimport type { ExecutionReference, Task } from \"./schema/task\";\nimport { InvalidTransitionError } from \"./schema/transitions\";\nimport { VersionConflictError } from \"./store/driver\";\nimport { TaskAttemptConflictError, type FactoryStores } from \"./store/engine\";\n\n/** Graph, receipt, repository, and Task capabilities required by queued-work dispatch. */\nexport type SweepQueuedStores = Pick<\n  FactoryStores,\n  \"graphs\" | \"receipts\" | \"repositories\" | \"tasks\"\n>;\n\n/**\n * Single-repository adapter for an exact agent route. Supplied by the app, which knows its\n * agents' addresses. Returns the provider's execution reference when it has one.\n *\n * @param task - Running Task already admitted by the dispatch gate.\n * @param repository - Exact enabled repository selected from the Task scope.\n * @returns Provider execution reference that dispatch can persist for recovery.\n */\nexport type TaskLauncher = (task: Task, repository: Repository) => Promise<ExecutionReference>;\n\n/** Exact-route launchers, budget gate, and pass bounds for queued Task dispatch. */\nexport interface SweepQueuedOptions {\n  /** Single-repository agent adapters keyed by routeKey(binding), e.g. code-change@1. */\n  launchers: Readonly<Partial<Record<AgentRouteKey, TaskLauncher>>>;\n  /** Reserve-before-execution limits, passed through to every dispatch. */\n  budget?: DispatchBudget;\n  /** Maximum task launches attempted in one pass; omitted means no limit. */\n  maxDispatches?: number;\n  /** A dispatcher-wide snapshot avoids another complete task read. */\n  tasks?: readonly Task[];\n}\n\n/** Tasks dispatched, deferred by a gate, or failed by one queued-work pass. */\nexport interface SweepQueuedResult {\n  /** Task IDs whose provider execution reference was durably recorded. */\n  readonly dispatched: readonly TaskId[];\n  /** Tasks left in the queue because a declared gate may become eligible later. */\n  readonly skipped: readonly {\n    readonly taskId: TaskId;\n    readonly reasonCode: SweepSkipReasonCode;\n    readonly reason: string;\n  }[];\n  /** Tasks whose routing is invalid or whose launch threw. */\n  readonly failed: readonly {\n    readonly taskId: TaskId;\n    readonly reasonCode: SweepFailureReasonCode;\n    readonly reason: string;\n  }[];\n}\n\n/** Stable reason a queued Task remained eligible for a later dispatch pass. */\nexport type SweepSkipReasonCode =\n  | DispatchRefusalCode\n  | \"workflow_owned\"\n  | \"awaiting_approval\"\n  | \"dispatch_limit\"\n  | \"task_changed\";\n\n/** Stable reason a queued Task could not be routed or launched. */\nexport type SweepFailureReasonCode =\n  | \"invalid_repository_scope\"\n  | \"repository_not_found\"\n  | \"launcher_not_registered\"\n  | \"launch_failed\";\n\ntype MutableSweepQueuedResult = {\n  dispatched: TaskId[];\n  skipped: { taskId: TaskId; reasonCode: SweepSkipReasonCode; reason: string }[];\n  failed: { taskId: TaskId; reasonCode: SweepFailureReasonCode; reason: string }[];\n};\n\nasync function failUnrouteable(\n  stores: SweepQueuedStores,\n  task: Task,\n  reasonCode: SweepFailureReasonCode,\n  reason: string,\n  result: MutableSweepQueuedResult,\n): Promise<void> {\n  try {\n    await stores.tasks.transition(task.id, \"failed\", { reason, expectFrom: \"queued\" });\n    result.failed.push({ taskId: task.id, reasonCode, reason });\n  } catch (error) {\n    if (error instanceof InvalidTransitionError || error instanceof VersionConflictError) {\n      result.skipped.push({\n        taskId: task.id,\n        reasonCode: \"task_changed\",\n        reason: \"task changed during routing\",\n      });\n      return;\n    }\n    throw error;\n  }\n}\n\n/**\n * Runs one bounded pass over queued Tasks and dispatches each eligible exact route.\n *\n * @remarks\n * Candidates are ordered by newest attempt first and then creation time. Route-less work remains\n * queued for its workflow owner; unmet dependencies, approvals, and pass limits appear in\n * `skipped`. Invalid repository scope, missing repositories or launchers, and launch failures\n * appear in `failed`, with unrouteable Tasks transitioned to `failed` when this sweep wins the\n * race. A result entry describes this pass rather than guaranteeing the Task's lifecycle state:\n * an ambiguously accepted launch is reported as `launch_failed` while its Task intentionally stays\n * running for recovery. Callers should surface every failure, reread those Tasks before deciding\n * remediation, and schedule another pass for skipped work.\n *\n * Overlapping passes are safe: {@link dispatchTask} atomically admits one winner before invoking a\n * launcher. A supplied `tasks` snapshot bounds reads and candidate selection for this pass; it can\n * become stale, and corresponding races are returned as `task_changed` rather than hidden.\n * `maxDispatches` counts provider launches started during the pass, including launches that later\n * fail, so `dispatched.length` may be smaller than the limit.\n *\n * @param stores - Graph, receipt, repository, and Task stores used during the pass.\n * @param options - Exact-route launchers plus optional budget, Task snapshot, and dispatch limit.\n * @returns IDs dispatched and structured skipped/failed outcomes for every considered candidate.\n * @throws When `maxDispatches` is not a positive integer or an unexpected persistence error occurs.\n * @see The shipped `docs/recipes/retry-recovery.md` recipe for scheduled recovery.\n */\nexport async function sweepQueued(\n  stores: SweepQueuedStores,\n  options: SweepQueuedOptions,\n): Promise<SweepQueuedResult> {\n  const result: MutableSweepQueuedResult = { dispatched: [], skipped: [], failed: [] };\n  const maxDispatches = options.maxDispatches ?? Number.POSITIVE_INFINITY;\n  if (\n    !(Number.isInteger(maxDispatches) || maxDispatches === Number.POSITIVE_INFINITY) ||\n    maxDispatches < 1\n  ) {\n    throw new Error(\"maxDispatches must be a positive integer\");\n  }\n  let attempted = 0;\n  const taskSnapshot = options.tasks ?? (await stores.tasks.list());\n  const budgetSnapshot =\n    options.budget?.tasks ??\n    (options.budget && options.tasks ? await stores.tasks.list() : taskSnapshot);\n  const budgetTasks = new Map(budgetSnapshot.map((task) => [task.id, task]));\n  const queued = taskSnapshot\n    .filter((task) => task.state === \"queued\")\n    .sort((a, b) => b.attempt - a.attempt || a.createdAt.localeCompare(b.createdAt));\n\n  for (const task of queued) {\n    const route = task.work.route;\n    if (route === undefined) {\n      result.skipped.push({\n        taskId: task.id,\n        reasonCode: \"workflow_owned\",\n        reason: \"no agent route; workflow owns execution\",\n      });\n      continue;\n    }\n    const [repositoryId] = task.repositoryIds;\n    if (task.repositoryIds.length !== 1 || repositoryId === undefined) {\n      await failUnrouteable(\n        stores,\n        task,\n        \"invalid_repository_scope\",\n        \"sweep launcher adapter requires exactly one repository\",\n        result,\n      );\n      continue;\n    }\n    if (task.approval === \"required\") {\n      result.skipped.push({\n        taskId: task.id,\n        reasonCode: \"awaiting_approval\",\n        reason: \"awaiting human approval\",\n      });\n      continue;\n    }\n    const key = routeKey(route);\n    const launcher = Object.hasOwn(options.launchers, key) ? options.launchers[key] : undefined;\n    if (launcher === undefined) {\n      await failUnrouteable(\n        stores,\n        task,\n        \"launcher_not_registered\",\n        `no registered launcher handles agent route ${key}`,\n        result,\n      );\n      continue;\n    }\n    if (\n      !(await stores.graphs.dependenciesSatisfied({\n        rootTaskId: task.rootTaskId,\n        taskId: task.id,\n      }))\n    ) {\n      result.skipped.push({\n        taskId: task.id,\n        reasonCode: \"dependencies_unsatisfied\",\n        reason: \"graph dependencies must all be succeeded before dispatch\",\n      });\n      continue;\n    }\n    if (attempted >= maxDispatches) {\n      result.skipped.push({\n        taskId: task.id,\n        reasonCode: \"dispatch_limit\",\n        reason: \"per-sweep dispatch limit reached\",\n      });\n      continue;\n    }\n    const repository = await stores.repositories.get(repositoryId);\n    if (repository === null) {\n      await failUnrouteable(stores, task, \"repository_not_found\", \"task has no repository\", result);\n      continue;\n    }\n    let launchStarted = false;\n    try {\n      const dispatched = await dispatchTask(stores, {\n        taskId: task.id,\n        route,\n        launch: (dispatched) => {\n          attempted += 1;\n          launchStarted = true;\n          return launcher(dispatched, repository);\n        },\n        budget:\n          options.budget === undefined\n            ? undefined\n            : { ...options.budget, tasks: [...budgetTasks.values()] },\n      });\n      budgetTasks.set(dispatched.id, dispatched);\n      result.dispatched.push(task.id);\n    } catch (error) {\n      if (options.budget !== undefined) {\n        const current = await stores.tasks.get(task.id).catch(() => null);\n        if (current !== null) budgetTasks.set(current.id, current);\n      }\n      if (error instanceof DispatchRefusedError) {\n        // Dependencies not ready, or another sweep won the race. Leave it.\n        result.skipped.push({ taskId: task.id, reasonCode: error.code, reason: error.reason });\n        continue;\n      }\n      if (\n        !launchStarted &&\n        (error instanceof InvalidTransitionError ||\n          error instanceof TaskAttemptConflictError ||\n          error instanceof VersionConflictError)\n      ) {\n        result.skipped.push({\n          taskId: task.id,\n          reasonCode: \"task_changed\",\n          reason: \"task changed before dispatch\",\n        });\n        continue;\n      }\n      result.failed.push({\n        taskId: task.id,\n        reasonCode: \"launch_failed\",\n        reason: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n  return result;\n}\n"],"mappings":"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"}
+{"version":3,"file":"sweep.mjs","names":["readBudgetTasks","budgetTasks"],"sources":["../src/sweep.ts"],"sourcesContent":["import { budgetTasks as readBudgetTasks } from \"./budget\";\nimport { collectFactoryRecords } from \"./store/iterate\";\nimport { routeKey, type AgentRouteKey } from \"./agent-routes\";\nimport { dispatchTask, DispatchRefusedError, type DispatchBudget } from \"./dispatch\";\nimport type { DispatchRefusalCode } from \"./dispatch\";\nimport type { TaskId } from \"./schema/id\";\nimport type { Repository } from \"./schema/repository\";\nimport type { ExecutionReference, Task } from \"./schema/task\";\nimport { InvalidTransitionError } from \"./schema/transitions\";\nimport { VersionConflictError } from \"./store/driver\";\nimport { TaskAttemptConflictError, type FactoryStores } from \"./store/engine\";\n\n/** Graph, receipt, repository, and Task capabilities required by queued-work dispatch. */\nexport type SweepQueuedStores = Pick<\n  FactoryStores,\n  \"graphs\" | \"receipts\" | \"repositories\" | \"tasks\"\n>;\n\n/**\n * Single-repository adapter for an exact agent route. Supplied by the app, which knows its\n * agents' addresses. Returns the provider's execution reference when it has one.\n *\n * @param task - Running Task already admitted by the dispatch gate.\n * @param repository - Exact enabled repository selected from the Task scope.\n * @returns Provider execution reference that dispatch can persist for recovery.\n */\nexport type TaskLauncher = (task: Task, repository: Repository) => Promise<ExecutionReference>;\n\n/** Exact-route launchers, budget gate, and pass bounds for queued Task dispatch. */\nexport interface SweepQueuedOptions {\n  /** Single-repository agent adapters keyed by routeKey(binding), e.g. code-change@1. */\n  launchers: Readonly<Partial<Record<AgentRouteKey, TaskLauncher>>>;\n  /** Reserve-before-execution limits, passed through to every dispatch. */\n  budget?: DispatchBudget;\n  /** Maximum task launches attempted in one pass; omitted means no limit. */\n  maxDispatches?: number;\n  /** A dispatcher-wide snapshot avoids another complete task read. */\n  tasks?: readonly Task[];\n}\n\n/** Tasks dispatched, deferred by a gate, or failed by one queued-work pass. */\nexport interface SweepQueuedResult {\n  /** Task IDs whose provider execution reference was durably recorded. */\n  readonly dispatched: readonly TaskId[];\n  /** Tasks left in the queue because a declared gate may become eligible later. */\n  readonly skipped: readonly {\n    readonly taskId: TaskId;\n    readonly reasonCode: SweepSkipReasonCode;\n    readonly reason: string;\n  }[];\n  /** Tasks whose routing is invalid or whose launch threw. */\n  readonly failed: readonly {\n    readonly taskId: TaskId;\n    readonly reasonCode: SweepFailureReasonCode;\n    readonly reason: string;\n  }[];\n}\n\n/** Stable reason a queued Task remained eligible for a later dispatch pass. */\nexport type SweepSkipReasonCode =\n  | DispatchRefusalCode\n  | \"workflow_owned\"\n  | \"awaiting_approval\"\n  | \"dispatch_limit\"\n  | \"task_changed\";\n\n/** Stable reason a queued Task could not be routed or launched. */\nexport type SweepFailureReasonCode =\n  | \"invalid_repository_scope\"\n  | \"repository_not_found\"\n  | \"launcher_not_registered\"\n  | \"launch_failed\";\n\ntype MutableSweepQueuedResult = {\n  dispatched: TaskId[];\n  skipped: { taskId: TaskId; reasonCode: SweepSkipReasonCode; reason: string }[];\n  failed: { taskId: TaskId; reasonCode: SweepFailureReasonCode; reason: string }[];\n};\n\nasync function failUnrouteable(\n  stores: SweepQueuedStores,\n  task: Task,\n  reasonCode: SweepFailureReasonCode,\n  reason: string,\n  result: MutableSweepQueuedResult,\n): Promise<void> {\n  try {\n    await stores.tasks.transition(task.id, \"failed\", { reason, expectFrom: \"queued\" });\n    result.failed.push({ taskId: task.id, reasonCode, reason });\n  } catch (error) {\n    if (error instanceof InvalidTransitionError || error instanceof VersionConflictError) {\n      result.skipped.push({\n        taskId: task.id,\n        reasonCode: \"task_changed\",\n        reason: \"task changed during routing\",\n      });\n      return;\n    }\n    throw error;\n  }\n}\n\n/**\n * Runs one bounded pass over queued Tasks and dispatches each eligible exact route.\n *\n * @remarks\n * Candidates are ordered by newest attempt first and then creation time. Route-less work remains\n * queued for its workflow owner; unmet dependencies, approvals, and pass limits appear in\n * `skipped`. Invalid repository scope, missing repositories or launchers, and launch failures\n * appear in `failed`, with unrouteable Tasks transitioned to `failed` when this sweep wins the\n * race. A result entry describes this pass rather than guaranteeing the Task's lifecycle state:\n * an ambiguously accepted launch is reported as `launch_failed` while its Task intentionally stays\n * running for recovery. Callers should surface every failure, reread those Tasks before deciding\n * remediation, and schedule another pass for skipped work.\n *\n * Overlapping passes are safe: {@link dispatchTask} atomically admits one winner before invoking a\n * launcher. A supplied `tasks` snapshot bounds reads and candidate selection for this pass; it can\n * become stale, and corresponding races are returned as `task_changed` rather than hidden.\n * `maxDispatches` counts provider launches started during the pass, including launches that later\n * fail, so `dispatched.length` may be smaller than the limit.\n *\n * @param stores - Graph, receipt, repository, and Task stores used during the pass.\n * @param options - Exact-route launchers plus optional budget, Task snapshot, and dispatch limit.\n * @returns IDs dispatched and structured skipped/failed outcomes for every considered candidate.\n * @throws When `maxDispatches` is not a positive integer or an unexpected persistence error occurs.\n * @see The shipped `docs/recipes/retry-recovery.md` recipe for scheduled recovery.\n */\nexport async function sweepQueued(\n  stores: SweepQueuedStores,\n  options: SweepQueuedOptions,\n): Promise<SweepQueuedResult> {\n  const result: MutableSweepQueuedResult = { dispatched: [], skipped: [], failed: [] };\n  const maxDispatches = options.maxDispatches ?? Number.POSITIVE_INFINITY;\n  if (\n    !(Number.isInteger(maxDispatches) || maxDispatches === Number.POSITIVE_INFINITY) ||\n    maxDispatches < 1\n  ) {\n    throw new Error(\"maxDispatches must be a positive integer\");\n  }\n  let attempted = 0;\n  const taskSnapshot =\n    options.tasks ??\n    (await collectFactoryRecords(stores.tasks.list, { limit: 100, match: { state: \"queued\" } }));\n  const budgetSnapshot =\n    options.budget?.tasks ??\n    (options.budget && options.budget.enforce !== false ? await readBudgetTasks(stores) : []);\n  const budgetTasks = new Map(budgetSnapshot.map((task) => [task.id, task]));\n  const queued = taskSnapshot\n    .filter((task) => task.state === \"queued\")\n    .sort((a, b) => b.attempt - a.attempt || a.createdAt.localeCompare(b.createdAt));\n\n  for (const task of queued) {\n    const route = task.work.route;\n    if (route === undefined) {\n      result.skipped.push({\n        taskId: task.id,\n        reasonCode: \"workflow_owned\",\n        reason: \"no agent route; workflow owns execution\",\n      });\n      continue;\n    }\n    const [repositoryId] = task.repositoryIds;\n    if (task.repositoryIds.length !== 1 || repositoryId === undefined) {\n      await failUnrouteable(\n        stores,\n        task,\n        \"invalid_repository_scope\",\n        \"sweep launcher adapter requires exactly one repository\",\n        result,\n      );\n      continue;\n    }\n    if (task.approval === \"required\") {\n      result.skipped.push({\n        taskId: task.id,\n        reasonCode: \"awaiting_approval\",\n        reason: \"awaiting human approval\",\n      });\n      continue;\n    }\n    const key = routeKey(route);\n    const launcher = Object.hasOwn(options.launchers, key) ? options.launchers[key] : undefined;\n    if (launcher === undefined) {\n      await failUnrouteable(\n        stores,\n        task,\n        \"launcher_not_registered\",\n        `no registered launcher handles agent route ${key}`,\n        result,\n      );\n      continue;\n    }\n    if (\n      !(await stores.graphs.dependenciesSatisfied({\n        rootTaskId: task.rootTaskId,\n        taskId: task.id,\n      }))\n    ) {\n      result.skipped.push({\n        taskId: task.id,\n        reasonCode: \"dependencies_unsatisfied\",\n        reason: \"graph dependencies must all be succeeded before dispatch\",\n      });\n      continue;\n    }\n    if (attempted >= maxDispatches) {\n      result.skipped.push({\n        taskId: task.id,\n        reasonCode: \"dispatch_limit\",\n        reason: \"per-sweep dispatch limit reached\",\n      });\n      continue;\n    }\n    const repository = await stores.repositories.get(repositoryId);\n    if (repository === null) {\n      await failUnrouteable(stores, task, \"repository_not_found\", \"task has no repository\", result);\n      continue;\n    }\n    let launchStarted = false;\n    try {\n      const dispatched = await dispatchTask(stores, {\n        taskId: task.id,\n        route,\n        launch: (dispatched) => {\n          attempted += 1;\n          launchStarted = true;\n          return launcher(dispatched, repository);\n        },\n        budget:\n          options.budget === undefined\n            ? undefined\n            : { ...options.budget, tasks: [...budgetTasks.values()] },\n      });\n      budgetTasks.set(dispatched.id, dispatched);\n      result.dispatched.push(task.id);\n    } catch (error) {\n      if (options.budget !== undefined) {\n        const current = await stores.tasks.get(task.id).catch(() => null);\n        if (current !== null) budgetTasks.set(current.id, current);\n      }\n      if (error instanceof DispatchRefusedError) {\n        // Dependencies not ready, or another sweep won the race. Leave it.\n        result.skipped.push({ taskId: task.id, reasonCode: error.code, reason: error.reason });\n        continue;\n      }\n      if (\n        !launchStarted &&\n        (error instanceof InvalidTransitionError ||\n          error instanceof TaskAttemptConflictError ||\n          error instanceof VersionConflictError)\n      ) {\n        result.skipped.push({\n          taskId: task.id,\n          reasonCode: \"task_changed\",\n          reason: \"task changed before dispatch\",\n        });\n        continue;\n      }\n      result.failed.push({\n        taskId: task.id,\n        reasonCode: \"launch_failed\",\n        reason: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n  return result;\n}\n"],"mappings":"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"}

package/dist/task-communication.mjs

@@ -1,3 +1,4 @@
+import { collectFactoryRecords } from "./store/iterate.mjs";
 //#region src/task-communication.ts
 /**
 * Build the generic durable receipt reconciler around an application's event
@@ -6,7 +7,20 @@
 */
 function createTaskCommunicationReconciler(projection) {
 	return async function reconcileTaskCommunications(stores, snapshot) {
-		const tasks = snapshot ?? await stores.tasks.list();
+		const tasks = snapshot ?? [...new Map((await Promise.all([collectFactoryRecords(stores.tasks.list, {
+			limit: 100,
+			match: { state: "needs_human" },
+			fields: [{
+				path: ["question"],
+				test: "exists"
+			}]
+		}), collectFactoryRecords(stores.tasks.list, {
+			limit: 100,
+			fields: [{
+				path: ["pendingCommunicationReceiptIds"],
+				test: "notEmpty"
+			}]
+		})])).flat().map((task) => [task.id, task])).values()];
 		let enqueued = 0;
 		for (const task of tasks) {
 			const presentsQuestion = task.question !== void 0;

package/dist/task-communication.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"task-communication.mjs","names":[],"sources":["../src/task-communication.ts"],"sourcesContent":["import type { CommunicationEvent } from \"./schema/communication\";\nimport type { MaybePromise } from \"./schema/common\";\nimport type { Receipt } from \"./schema/receipt\";\nimport type { Task } from \"./schema/task\";\nimport type { FactoryStores } from \"./store/engine\";\n\n/** Outbox, receipt, and Task capabilities required by communication reconciliation. */\nexport type TaskCommunicationStores = Pick<FactoryStores, \"outbox\" | \"receipts\" | \"tasks\">;\n\n/** Number of connector-neutral events newly enqueued during reconciliation. */\nexport interface TaskCommunicationResult {\n  enqueued: number;\n}\n\n/** Repairs pending Task communication projections against the durable outbox. */\nexport type TaskCommunicationReconciler<\n  Stores extends TaskCommunicationStores = TaskCommunicationStores,\n> = (stores: Stores, snapshot?: readonly Task[]) => Promise<TaskCommunicationResult>;\n\n/** Durable Task and receipt context supplied to a lifecycle event projection. */\nexport interface TaskLifecycleProjectionInput<\n  Stores extends TaskCommunicationStores = TaskCommunicationStores,\n> {\n  stores: Stores;\n  tasks: readonly Task[];\n  task: Task;\n  receipt: Receipt;\n}\n\n/** Application policy for projecting durable task state into connector-neutral events. */\nexport interface TaskCommunicationProjection<\n  Stores extends TaskCommunicationStores = TaskCommunicationStores,\n> {\n  question(task: Task): MaybePromise<readonly CommunicationEvent[]>;\n  lifecycle(\n    input: TaskLifecycleProjectionInput<Stores>,\n  ): MaybePromise<readonly CommunicationEvent[]>;\n}\n\n/**\n * Build the generic durable receipt reconciler around an application's event\n * projection. Events are acknowledged only after every projected event has\n * reached the outbox.\n */\nexport function createTaskCommunicationReconciler<Stores extends TaskCommunicationStores>(\n  projection: TaskCommunicationProjection<Stores>,\n): TaskCommunicationReconciler<Stores> {\n  return async function reconcileTaskCommunications(\n    stores: Stores,\n    snapshot?: readonly Task[],\n  ): Promise<TaskCommunicationResult> {\n    const tasks = snapshot ?? (await stores.tasks.list());\n    let enqueued = 0;\n    for (const task of tasks) {\n      const presentsQuestion = task.question !== undefined;\n      // A connector may confirm before the parent starts waiting, or before\n      // its delivery stamp is persisted.\n      if (\n        presentsQuestion &&\n        task.state === \"needs_human\" &&\n        task.needsHumanNotifiedAt !== undefined\n      ) {\n        await stores.tasks.recordNeedsHumanDelivery(task.id, { attempt: task.attempt });\n      }\n      if (\n        presentsQuestion &&\n        task.state === \"needs_human\" &&\n        task.needsHumanNotifiedAt === undefined &&\n        !task.pendingCommunicationReceiptIds?.length\n      ) {\n        for (const event of await projection.question(task)) {\n          await stores.outbox.enqueue(event);\n          enqueued += 1;\n        }\n      }\n      for (const receiptId of task.pendingCommunicationReceiptIds ?? []) {\n        const receipt = await stores.receipts.get(receiptId);\n        if (receipt === null || receipt.taskId !== task.id) {\n          throw new Error(`Task ${task.id} references missing lifecycle receipt ${receiptId}.`);\n        }\n        if (receipt.state === \"needs_human\" && presentsQuestion) {\n          if (task.state === \"needs_human\" && task.attempt === receipt.attempt) {\n            for (const event of await projection.question(task)) {\n              await stores.outbox.enqueue(event);\n              enqueued += 1;\n            }\n          }\n          await stores.tasks.acknowledgeCommunication(task.id, receiptId);\n          continue;\n        }\n        for (const event of await projection.lifecycle({ stores, tasks, task, receipt })) {\n          await stores.outbox.enqueue(event);\n          enqueued += 1;\n        }\n        await stores.tasks.acknowledgeCommunication(task.id, receiptId);\n      }\n    }\n    return { enqueued };\n  };\n}\n"],"mappings":";;;;;;AA4CA,SAAgB,kCACd,YACqC;CACrC,OAAO,eAAe,4BACpB,QACA,UACkC;EAClC,MAAM,QAAQ,YAAa,MAAM,OAAO,MAAM,KAAK;EACnD,IAAI,WAAW;EACf,KAAK,MAAM,QAAQ,OAAO;GACxB,MAAM,mBAAmB,KAAK,aAAa,KAAA;GAG3C,IACE,oBACA,KAAK,UAAU,iBACf,KAAK,yBAAyB,KAAA,GAE9B,MAAM,OAAO,MAAM,yBAAyB,KAAK,IAAI,EAAE,SAAS,KAAK,QAAQ,CAAC;GAEhF,IACE,oBACA,KAAK,UAAU,iBACf,KAAK,yBAAyB,KAAA,KAC9B,CAAC,KAAK,gCAAgC,QAEtC,KAAK,MAAM,SAAS,MAAM,WAAW,SAAS,IAAI,GAAG;IACnD,MAAM,OAAO,OAAO,QAAQ,KAAK;IACjC,YAAY;GACd;GAEF,KAAK,MAAM,aAAa,KAAK,kCAAkC,CAAC,GAAG;IACjE,MAAM,UAAU,MAAM,OAAO,SAAS,IAAI,SAAS;IACnD,IAAI,YAAY,QAAQ,QAAQ,WAAW,KAAK,IAC9C,MAAM,IAAI,MAAM,QAAQ,KAAK,GAAG,wCAAwC,UAAU,EAAE;IAEtF,IAAI,QAAQ,UAAU,iBAAiB,kBAAkB;KACvD,IAAI,KAAK,UAAU,iBAAiB,KAAK,YAAY,QAAQ,SAC3D,KAAK,MAAM,SAAS,MAAM,WAAW,SAAS,IAAI,GAAG;MACnD,MAAM,OAAO,OAAO,QAAQ,KAAK;MACjC,YAAY;KACd;KAEF,MAAM,OAAO,MAAM,yBAAyB,KAAK,IAAI,SAAS;KAC9D;IACF;IACA,KAAK,MAAM,SAAS,MAAM,WAAW,UAAU;KAAE;KAAQ;KAAO;KAAM;IAAQ,CAAC,GAAG;KAChF,MAAM,OAAO,OAAO,QAAQ,KAAK;KACjC,YAAY;IACd;IACA,MAAM,OAAO,MAAM,yBAAyB,KAAK,IAAI,SAAS;GAChE;EACF;EACA,OAAO,EAAE,SAAS;CACpB;AACF"}
+{"version":3,"file":"task-communication.mjs","names":[],"sources":["../src/task-communication.ts"],"sourcesContent":["import { collectFactoryRecords } from \"./store/iterate\";\nimport type { CommunicationEvent } from \"./schema/communication\";\nimport type { MaybePromise } from \"./schema/common\";\nimport type { Receipt } from \"./schema/receipt\";\nimport type { Task } from \"./schema/task\";\nimport type { FactoryStores } from \"./store/engine\";\n\n/** Outbox, receipt, and Task capabilities required by communication reconciliation. */\nexport type TaskCommunicationStores = Pick<FactoryStores, \"outbox\" | \"receipts\" | \"tasks\">;\n\n/** Number of connector-neutral events newly enqueued during reconciliation. */\nexport interface TaskCommunicationResult {\n  enqueued: number;\n}\n\n/** Repairs pending Task communication projections against the durable outbox. */\nexport type TaskCommunicationReconciler<\n  Stores extends TaskCommunicationStores = TaskCommunicationStores,\n> = (stores: Stores, snapshot?: readonly Task[]) => Promise<TaskCommunicationResult>;\n\n/** Durable Task and receipt context supplied to a lifecycle event projection. */\nexport interface TaskLifecycleProjectionInput<\n  Stores extends TaskCommunicationStores = TaskCommunicationStores,\n> {\n  stores: Stores;\n  tasks: readonly Task[];\n  task: Task;\n  receipt: Receipt;\n}\n\n/** Application policy for projecting durable task state into connector-neutral events. */\nexport interface TaskCommunicationProjection<\n  Stores extends TaskCommunicationStores = TaskCommunicationStores,\n> {\n  question(task: Task): MaybePromise<readonly CommunicationEvent[]>;\n  lifecycle(\n    input: TaskLifecycleProjectionInput<Stores>,\n  ): MaybePromise<readonly CommunicationEvent[]>;\n}\n\n/**\n * Build the generic durable receipt reconciler around an application's event\n * projection. Events are acknowledged only after every projected event has\n * reached the outbox.\n */\nexport function createTaskCommunicationReconciler<Stores extends TaskCommunicationStores>(\n  projection: TaskCommunicationProjection<Stores>,\n): TaskCommunicationReconciler<Stores> {\n  return async function reconcileTaskCommunications(\n    stores: Stores,\n    snapshot?: readonly Task[],\n  ): Promise<TaskCommunicationResult> {\n    const tasks = snapshot ?? [\n      ...new Map(\n        (\n          await Promise.all([\n            collectFactoryRecords(stores.tasks.list, {\n              limit: 100,\n              match: { state: \"needs_human\" },\n              fields: [{ path: [\"question\"], test: \"exists\" }],\n            }),\n            collectFactoryRecords(stores.tasks.list, {\n              limit: 100,\n              fields: [{ path: [\"pendingCommunicationReceiptIds\"], test: \"notEmpty\" }],\n            }),\n          ])\n        )\n          .flat()\n          .map((task) => [task.id, task]),\n      ).values(),\n    ];\n    let enqueued = 0;\n    for (const task of tasks) {\n      const presentsQuestion = task.question !== undefined;\n      // A connector may confirm before the parent starts waiting, or before\n      // its delivery stamp is persisted.\n      if (\n        presentsQuestion &&\n        task.state === \"needs_human\" &&\n        task.needsHumanNotifiedAt !== undefined\n      ) {\n        await stores.tasks.recordNeedsHumanDelivery(task.id, { attempt: task.attempt });\n      }\n      if (\n        presentsQuestion &&\n        task.state === \"needs_human\" &&\n        task.needsHumanNotifiedAt === undefined &&\n        !task.pendingCommunicationReceiptIds?.length\n      ) {\n        for (const event of await projection.question(task)) {\n          await stores.outbox.enqueue(event);\n          enqueued += 1;\n        }\n      }\n      for (const receiptId of task.pendingCommunicationReceiptIds ?? []) {\n        const receipt = await stores.receipts.get(receiptId);\n        if (receipt === null || receipt.taskId !== task.id) {\n          throw new Error(`Task ${task.id} references missing lifecycle receipt ${receiptId}.`);\n        }\n        if (receipt.state === \"needs_human\" && presentsQuestion) {\n          if (task.state === \"needs_human\" && task.attempt === receipt.attempt) {\n            for (const event of await projection.question(task)) {\n              await stores.outbox.enqueue(event);\n              enqueued += 1;\n            }\n          }\n          await stores.tasks.acknowledgeCommunication(task.id, receiptId);\n          continue;\n        }\n        for (const event of await projection.lifecycle({ stores, tasks, task, receipt })) {\n          await stores.outbox.enqueue(event);\n          enqueued += 1;\n        }\n        await stores.tasks.acknowledgeCommunication(task.id, receiptId);\n      }\n    }\n    return { enqueued };\n  };\n}\n"],"mappings":";;;;;;;AA6CA,SAAgB,kCACd,YACqC;CACrC,OAAO,eAAe,4BACpB,QACA,UACkC;EAClC,MAAM,QAAQ,YAAY,CACxB,GAAG,IAAI,KAEH,MAAM,QAAQ,IAAI,CAChB,sBAAsB,OAAO,MAAM,MAAM;GACvC,OAAO;GACP,OAAO,EAAE,OAAO,cAAc;GAC9B,QAAQ,CAAC;IAAE,MAAM,CAAC,UAAU;IAAG,MAAM;GAAS,CAAC;EACjD,CAAC,GACD,sBAAsB,OAAO,MAAM,MAAM;GACvC,OAAO;GACP,QAAQ,CAAC;IAAE,MAAM,CAAC,gCAAgC;IAAG,MAAM;GAAW,CAAC;EACzE,CAAC,CACH,CAAC,EAAA,CAEA,KAAK,CAAC,CACN,KAAK,SAAS,CAAC,KAAK,IAAI,IAAI,CAAC,CAClC,CAAC,CAAC,OAAO,CACX;EACA,IAAI,WAAW;EACf,KAAK,MAAM,QAAQ,OAAO;GACxB,MAAM,mBAAmB,KAAK,aAAa,KAAA;GAG3C,IACE,oBACA,KAAK,UAAU,iBACf,KAAK,yBAAyB,KAAA,GAE9B,MAAM,OAAO,MAAM,yBAAyB,KAAK,IAAI,EAAE,SAAS,KAAK,QAAQ,CAAC;GAEhF,IACE,oBACA,KAAK,UAAU,iBACf,KAAK,yBAAyB,KAAA,KAC9B,CAAC,KAAK,gCAAgC,QAEtC,KAAK,MAAM,SAAS,MAAM,WAAW,SAAS,IAAI,GAAG;IACnD,MAAM,OAAO,OAAO,QAAQ,KAAK;IACjC,YAAY;GACd;GAEF,KAAK,MAAM,aAAa,KAAK,kCAAkC,CAAC,GAAG;IACjE,MAAM,UAAU,MAAM,OAAO,SAAS,IAAI,SAAS;IACnD,IAAI,YAAY,QAAQ,QAAQ,WAAW,KAAK,IAC9C,MAAM,IAAI,MAAM,QAAQ,KAAK,GAAG,wCAAwC,UAAU,EAAE;IAEtF,IAAI,QAAQ,UAAU,iBAAiB,kBAAkB;KACvD,IAAI,KAAK,UAAU,iBAAiB,KAAK,YAAY,QAAQ,SAC3D,KAAK,MAAM,SAAS,MAAM,WAAW,SAAS,IAAI,GAAG;MACnD,MAAM,OAAO,OAAO,QAAQ,KAAK;MACjC,YAAY;KACd;KAEF,MAAM,OAAO,MAAM,yBAAyB,KAAK,IAAI,SAAS;KAC9D;IACF;IACA,KAAK,MAAM,SAAS,MAAM,WAAW,UAAU;KAAE;KAAQ;KAAO;KAAM;IAAQ,CAAC,GAAG;KAChF,MAAM,OAAO,OAAO,QAAQ,KAAK;KACjC,YAAY;IACd;IACA,MAAM,OAAO,MAAM,yBAAyB,KAAK,IAAI,SAAS;GAChE;EACF;EACA,OAAO,EAAE,SAAS;CACpB;AACF"}

package/dist/task-protocols.d.mts

@@ -13,8 +13,8 @@ declare const assignmentPayloadSchema: z.ZodObject<{
 declare const handoffPayloadSchema: z.ZodObject<{
   outcome: z.ZodEnum<{
     failed: "failed";
-    completed: "completed";
     needs_input: "needs_input";
+    completed: "completed";
   }>;
   summary: z.ZodString;
   output: z.ZodOptional<z.ZodCustom<JsonValue, JsonValue>>;
@@ -38,8 +38,8 @@ declare const assignmentTaskMessageProtocol: Readonly<TaskMessageProtocol<z.ZodO
 declare const handoffTaskMessageProtocol: Readonly<TaskMessageProtocol<z.ZodObject<{
   outcome: z.ZodEnum<{
     failed: "failed";
-    completed: "completed";
     needs_input: "needs_input";
+    completed: "completed";
   }>;
   summary: z.ZodString;
   output: z.ZodOptional<z.ZodCustom<JsonValue, JsonValue>>;
@@ -57,8 +57,8 @@ declare const standardTaskMessageProtocols: readonly (Readonly<TaskMessageProtoc
 }, z.core.$strict>, "assignment", 1>> | Readonly<TaskMessageProtocol<z.ZodObject<{
   outcome: z.ZodEnum<{
     failed: "failed";
-    completed: "completed";
     needs_input: "needs_input";
+    completed: "completed";
   }>;
   summary: z.ZodString;
   output: z.ZodOptional<z.ZodCustom<JsonValue, JsonValue>>;

package/dist/tasks.d.mts

@@ -1,4 +1,3 @@
-import { ApprovalPolicy, ApprovalPriority, ApprovalRule, ApprovalSubject, allowByDefaultApprovalPolicy, approvalPolicySchema, approvalPrioritySchema, approvalRuleSchema, requiresApproval } from "./approval.mjs";
 import { AnswerId, TaskId, answerIdSchema, taskIdSchema } from "./schema/id.mjs";
 import { ExecutionReference, MessageWaitingTask, NeedsHumanTask, SucceededTask, Task, TaskApproval, TaskKind, TaskOrigin, TaskQuestion, TaskState, TaskUsage, executionReferenceSchema, harnessSchema, isMessageWaitingTask, isNeedsHumanTask, isSucceededTask, standardTaskKinds, taskApprovalSchema, taskExecutionRepositoryIdsSchema, taskKindSchema, taskOriginSchema, taskQuestionSchema, taskSchema, taskStateSchema, taskUsageSchema } from "./schema/task.mjs";
 import { MAX_TASK_INBOX_PENDING, SendTaskMessageInput, TaskInbox, TaskMessage, TaskMessageClaim, TaskMessageDiscard, TaskMessageForProtocol, TaskMessageId, TaskMessageOperationId, TaskMessagePrincipal, TaskMessageProcessing, TaskMessageProtocol, TaskMessageProtocolBinding, TaskMessageProtocolBindingInput, TaskMessageProtocolInput, TaskMessageProtocolInputPayload, TaskMessageProtocolStoredPayload, TaskMessageProtocols, defineTaskMessageProtocol, defineTaskMessageProtocols, parseTaskMessageProtocolBinding, sendTaskMessageInputSchema, taskInboxSchema, taskMessageClaimSchema, taskMessageDiscardSchema, taskMessageIdSchema, taskMessageInput, taskMessageOperationIdSchema, taskMessagePrincipalSchema, taskMessageProcessingSchema, taskMessageProtocolBindingSchema, taskMessageProtocolSchema, taskMessageReservationSchema, taskMessageSchema } from "./schema/task-message.mjs";
@@ -10,6 +9,7 @@ import { CreateTaskEffectStoreOptions, RecordTaskEffectInput, ResolveTaskEffectI
 import { CompleteTaskWorkInput, CompleteWorkflowTaskWorkInput, CreateTaskWorkStoreOptions, ResumeTaskWorkInput, TaskWorkCompletionFence, TaskWorkStore, TaskWorkStores, TaskWorkUsage, WaitForTaskMessagesInput, createTaskWorkStore } from "./store/task-work.mjs";
 import { AnswerEvent, answerEventSchema } from "./schema/answer.mjs";
 import { AgentSessionBinding, AnswerEventConflictError, AnswerQuestionInput, AnswerQuestionResult, ApprovalDecision, ApprovalError, CreateTaskInput, RejectionDecision, RootTaskOrigin, TaskAttemptConflictError, TaskPatch, TaskTransitionArguments, TaskTransitionOptions } from "./store/engine.mjs";
+import { ApprovalPolicy, ApprovalPriority, ApprovalRule, ApprovalSubject, allowByDefaultApprovalPolicy, approvalPolicySchema, approvalPrioritySchema, approvalRuleSchema, requiresApproval } from "./approval.mjs";
 import { ApprovalAccess, ApprovalAccessDecisionInput, ApprovalAccessError, ApprovalAccessOptions, ApprovalAccessStores, createApprovalAccess } from "./approval-access.mjs";
 import { taskInitialState, taskTransitions } from "./schema/transitions.mjs";
 import { ProcessTaskMessageOptions, ProcessTaskMessageResult, TaskMessageProcessingStores, processTaskMessage, readTaskMessageDecision } from "./task-message-processing.mjs";

package/dist/vercel.d.mts

@@ -1,5 +1,5 @@
-import { RepositorySlug } from "./schema/repository.mjs";
 import { WorkNotification, WorkNotifications } from "./store/work-notifications.mjs";
+import { RepositorySlug } from "./schema/repository.mjs";
 import { VercelManagedGitHubApi, VercelManagedGitHubApiAction, VercelManagedGitHubApiError, VercelManagedGitHubApiOptions, VercelManagedGitHubApiSandboxCreateInput, VercelManagedGitHubIssue, VercelManagedGitHubIssueInput, VercelManagedGitHubPublication, VercelManagedGitHubPublicationInput, VercelManagedGitHubPullRequest, VercelManagedGitHubPullRequestInput, createVercelManagedGitHubApi } from "./vercel-github-api.mjs";
 import { VercelGitHubGitTransportOptions, VercelGitHubTokenInput, VercelManagedGitHubGitTransportOptions, VercelManagedGitHubSandboxCreateInput, createVercelGitHubGitTransport, createVercelManagedGitHubGitTransport } from "./vercel-git.mjs";
 //#region src/vercel.d.ts

package/dist/work-triage/find-existing-work.d.mts

@@ -1,7 +1,7 @@
 import { RepositoryId } from "../schema/id.mjs";
-import { RepositorySlug } from "../schema/repository.mjs";
 import { Task } from "../schema/task.mjs";
 import { Change } from "../schema/change.mjs";
+import { RepositorySlug } from "../schema/repository.mjs";
 import { FactoryStores } from "../store/engine.mjs";
 import { OpenPullRequest } from "../pull-requests/contracts.mjs";
 //#region src/work-triage/find-existing-work.d.ts

package/dist/work-triage/find-existing-work.mjs

@@ -1,3 +1,4 @@
+import { collectFactoryRecords } from "../store/iterate.mjs";
 //#region src/work-triage/find-existing-work.ts
 const openChangeStates = /* @__PURE__ */ new Set(["verifying", "ready"]);
 const activeTaskStates = /* @__PURE__ */ new Set([
@@ -15,8 +16,17 @@ async function findExistingWork(input) {
 	};
 	const [openPullRequests, changes, tasks] = await Promise.all([
 		input.listOpenPullRequests(repository.slug),
-		input.stores.changes.list(),
-		input.stores.tasks.list()
+		collectFactoryRecords(input.stores.changes.list, {
+			limit: 100,
+			match: [...openChangeStates].map((state) => ({
+				repositoryId: input.repositoryId,
+				state
+			}))
+		}),
+		collectFactoryRecords(input.stores.tasks.list, {
+			limit: 100,
+			match: { repositoryIds: [input.repositoryId] }
+		})
 	]);
 	return {
 		found: true,