@vercel/factory 0.0.16 → 0.0.18

package/dist/store/indexed-projections.mjs

@@ -0,0 +1,481 @@
+import { changeIdSchema, receiptIdSchema, repositoryIdSchema, signalIdSchema, taskIdSchema } from "../schema/id.mjs";
+import { isoDateTimeSchema, replyToSchema } from "../schema/common.mjs";
+import { repositorySchema } from "../schema/repository.mjs";
+import { executionReferenceSchema, taskSchema, taskStateSchema } from "../schema/task.mjs";
+import { receiptSchema } from "../schema/receipt.mjs";
+import { transcriptSnapshotSchema } from "../schema/transcript.mjs";
+import { changeSchema, changeStateSchema } from "../schema/change.mjs";
+import { agentSessionIdSchema, agentSessionSchema } from "../schema/session.mjs";
+import { signalSchema } from "../schema/signal.mjs";
+import { sessionContinuationRecordSchema, sessionNotificationRecordSchema } from "./session-history.mjs";
+import { createHash } from "node:crypto";
+import { z } from "zod";
+//#region src/store/indexed-projections.ts
+const collectionSchema = z.enum([
+	"repositories",
+	"signals",
+	"tasks",
+	"changes",
+	"receipts",
+	"sessions",
+	"externalSessions",
+	"sessionContinuations",
+	"sessionNotifications",
+	"transcripts"
+]);
+const sessionCollections = z.enum(["sessions", "externalSessions"]);
+/** Validates an exact, trusted query scope; transport callers must authorize it before querying. */
+const factoryIndexScopeSchema = z.union([
+	z.strictObject({
+		collection: z.enum(["sessionContinuations", "sessionNotifications"]).describe("Paginated session history collection."),
+		by: z.literal("session").describe("History within an exact session."),
+		sessionId: agentSessionIdSchema.describe("Session whose history is selected.")
+	}),
+	z.strictObject({
+		collection: collectionSchema.describe("Source collection to query."),
+		by: z.literal("all").describe("All records in the namespace's collection.")
+	}),
+	z.strictObject({
+		collection: collectionSchema.exclude(["repositories", "transcripts"]).describe("Source collection with repository memberships."),
+		by: z.literal("repository").describe("Records belonging to the selected repository."),
+		repositoryId: repositoryIdSchema.describe("Repository membership to query.")
+	}),
+	z.strictObject({
+		collection: z.literal("tasks").describe("Task source summaries."),
+		by: z.literal("state").describe("Tasks in one lifecycle state."),
+		state: taskStateSchema.describe("Exact Task lifecycle state to query."),
+		repositoryId: repositoryIdSchema.optional().describe("Optional repository membership filter.")
+	}),
+	z.strictObject({
+		collection: z.literal("changes").describe("Change source summaries."),
+		by: z.literal("state").describe("Changes in one lifecycle state."),
+		state: changeStateSchema.describe("Exact Change lifecycle state to query."),
+		repositoryId: repositoryIdSchema.optional().describe("Optional repository membership filter.")
+	}),
+	z.strictObject({
+		collection: z.literal("tasks").describe("Task source summaries."),
+		by: z.literal("root").describe("Tasks in one canonical root graph."),
+		rootTaskId: taskIdSchema.describe("Root Task identifying the graph.")
+	}),
+	z.strictObject({
+		collection: z.literal("tasks").describe("Task source summaries."),
+		by: z.literal("reply").describe("Tasks sharing an exact reply destination."),
+		replyTo: replyToSchema.describe("Exact reply destination to query.")
+	}),
+	z.strictObject({
+		collection: z.enum([
+			"receipts",
+			"changes",
+			"sessions",
+			"sessionContinuations"
+		]).describe("Task-bound source collection."),
+		by: z.literal("task").describe("Records bound to one Task."),
+		taskId: taskIdSchema.describe("Task whose bound records are selected.")
+	}),
+	z.strictObject({
+		collection: sessionCollections.describe("Internal or external session collection."),
+		by: z.literal("owner").describe("Sessions belonging to one owner."),
+		owner: z.string().min(1).describe("Authorized session owner to query."),
+		repositoryId: repositoryIdSchema.optional().describe("Optional repository membership filter.")
+	}),
+	z.strictObject({
+		collection: sessionCollections.describe("Internal or external session collection."),
+		by: z.literal("execution").describe("Sessions bound to an exact provider execution."),
+		execution: executionReferenceSchema.describe("Execution identity; only provider and sessionId select the scope.")
+	}),
+	z.strictObject({
+		collection: z.enum(["tasks", "changes"]).describe("Source collection requiring attention."),
+		by: z.literal("attention").describe("Source attention, without conversation deduplication."),
+		repositoryId: repositoryIdSchema.optional().describe("Optional repository membership filter.")
+	}),
+	z.strictObject({
+		collection: z.literal("transcripts").describe("Transcript source summaries."),
+		by: z.literal("attention").describe("Source attention, without conversation deduplication.")
+	})
+]);
+const common = {
+	id: z.string().min(1).describe("Canonical source record key."),
+	repositoryIds: z.array(repositoryIdSchema).readonly().describe("Repository memberships; callers must authorize every repository."),
+	createdAt: isoDateTimeSchema.describe("Source timestamp used to order this summary.")
+};
+/** Validates compact source summaries, without Task inputs, messages, histories, or transcript bodies. */
+const factoryRecordSummarySchema = z.discriminatedUnion("collection", [
+	z.strictObject({
+		...common,
+		collection: z.literal("sessionContinuations").describe("Separate follow-up intent."),
+		sessionId: agentSessionIdSchema.describe("Owning conversation."),
+		taskId: taskIdSchema.describe("Task admitted for this follow-up."),
+		committed: z.boolean().describe("Whether the session head admitted this intent.")
+	}),
+	z.strictObject({
+		...common,
+		collection: z.literal("sessionNotifications").describe("Separate delivered notification."),
+		sessionId: agentSessionIdSchema.describe("Owning conversation."),
+		outcome: z.string().describe("Notification outcome.")
+	}),
+	z.strictObject({
+		...common,
+		collection: z.literal("repositories").describe("Repository source summary."),
+		id: repositoryIdSchema.describe("Canonical repository ID."),
+		slug: z.string().describe("Provider repository slug."),
+		enabled: z.boolean().describe("Whether the repository is enabled for work.")
+	}),
+	z.strictObject({
+		...common,
+		collection: z.literal("signals").describe("Signal source summary."),
+		id: signalIdSchema.describe("Canonical Signal ID."),
+		source: z.string().describe("Signal source kind."),
+		outcome: z.string().describe("Recorded triage outcome.")
+	}),
+	z.strictObject({
+		...common,
+		collection: z.literal("tasks").describe("Task source summary."),
+		title: z.string().max(256).describe("Work title without input or history payloads."),
+		id: taskIdSchema.describe("Canonical Task ID."),
+		kind: z.string().describe("Descriptive Task kind, not routing authority."),
+		state: taskStateSchema.describe("Current Task lifecycle state."),
+		rootTaskId: taskIdSchema.describe("Root of the canonical Task graph."),
+		parentTaskId: taskIdSchema.optional().describe("Immediate parent Task when present."),
+		attempt: z.number().int().positive().describe("Current Task execution attempt."),
+		changeId: changeIdSchema.optional().describe("Associated Change when present."),
+		route: z.object({
+			id: z.string().describe("Exact registered agent route ID."),
+			version: z.number().describe("Exact registered agent route version.")
+		}).optional().describe("Persisted agent route when the Task uses one."),
+		approval: z.enum([
+			"required",
+			"granted",
+			"denied"
+		]).optional().describe("Task approval state."),
+		updatedAt: isoDateTimeSchema.describe("Latest canonical Task update."),
+		attention: z.enum([
+			"question",
+			"failed",
+			"stalled",
+			"approval"
+		]).optional().describe("Task attention reason; not a deduplicated conversation decision.")
+	}),
+	z.strictObject({
+		...common,
+		collection: z.literal("changes").describe("Change source summary."),
+		id: changeIdSchema.describe("Canonical Change ID."),
+		state: changeStateSchema.describe("Current Change lifecycle state."),
+		taskId: taskIdSchema.optional().describe("Task that created the Change, when present."),
+		prNumber: z.number().int().positive().describe("Repository-local pull request number."),
+		updatedAt: isoDateTimeSchema.describe("Latest canonical Change update."),
+		attention: z.literal("review").optional().describe("The Change is ready for review.")
+	}),
+	z.strictObject({
+		...common,
+		collection: z.literal("receipts").describe("Receipt source summary."),
+		id: receiptIdSchema.describe("Immutable receipt ID."),
+		taskId: taskIdSchema.optional().describe("Task evidenced by this receipt, when present."),
+		changeId: changeIdSchema.optional().describe("Associated Change when present."),
+		kind: z.string().describe("Receipt evidence kind."),
+		state: z.string().describe("State recorded by the receipt."),
+		attempt: z.number().int().positive().describe("Attempt recorded by the receipt.")
+	}),
+	z.strictObject({
+		...common,
+		collection: z.literal("sessions").describe("Internal session source summary."),
+		id: agentSessionIdSchema.describe("Canonical session ID."),
+		owner: z.string().describe("Session owner used for access scoping."),
+		title: z.string().max(256).describe("Bounded display title from the initial message."),
+		agent: z.string().describe("Agent selected when the session was admitted."),
+		taskId: taskIdSchema.optional().describe("Task bound to the session, when present."),
+		attached: z.boolean().describe("Whether the session is attached to existing work."),
+		execution: executionReferenceSchema.optional().describe("Bound provider execution, when present.")
+	}),
+	z.strictObject({
+		...common,
+		collection: z.literal("externalSessions").describe("External session source summary."),
+		id: agentSessionIdSchema.describe("Canonical external session ID."),
+		owner: z.string().describe("Session owner used for access scoping."),
+		title: z.string().max(256).describe("Bounded display title from the initial message."),
+		agent: z.string().describe("Agent selected for the external session."),
+		execution: executionReferenceSchema.describe("Bound provider execution."),
+		source: z.string().describe("External reply channel.")
+	}),
+	z.strictObject({
+		...common,
+		collection: z.literal("transcripts").describe("Transcript source summary."),
+		execution: executionReferenceSchema.describe("Execution that owns the transcript."),
+		state: transcriptSnapshotSchema.unwrap().shape.state.describe("Provider conversation state."),
+		cursor: z.number().int().nonnegative().describe("Latest persisted transcript cursor."),
+		inputCount: z.number().int().nonnegative().describe("Number of transcript input descriptors."),
+		updatedAt: isoDateTimeSchema.describe("Latest persisted transcript update."),
+		attention: z.enum(["failed", "conversation"]).optional().describe("Transcript attention reason; not an internal session's attention decision.")
+	})
+]);
+function hash(value) {
+	return createHash("sha256").update(JSON.stringify(value)).digest("hex");
+}
+function factoryIndexKey(input) {
+	let scope = factoryIndexScopeSchema.parse(input);
+	if (scope.by === "execution") scope = {
+		...scope,
+		execution: {
+			provider: scope.execution.provider,
+			sessionId: scope.execution.sessionId
+		}
+	};
+	return `factory:v1:${scope.collection}:${scope.by}:${hash(scope)}`;
+}
+function projectIndexedRecord(collection, id, value) {
+	if (!collectionSchema.safeParse(collection).success) return [];
+	const scopes = [];
+	let summary;
+	if (collection === "sessionContinuations") {
+		const record = sessionContinuationRecordSchema.parse(value);
+		if (record.id !== id) throw new Error("Continuation storage key mismatch");
+		summary = {
+			collection,
+			id,
+			repositoryIds: [],
+			createdAt: record.createdAt,
+			sessionId: record.sessionId,
+			taskId: record.continuation.taskId,
+			committed: record.committed
+		};
+		scopes.push({
+			collection,
+			by: "session",
+			sessionId: record.sessionId
+		}, {
+			collection,
+			by: "task",
+			taskId: record.continuation.taskId
+		});
+	} else if (collection === "sessionNotifications") {
+		const record = sessionNotificationRecordSchema.parse(value);
+		if (record.id !== id) throw new Error("Notification storage key mismatch");
+		summary = {
+			collection,
+			id,
+			repositoryIds: record.event.repositoryIds,
+			createdAt: record.createdAt,
+			sessionId: record.sessionId,
+			outcome: record.event.outcome
+		};
+		scopes.push({
+			collection,
+			by: "session",
+			sessionId: record.sessionId
+		});
+	} else if (collection === "tasks") {
+		const task = taskSchema.parse(value);
+		if (task.id !== id) throw new Error("Task storage key mismatch");
+		const attention = task.state === "needs_human" ? "question" : task.state === "failed" || task.state === "stalled" ? task.state : task.state === "queued" && task.approval === "required" ? "approval" : void 0;
+		summary = {
+			collection,
+			id: task.id,
+			repositoryIds: task.repositoryIds,
+			title: task.work.title,
+			kind: task.kind,
+			state: task.state,
+			rootTaskId: task.rootTaskId,
+			parentTaskId: task.parentTaskId,
+			attempt: task.attempt,
+			changeId: task.changeId,
+			route: task.work.route,
+			approval: task.approval,
+			createdAt: task.createdAt,
+			updatedAt: task.updatedAt,
+			attention
+		};
+		scopes.push({
+			collection,
+			by: "state",
+			state: task.state
+		}, {
+			collection,
+			by: "root",
+			rootTaskId: task.rootTaskId
+		}, {
+			collection,
+			by: "reply",
+			replyTo: task.replyTo
+		});
+		for (const repositoryId of new Set(task.repositoryIds)) scopes.push({
+			collection,
+			by: "state",
+			state: task.state,
+			repositoryId
+		});
+		if (attention) {
+			scopes.push({
+				collection,
+				by: "attention"
+			});
+			for (const repositoryId of new Set(task.repositoryIds)) scopes.push({
+				collection,
+				by: "attention",
+				repositoryId
+			});
+		}
+	} else if (collection === "sessions" || collection === "externalSessions") {
+		const session = agentSessionSchema.parse(value);
+		if (session.id !== id || collection === "externalSessions" !== (session.external !== void 0)) throw new Error("Session storage key or collection mismatch");
+		const base = {
+			id: session.id,
+			repositoryIds: session.external?.repositoryIds ?? (session.repositoryId ? [session.repositoryId] : []),
+			owner: session.owner,
+			title: session.message.slice(0, 256).replace(/[\uD800-\uDBFF]$/u, ""),
+			agent: session.agent,
+			createdAt: session.createdAt
+		};
+		summary = collection === "externalSessions" && session.external && session.execution ? {
+			...base,
+			collection,
+			execution: session.execution,
+			source: session.external.replyTo.channel
+		} : {
+			...base,
+			collection: "sessions",
+			taskId: session.taskId,
+			attached: session.attached ?? false,
+			execution: session.execution
+		};
+		scopes.push({
+			collection,
+			by: "owner",
+			owner: session.owner
+		});
+		for (const repositoryId of new Set(base.repositoryIds)) scopes.push({
+			collection,
+			by: "owner",
+			owner: session.owner,
+			repositoryId
+		});
+		if (session.execution) scopes.push({
+			collection,
+			by: "execution",
+			execution: session.execution
+		});
+		if (collection === "sessions" && session.taskId) scopes.push({
+			collection,
+			by: "task",
+			taskId: session.taskId
+		});
+	} else if (collection === "changes") {
+		const change = changeSchema.parse(value);
+		if (change.id !== id) throw new Error("Change storage key mismatch");
+		summary = {
+			collection,
+			id: change.id,
+			repositoryIds: [change.repositoryId],
+			state: change.state,
+			taskId: change.taskId,
+			prNumber: change.prNumber,
+			createdAt: change.createdAt,
+			updatedAt: change.updatedAt,
+			attention: change.state === "ready" ? "review" : void 0
+		};
+		scopes.push({
+			collection,
+			by: "state",
+			state: change.state
+		}, {
+			collection,
+			by: "state",
+			state: change.state,
+			repositoryId: change.repositoryId
+		});
+		if (change.taskId) scopes.push({
+			collection,
+			by: "task",
+			taskId: change.taskId
+		});
+		if (change.state === "ready") scopes.push({
+			collection,
+			by: "attention"
+		}, {
+			collection,
+			by: "attention",
+			repositoryId: change.repositoryId
+		});
+	} else if (collection === "receipts") {
+		const receipt = receiptSchema.parse(value);
+		if (receipt.receiptId !== id) throw new Error("Receipt storage key mismatch");
+		summary = {
+			collection,
+			id: receipt.receiptId,
+			repositoryIds: receipt.repositoryIds,
+			taskId: receipt.taskId,
+			changeId: receipt.changeId,
+			kind: receipt.kind,
+			state: receipt.state,
+			attempt: receipt.attempt,
+			createdAt: receipt.recordedAt
+		};
+		if (receipt.taskId) scopes.push({
+			collection,
+			by: "task",
+			taskId: receipt.taskId
+		});
+	} else if (collection === "signals") {
+		const signal = signalSchema.parse(value);
+		if (signal.id !== id) throw new Error("Signal storage key mismatch");
+		summary = {
+			collection,
+			id: signal.id,
+			repositoryIds: [signal.repositoryId],
+			source: signal.source,
+			outcome: signal.outcome,
+			createdAt: signal.receivedAt
+		};
+	} else if (collection === "repositories") {
+		const repository = repositorySchema.parse(value);
+		if (repository.id !== id) throw new Error("Repository storage key mismatch");
+		summary = {
+			collection,
+			id: repository.id,
+			repositoryIds: [repository.id],
+			slug: repository.slug,
+			enabled: repository.enabled,
+			createdAt: repository.connectedAt
+		};
+	} else {
+		const transcript = z.object({
+			execution: executionReferenceSchema,
+			snapshot: transcriptSnapshotSchema,
+			updatedAt: isoDateTimeSchema
+		}).parse(value);
+		const attention = transcript.snapshot.state === "failed" ? "failed" : transcript.snapshot.state === "waiting" || transcript.snapshot.state === "needs input" ? "conversation" : void 0;
+		summary = {
+			collection: "transcripts",
+			id,
+			repositoryIds: [],
+			execution: transcript.execution,
+			state: transcript.snapshot.state,
+			cursor: transcript.snapshot.cursor,
+			inputCount: transcript.snapshot.inputs.length,
+			createdAt: transcript.updatedAt,
+			updatedAt: transcript.updatedAt,
+			attention
+		};
+		if (attention) scopes.push({
+			collection: "transcripts",
+			by: "attention"
+		});
+	}
+	const parsed = factoryRecordSummarySchema.parse(summary);
+	scopes.push({
+		collection: parsed.collection,
+		by: "all"
+	});
+	if (parsed.collection !== "repositories" && parsed.collection !== "transcripts") for (const repositoryId of new Set(parsed.repositoryIds)) scopes.push({
+		collection: parsed.collection,
+		by: "repository",
+		repositoryId
+	});
+	return scopes.map((scope) => ({
+		index: factoryIndexKey(scope),
+		sortKey: new Date(parsed.createdAt).toISOString(),
+		summary: parsed
+	}));
+}
+//#endregion
+export { factoryIndexKey, factoryIndexScopeSchema, factoryRecordSummarySchema, projectIndexedRecord };
+
+//# sourceMappingURL=indexed-projections.mjs.map

package/dist/store/indexed-projections.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexed-projections.mjs","names":[],"sources":["../../src/store/indexed-projections.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { z } from \"zod\";\nimport { isoDateTimeSchema, replyToSchema } from \"../schema/common\";\nimport { changeSchema, changeStateSchema } from \"../schema/change\";\nimport {\n  changeIdSchema,\n  receiptIdSchema,\n  repositoryIdSchema,\n  signalIdSchema,\n  taskIdSchema,\n} from \"../schema/id\";\nimport { receiptSchema } from \"../schema/receipt\";\nimport { repositorySchema } from \"../schema/repository\";\nimport { agentSessionIdSchema, agentSessionSchema } from \"../schema/session\";\nimport { signalSchema } from \"../schema/signal\";\nimport { executionReferenceSchema, taskSchema, taskStateSchema } from \"../schema/task\";\nimport { transcriptSnapshotSchema } from \"../schema/transcript\";\nimport {\n  sessionContinuationRecordSchema,\n  sessionNotificationRecordSchema,\n} from \"./session-history\";\nimport type { CollectionName } from \"./driver\";\nimport type { StoreIndexEntry } from \"./indexed\";\n\nconst collectionSchema = z.enum([\n  \"repositories\",\n  \"signals\",\n  \"tasks\",\n  \"changes\",\n  \"receipts\",\n  \"sessions\",\n  \"externalSessions\",\n  \"sessionContinuations\",\n  \"sessionNotifications\",\n  \"transcripts\",\n]);\nconst sessionCollections = z.enum([\"sessions\", \"externalSessions\"]);\n\n/** Validates an exact, trusted query scope; transport callers must authorize it before querying. */\nexport const factoryIndexScopeSchema = z.union([\n  z.strictObject({\n    collection: z\n      .enum([\"sessionContinuations\", \"sessionNotifications\"])\n      .describe(\"Paginated session history collection.\"),\n    by: z.literal(\"session\").describe(\"History within an exact session.\"),\n    sessionId: agentSessionIdSchema.describe(\"Session whose history is selected.\"),\n  }),\n  z.strictObject({\n    collection: collectionSchema.describe(\"Source collection to query.\"),\n    by: z.literal(\"all\").describe(\"All records in the namespace's collection.\"),\n  }),\n  z.strictObject({\n    collection: collectionSchema\n      .exclude([\"repositories\", \"transcripts\"])\n      .describe(\"Source collection with repository memberships.\"),\n    by: z.literal(\"repository\").describe(\"Records belonging to the selected repository.\"),\n    repositoryId: repositoryIdSchema.describe(\"Repository membership to query.\"),\n  }),\n  z.strictObject({\n    collection: z.literal(\"tasks\").describe(\"Task source summaries.\"),\n    by: z.literal(\"state\").describe(\"Tasks in one lifecycle state.\"),\n    state: taskStateSchema.describe(\"Exact Task lifecycle state to query.\"),\n    repositoryId: repositoryIdSchema.optional().describe(\"Optional repository membership filter.\"),\n  }),\n  z.strictObject({\n    collection: z.literal(\"changes\").describe(\"Change source summaries.\"),\n    by: z.literal(\"state\").describe(\"Changes in one lifecycle state.\"),\n    state: changeStateSchema.describe(\"Exact Change lifecycle state to query.\"),\n    repositoryId: repositoryIdSchema.optional().describe(\"Optional repository membership filter.\"),\n  }),\n  z.strictObject({\n    collection: z.literal(\"tasks\").describe(\"Task source summaries.\"),\n    by: z.literal(\"root\").describe(\"Tasks in one canonical root graph.\"),\n    rootTaskId: taskIdSchema.describe(\"Root Task identifying the graph.\"),\n  }),\n  z.strictObject({\n    collection: z.literal(\"tasks\").describe(\"Task source summaries.\"),\n    by: z.literal(\"reply\").describe(\"Tasks sharing an exact reply destination.\"),\n    replyTo: replyToSchema.describe(\"Exact reply destination to query.\"),\n  }),\n  z.strictObject({\n    collection: z\n      .enum([\"receipts\", \"changes\", \"sessions\", \"sessionContinuations\"])\n      .describe(\"Task-bound source collection.\"),\n    by: z.literal(\"task\").describe(\"Records bound to one Task.\"),\n    taskId: taskIdSchema.describe(\"Task whose bound records are selected.\"),\n  }),\n  z.strictObject({\n    collection: sessionCollections.describe(\"Internal or external session collection.\"),\n    by: z.literal(\"owner\").describe(\"Sessions belonging to one owner.\"),\n    owner: z.string().min(1).describe(\"Authorized session owner to query.\"),\n    repositoryId: repositoryIdSchema.optional().describe(\"Optional repository membership filter.\"),\n  }),\n  z.strictObject({\n    collection: sessionCollections.describe(\"Internal or external session collection.\"),\n    by: z.literal(\"execution\").describe(\"Sessions bound to an exact provider execution.\"),\n    execution: executionReferenceSchema.describe(\n      \"Execution identity; only provider and sessionId select the scope.\",\n    ),\n  }),\n  z.strictObject({\n    collection: z.enum([\"tasks\", \"changes\"]).describe(\"Source collection requiring attention.\"),\n    by: z.literal(\"attention\").describe(\"Source attention, without conversation deduplication.\"),\n    repositoryId: repositoryIdSchema.optional().describe(\"Optional repository membership filter.\"),\n  }),\n  z.strictObject({\n    collection: z.literal(\"transcripts\").describe(\"Transcript source summaries.\"),\n    by: z.literal(\"attention\").describe(\"Source attention, without conversation deduplication.\"),\n  }),\n]);\n\n/** Exact membership partition selected by the trusted engine or authorized application. */\nexport type FactoryIndexScope = z.infer<typeof factoryIndexScopeSchema>;\n\nconst common = {\n  id: z.string().min(1).describe(\"Canonical source record key.\"),\n  repositoryIds: z\n    .array(repositoryIdSchema)\n    .readonly()\n    .describe(\"Repository memberships; callers must authorize every repository.\"),\n  createdAt: isoDateTimeSchema.describe(\"Source timestamp used to order this summary.\"),\n};\n\n/** Validates compact source summaries, without Task inputs, messages, histories, or transcript bodies. */\nexport const factoryRecordSummarySchema = z.discriminatedUnion(\"collection\", [\n  z.strictObject({\n    ...common,\n    collection: z.literal(\"sessionContinuations\").describe(\"Separate follow-up intent.\"),\n    sessionId: agentSessionIdSchema.describe(\"Owning conversation.\"),\n    taskId: taskIdSchema.describe(\"Task admitted for this follow-up.\"),\n    committed: z.boolean().describe(\"Whether the session head admitted this intent.\"),\n  }),\n  z.strictObject({\n    ...common,\n    collection: z.literal(\"sessionNotifications\").describe(\"Separate delivered notification.\"),\n    sessionId: agentSessionIdSchema.describe(\"Owning conversation.\"),\n    outcome: z.string().describe(\"Notification outcome.\"),\n  }),\n  z.strictObject({\n    ...common,\n    collection: z.literal(\"repositories\").describe(\"Repository source summary.\"),\n    id: repositoryIdSchema.describe(\"Canonical repository ID.\"),\n    slug: z.string().describe(\"Provider repository slug.\"),\n    enabled: z.boolean().describe(\"Whether the repository is enabled for work.\"),\n  }),\n  z.strictObject({\n    ...common,\n    collection: z.literal(\"signals\").describe(\"Signal source summary.\"),\n    id: signalIdSchema.describe(\"Canonical Signal ID.\"),\n    source: z.string().describe(\"Signal source kind.\"),\n    outcome: z.string().describe(\"Recorded triage outcome.\"),\n  }),\n  z.strictObject({\n    ...common,\n    collection: z.literal(\"tasks\").describe(\"Task source summary.\"),\n    title: z.string().max(256).describe(\"Work title without input or history payloads.\"),\n    id: taskIdSchema.describe(\"Canonical Task ID.\"),\n    kind: z.string().describe(\"Descriptive Task kind, not routing authority.\"),\n    state: taskStateSchema.describe(\"Current Task lifecycle state.\"),\n    rootTaskId: taskIdSchema.describe(\"Root of the canonical Task graph.\"),\n    parentTaskId: taskIdSchema.optional().describe(\"Immediate parent Task when present.\"),\n    attempt: z.number().int().positive().describe(\"Current Task execution attempt.\"),\n    changeId: changeIdSchema.optional().describe(\"Associated Change when present.\"),\n    route: z\n      .object({\n        id: z.string().describe(\"Exact registered agent route ID.\"),\n        version: z.number().describe(\"Exact registered agent route version.\"),\n      })\n      .optional()\n      .describe(\"Persisted agent route when the Task uses one.\"),\n    approval: z.enum([\"required\", \"granted\", \"denied\"]).optional().describe(\"Task approval state.\"),\n    updatedAt: isoDateTimeSchema.describe(\"Latest canonical Task update.\"),\n    attention: z\n      .enum([\"question\", \"failed\", \"stalled\", \"approval\"])\n      .optional()\n      .describe(\"Task attention reason; not a deduplicated conversation decision.\"),\n  }),\n  z.strictObject({\n    ...common,\n    collection: z.literal(\"changes\").describe(\"Change source summary.\"),\n    id: changeIdSchema.describe(\"Canonical Change ID.\"),\n    state: changeStateSchema.describe(\"Current Change lifecycle state.\"),\n    taskId: taskIdSchema.optional().describe(\"Task that created the Change, when present.\"),\n    prNumber: z.number().int().positive().describe(\"Repository-local pull request number.\"),\n    updatedAt: isoDateTimeSchema.describe(\"Latest canonical Change update.\"),\n    attention: z.literal(\"review\").optional().describe(\"The Change is ready for review.\"),\n  }),\n  z.strictObject({\n    ...common,\n    collection: z.literal(\"receipts\").describe(\"Receipt source summary.\"),\n    id: receiptIdSchema.describe(\"Immutable receipt ID.\"),\n    taskId: taskIdSchema.optional().describe(\"Task evidenced by this receipt, when present.\"),\n    changeId: changeIdSchema.optional().describe(\"Associated Change when present.\"),\n    kind: z.string().describe(\"Receipt evidence kind.\"),\n    state: z.string().describe(\"State recorded by the receipt.\"),\n    attempt: z.number().int().positive().describe(\"Attempt recorded by the receipt.\"),\n  }),\n  z.strictObject({\n    ...common,\n    collection: z.literal(\"sessions\").describe(\"Internal session source summary.\"),\n    id: agentSessionIdSchema.describe(\"Canonical session ID.\"),\n    owner: z.string().describe(\"Session owner used for access scoping.\"),\n    title: z.string().max(256).describe(\"Bounded display title from the initial message.\"),\n    agent: z.string().describe(\"Agent selected when the session was admitted.\"),\n    taskId: taskIdSchema.optional().describe(\"Task bound to the session, when present.\"),\n    attached: z.boolean().describe(\"Whether the session is attached to existing work.\"),\n    execution: executionReferenceSchema\n      .optional()\n      .describe(\"Bound provider execution, when present.\"),\n  }),\n  z.strictObject({\n    ...common,\n    collection: z.literal(\"externalSessions\").describe(\"External session source summary.\"),\n    id: agentSessionIdSchema.describe(\"Canonical external session ID.\"),\n    owner: z.string().describe(\"Session owner used for access scoping.\"),\n    title: z.string().max(256).describe(\"Bounded display title from the initial message.\"),\n    agent: z.string().describe(\"Agent selected for the external session.\"),\n    execution: executionReferenceSchema.describe(\"Bound provider execution.\"),\n    source: z.string().describe(\"External reply channel.\"),\n  }),\n  z.strictObject({\n    ...common,\n    collection: z.literal(\"transcripts\").describe(\"Transcript source summary.\"),\n    execution: executionReferenceSchema.describe(\"Execution that owns the transcript.\"),\n    state: transcriptSnapshotSchema.unwrap().shape.state.describe(\"Provider conversation state.\"),\n    cursor: z.number().int().nonnegative().describe(\"Latest persisted transcript cursor.\"),\n    inputCount: z.number().int().nonnegative().describe(\"Number of transcript input descriptors.\"),\n    updatedAt: isoDateTimeSchema.describe(\"Latest persisted transcript update.\"),\n    attention: z\n      .enum([\"failed\", \"conversation\"])\n      .optional()\n      .describe(\"Transcript attention reason; not an internal session's attention decision.\"),\n  }),\n]);\n\n/** Compact, discriminated source entity projection returned by indexed engine queries. */\nexport type FactoryRecordSummary = z.infer<typeof factoryRecordSummarySchema>;\n\nfunction hash(value: unknown): string {\n  return createHash(\"sha256\").update(JSON.stringify(value)).digest(\"hex\");\n}\n\nexport function factoryIndexKey(input: FactoryIndexScope): string {\n  let scope = factoryIndexScopeSchema.parse(input);\n  if (scope.by === \"execution\")\n    scope = {\n      ...scope,\n      execution: { provider: scope.execution.provider, sessionId: scope.execution.sessionId },\n    };\n  // Zod emits fields in schema order; caller object insertion order cannot change a query partition.\n  return `factory:v1:${scope.collection}:${scope.by}:${hash(scope)}`;\n}\n\nexport function projectIndexedRecord(\n  collection: CollectionName,\n  id: string,\n  value: unknown,\n): StoreIndexEntry[] {\n  if (!collectionSchema.safeParse(collection).success) return [];\n  const scopes: FactoryIndexScope[] = [];\n  let summary: FactoryRecordSummary;\n  if (collection === \"sessionContinuations\") {\n    const record = sessionContinuationRecordSchema.parse(value);\n    if (record.id !== id) throw new Error(\"Continuation storage key mismatch\");\n    summary = {\n      collection,\n      id,\n      repositoryIds: [],\n      createdAt: record.createdAt,\n      sessionId: record.sessionId,\n      taskId: record.continuation.taskId,\n      committed: record.committed,\n    };\n    scopes.push(\n      { collection, by: \"session\", sessionId: record.sessionId },\n      { collection, by: \"task\", taskId: record.continuation.taskId },\n    );\n  } else if (collection === \"sessionNotifications\") {\n    const record = sessionNotificationRecordSchema.parse(value);\n    if (record.id !== id) throw new Error(\"Notification storage key mismatch\");\n    summary = {\n      collection,\n      id,\n      repositoryIds: record.event.repositoryIds,\n      createdAt: record.createdAt,\n      sessionId: record.sessionId,\n      outcome: record.event.outcome,\n    };\n    scopes.push({ collection, by: \"session\", sessionId: record.sessionId });\n  } else if (collection === \"tasks\") {\n    const task = taskSchema.parse(value);\n    if (task.id !== id) throw new Error(\"Task storage key mismatch\");\n    const attention =\n      task.state === \"needs_human\"\n        ? \"question\"\n        : task.state === \"failed\" || task.state === \"stalled\"\n          ? task.state\n          : task.state === \"queued\" && task.approval === \"required\"\n            ? \"approval\"\n            : undefined;\n    summary = {\n      collection,\n      id: task.id,\n      repositoryIds: task.repositoryIds,\n      title: task.work.title,\n      kind: task.kind,\n      state: task.state,\n      rootTaskId: task.rootTaskId,\n      parentTaskId: task.parentTaskId,\n      attempt: task.attempt,\n      changeId: task.changeId,\n      route: task.work.route,\n      approval: task.approval,\n      createdAt: task.createdAt,\n      updatedAt: task.updatedAt,\n      attention,\n    };\n    scopes.push(\n      { collection, by: \"state\", state: task.state },\n      { collection, by: \"root\", rootTaskId: task.rootTaskId },\n      { collection, by: \"reply\", replyTo: task.replyTo },\n    );\n    for (const repositoryId of new Set(task.repositoryIds))\n      scopes.push({ collection, by: \"state\", state: task.state, repositoryId });\n    if (attention) {\n      scopes.push({ collection, by: \"attention\" });\n      for (const repositoryId of new Set(task.repositoryIds))\n        scopes.push({ collection, by: \"attention\", repositoryId });\n    }\n  } else if (collection === \"sessions\" || collection === \"externalSessions\") {\n    const session = agentSessionSchema.parse(value);\n    if (\n      session.id !== id ||\n      (collection === \"externalSessions\") !== (session.external !== undefined)\n    )\n      throw new Error(\"Session storage key or collection mismatch\");\n    const base = {\n      id: session.id,\n      repositoryIds:\n        session.external?.repositoryIds ?? (session.repositoryId ? [session.repositoryId] : []),\n      owner: session.owner,\n      title: session.message.slice(0, 256).replace(/[\\uD800-\\uDBFF]$/u, \"\"),\n      agent: session.agent,\n      createdAt: session.createdAt,\n    };\n    summary =\n      collection === \"externalSessions\" && session.external && session.execution\n        ? {\n            ...base,\n            collection,\n            execution: session.execution,\n            source: session.external.replyTo.channel,\n          }\n        : {\n            ...base,\n            collection: \"sessions\",\n            taskId: session.taskId,\n            attached: session.attached ?? false,\n            execution: session.execution,\n          };\n    scopes.push({ collection, by: \"owner\", owner: session.owner });\n    for (const repositoryId of new Set(base.repositoryIds))\n      scopes.push({ collection, by: \"owner\", owner: session.owner, repositoryId });\n    if (session.execution)\n      scopes.push({ collection, by: \"execution\", execution: session.execution });\n    if (collection === \"sessions\" && session.taskId)\n      scopes.push({ collection, by: \"task\", taskId: session.taskId });\n  } else if (collection === \"changes\") {\n    const change = changeSchema.parse(value);\n    if (change.id !== id) throw new Error(\"Change storage key mismatch\");\n    summary = {\n      collection,\n      id: change.id,\n      repositoryIds: [change.repositoryId],\n      state: change.state,\n      taskId: change.taskId,\n      prNumber: change.prNumber,\n      createdAt: change.createdAt,\n      updatedAt: change.updatedAt,\n      attention: change.state === \"ready\" ? \"review\" : undefined,\n    };\n    scopes.push(\n      { collection, by: \"state\", state: change.state },\n      { collection, by: \"state\", state: change.state, repositoryId: change.repositoryId },\n    );\n    if (change.taskId) scopes.push({ collection, by: \"task\", taskId: change.taskId });\n    if (change.state === \"ready\")\n      scopes.push(\n        { collection, by: \"attention\" },\n        { collection, by: \"attention\", repositoryId: change.repositoryId },\n      );\n  } else if (collection === \"receipts\") {\n    const receipt = receiptSchema.parse(value);\n    if (receipt.receiptId !== id) throw new Error(\"Receipt storage key mismatch\");\n    summary = {\n      collection,\n      id: receipt.receiptId,\n      repositoryIds: receipt.repositoryIds,\n      taskId: receipt.taskId,\n      changeId: receipt.changeId,\n      kind: receipt.kind,\n      state: receipt.state,\n      attempt: receipt.attempt,\n      createdAt: receipt.recordedAt,\n    };\n    if (receipt.taskId) scopes.push({ collection, by: \"task\", taskId: receipt.taskId });\n  } else if (collection === \"signals\") {\n    const signal = signalSchema.parse(value);\n    if (signal.id !== id) throw new Error(\"Signal storage key mismatch\");\n    summary = {\n      collection,\n      id: signal.id,\n      repositoryIds: [signal.repositoryId],\n      source: signal.source,\n      outcome: signal.outcome,\n      createdAt: signal.receivedAt,\n    };\n  } else if (collection === \"repositories\") {\n    const repository = repositorySchema.parse(value);\n    if (repository.id !== id) throw new Error(\"Repository storage key mismatch\");\n    summary = {\n      collection,\n      id: repository.id,\n      repositoryIds: [repository.id],\n      slug: repository.slug,\n      enabled: repository.enabled,\n      createdAt: repository.connectedAt,\n    };\n  } else {\n    const transcript = z\n      .object({\n        execution: executionReferenceSchema,\n        snapshot: transcriptSnapshotSchema,\n        updatedAt: isoDateTimeSchema,\n      })\n      .parse(value);\n    const attention =\n      transcript.snapshot.state === \"failed\"\n        ? \"failed\"\n        : transcript.snapshot.state === \"waiting\" || transcript.snapshot.state === \"needs input\"\n          ? \"conversation\"\n          : undefined;\n    summary = {\n      collection: \"transcripts\",\n      id,\n      repositoryIds: [],\n      execution: transcript.execution,\n      state: transcript.snapshot.state,\n      cursor: transcript.snapshot.cursor,\n      inputCount: transcript.snapshot.inputs.length,\n      createdAt: transcript.updatedAt,\n      updatedAt: transcript.updatedAt,\n      attention,\n    };\n    if (attention) scopes.push({ collection: \"transcripts\", by: \"attention\" });\n  }\n  const parsed = factoryRecordSummarySchema.parse(summary);\n  scopes.push({ collection: parsed.collection, by: \"all\" });\n  if (parsed.collection !== \"repositories\" && parsed.collection !== \"transcripts\") {\n    for (const repositoryId of new Set(parsed.repositoryIds))\n      scopes.push({ collection: parsed.collection, by: \"repository\", repositoryId });\n  }\n  return scopes.map((scope) => ({\n    index: factoryIndexKey(scope),\n    sortKey: new Date(parsed.createdAt).toISOString(),\n    summary: parsed,\n  }));\n}\n"],"mappings":"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"}

package/dist/store/indexed.d.mts

@@ -0,0 +1,101 @@
+import { FactoryRecordQuery } from "./query.mjs";
+import { CollectionName, StoredRecord } from "./driver.mjs";
+//#region src/store/indexed.d.ts
+/** One compact, ordered membership in an application-defined query index. */
+interface StoreIndexEntry {
+  /** Exact query partition, including the authorized workspace or owner scope. */
+  readonly index: string;
+  /** Lexically ordered key, such as an ISO creation timestamp. IDs break ties. */
+  readonly sortKey: string;
+  /** Small display projection; keep Task inputs, outputs, and transcript bodies out. */
+  readonly summary: unknown;
+  /** Optional engine-owned facet group; each record contributes once per distinct facet. */
+  readonly countGroup?: {
+    readonly group: string;
+    readonly attributes: unknown;
+  };
+}
+/** Atomic replacement of a record and its complete set of index memberships. */
+interface WriteIndexedRecordInput {
+  readonly collection: CollectionName;
+  readonly id: string;
+  /** Durable retry identity. Reuse only for the identical write intent. */
+  readonly operationId: string;
+  /** Zero inserts a new record; a positive version replaces that exact snapshot. */
+  readonly expectedVersion: number;
+  /** Engine-validated canonical JSON. Storage does not decide lifecycle policy. */
+  readonly value: unknown;
+  /** Complete replacement, including an empty array when removing all memberships. */
+  readonly indexes: readonly StoreIndexEntry[];
+}
+/** Committed version returned both for a new write and a durable idempotent replay. */
+interface WriteIndexedRecordResult {
+  readonly version: number;
+}
+/** One bounded page from an exact index partition; filtering must be encoded in the index. */
+interface QueryStoreIndexInput {
+  readonly index: string;
+  /** Required page bound, from 1 through 100. */
+  readonly limit: number;
+  /** Opaque continuation from the same index and ordering. */
+  readonly cursor?: string;
+  /** Defaults to descending order for newest-first listings. */
+  readonly order?: "asc" | "desc";
+}
+/** Compact index result with the source record identity and committed version. */
+interface StoreIndexRecord extends StoreIndexEntry {
+  readonly collection: CollectionName;
+  readonly id: string;
+  readonly version: number;
+}
+/** A bounded summary page and an opaque continuation when more results may remain. */
+interface QueryStoreIndexResult {
+  readonly entries: readonly StoreIndexRecord[];
+  readonly nextCursor: string | null;
+}
+/** Bounded canonical records selected through a source index and indexed JSON containment. */
+interface QueryStoreRecordsInput extends FactoryRecordQuery {
+  readonly sources: readonly {
+    readonly collection: CollectionName;
+    readonly index: string;
+  }[];
+}
+/** Versioned canonical page returned for background work and explicit record inspection. */
+interface QueryStoreRecordsResult {
+  readonly totalCount?: number;
+  readonly entries: readonly {
+    readonly collection: CollectionName;
+    readonly id: string;
+    readonly record: StoredRecord;
+  }[];
+  readonly nextCursor: string | null;
+}
+/**
+ * Bounded persistence for new indexed consumers. Deliberately separate from StoreDriver:
+ * it has no list/scan operation and cannot back the catalog-based engine unchanged.
+ * Callers own schema validation, authorization, lifecycle rules, and index selection.
+ */
+interface IndexedStore {
+  readonly name: string;
+  /**
+   * Commit engine-owned related writes together under serializable isolation.
+   * The callback can repeat after serialization failures and must contain only storage operations.
+   * Retain operation IDs when retrying an uncertain result; external effects belong after commit.
+   */
+  transaction<T>(run: (transaction: IndexedStore) => Promise<T>): Promise<T>;
+  get(collection: CollectionName, id: string): Promise<StoredRecord | null>;
+  write(input: WriteIndexedRecordInput): Promise<WriteIndexedRecordResult>;
+  query(input: QueryStoreIndexInput): Promise<QueryStoreIndexResult>;
+  queryRecords(input: QueryStoreRecordsInput): Promise<QueryStoreRecordsResult>;
+  /** Strongly consistent maintained membership count; never counts by querying items. */
+  count(index: string): Promise<number>;
+  /** Sums maintained facet counts, never canonical records. */
+  sumCounts(group: string, query: Pick<FactoryRecordQuery, "match" | "fields">): Promise<number>;
+}
+/** A durable operation identity was reused for a different mutation. */
+declare class StoreOperationConflictError extends Error {
+  constructor(operationId: string);
+}
+//#endregion
+export { IndexedStore, QueryStoreIndexInput, QueryStoreIndexResult, QueryStoreRecordsInput, QueryStoreRecordsResult, StoreIndexEntry, StoreIndexRecord, StoreOperationConflictError, WriteIndexedRecordInput, WriteIndexedRecordResult };
+//# sourceMappingURL=indexed.d.mts.map