effect-agent 0.1.0-beta.12 → 0.1.0-beta.121

package/dist/core/Usage.mjs

@@ -0,0 +1,319 @@
+import { t as __exportAll } from "../rolldown-runtime-D7D4PA-g.mjs";
+import { RunId } from "./Identifiers.mjs";
+import { Effect, Schema } from "effect";
+//#region src/core/Usage.ts
+var Usage_exports = /* @__PURE__ */ __exportAll({
+	ChildRunUsage: () => ChildRunUsage,
+	InputTokenUsage: () => InputTokenUsage,
+	ModelCallUsage: () => ModelCallUsage,
+	ModelResponseIdentity: () => ModelResponseIdentity,
+	ModelUsageGroup: () => ModelUsageGroup,
+	OutputTokenUsage: () => OutputTokenUsage,
+	RunTotals: () => RunTotals,
+	RunUsageReport: () => RunUsageReport,
+	RunUsageSummary: () => RunUsageSummary,
+	UsageAggregationError: () => UsageAggregationError,
+	UsageCompleteness: () => UsageCompleteness,
+	emptyRunTotals: () => emptyRunTotals,
+	runTotalsFromSummary: () => runTotalsFromSummary,
+	sumRunTotals: () => sumRunTotals,
+	summarizeModelUsage: () => summarizeModelUsage,
+	unknownRunTotals: () => unknownRunTotals
+});
+const UsageIdentity = Schema.NonEmptyString.check(Schema.isMaxLength(256));
+/** Bounded provider response identity. Request configuration is not response evidence. */
+var ModelResponseIdentity = class extends Schema.Class("@effect-agent/core/ModelResponseIdentity")({
+	id: Schema.optionalKey(UsageIdentity),
+	model: Schema.optionalKey(UsageIdentity)
+}) {};
+/** Missing legacy status means unknown, never a free call or a complete report. */
+const UsageCompleteness = Schema.Literals([
+	"complete",
+	"partial",
+	"unknown"
+]);
+const hasAdditiveTotal = (total, components) => {
+	const sum = components.reduce((accumulator, component) => accumulator + component, 0);
+	return Number.isSafeInteger(sum) && total === sum;
+};
+const InputTokenUsageFields = Schema.Struct({
+	total: Schema.Natural,
+	uncached: Schema.Natural,
+	cacheRead: Schema.Natural,
+	cacheWrite: Schema.Natural
+}).check(Schema.makeFilter((usage) => hasAdditiveTotal(usage.total, [
+	usage.uncached,
+	usage.cacheRead,
+	usage.cacheWrite
+]), { title: "Input token total equals uncached, cache-read, and cache-write components" }));
+/** Provider-reported input-token components for one completed model call. */
+var InputTokenUsage = class extends Schema.Class("@effect-agent/core/InputTokenUsage")(InputTokenUsageFields) {};
+const OutputTokenUsageFields = Schema.Struct({
+	total: Schema.Natural,
+	text: Schema.Natural,
+	reasoning: Schema.Natural
+}).check(Schema.makeFilter((usage) => hasAdditiveTotal(usage.total, [usage.text, usage.reasoning]), { title: "Output token total equals text and reasoning components" }));
+/** Provider-reported output-token components for one completed model call. */
+var OutputTokenUsage = class extends Schema.Class("@effect-agent/core/OutputTokenUsage")(OutputTokenUsageFields) {};
+/** Canonical, provider-independent accounting for one completed model call. */
+var ModelCallUsage = class extends Schema.Class("@effect-agent/core/ModelCallUsage")({
+	provider: UsageIdentity,
+	/** Configured binding identity. See response.model for provider-reported identity. */
+	model: UsageIdentity,
+	serviceTier: Schema.optionalKey(UsageIdentity),
+	pricingVersion: Schema.optionalKey(UsageIdentity),
+	response: Schema.optionalKey(ModelResponseIdentity),
+	purpose: Schema.optionalKey(Schema.Literals(["turn", "summary"])),
+	usageStatus: Schema.optionalKey(UsageCompleteness),
+	pricingStatus: Schema.optionalKey(Schema.Literals(["estimated", "unknown"])),
+	inputTokens: InputTokenUsage,
+	outputTokens: OutputTokenUsage,
+	costMicrousd: Schema.Natural
+}) {};
+/**
+* Observed model usage and estimated cost, without per-model attribution.
+* Numeric zero with unknown coverage never establishes free execution. Missing legacy
+* statuses mean unknown. Unobserved calls are excluded from the numeric call/token totals.
+*/
+var RunTotals = class extends Schema.Class("@effect-agent/core/RunTotals")({
+	modelCalls: Schema.Natural,
+	inputTokens: Schema.Natural,
+	outputTokens: Schema.Natural,
+	costMicrousd: Schema.Natural,
+	usageStatus: Schema.optionalKey(UsageCompleteness),
+	pricingStatus: Schema.optionalKey(UsageCompleteness),
+	unobservedModelCalls: Schema.optionalKey(Schema.Natural)
+}) {};
+/** Own Run usage and disjoint attached-descendant usage. Add each component once. */
+var RunUsageReport = class extends Schema.Class("@effect-agent/core/RunUsageReport")({
+	usage: RunTotals,
+	delegatedUsage: RunTotals
+}) {};
+/** A verified child report retained across durable parent Attempts. */
+var ChildRunUsage = class extends Schema.Class("@effect-agent/core/ChildRunUsage")({
+	runId: RunId,
+	report: RunUsageReport
+}) {};
+/** Known absence of observed work. */
+const emptyRunTotals = () => RunTotals.make({
+	modelCalls: 0,
+	inputTokens: 0,
+	outputTokens: 0,
+	costMicrousd: 0,
+	usageStatus: "complete",
+	pricingStatus: "complete",
+	unobservedModelCalls: 0
+});
+/** No accounting evidence, including legacy child reports. This is not known zero spend. */
+const unknownRunTotals = () => RunTotals.make({
+	...emptyRunTotals(),
+	usageStatus: "unknown",
+	pricingStatus: "unknown"
+});
+/** Settlement-sized aggregate for calls sharing one pricing identity. */
+var ModelUsageGroup = class extends Schema.Class("@effect-agent/core/ModelUsageGroup")({
+	provider: UsageIdentity,
+	model: UsageIdentity,
+	/** Actual returned model; absent when only the configured binding is known. */
+	responseModel: Schema.optionalKey(UsageIdentity),
+	serviceTier: Schema.optionalKey(UsageIdentity),
+	pricingVersion: Schema.optionalKey(UsageIdentity),
+	modelCalls: Schema.Natural.check(Schema.isGreaterThan(0)),
+	inputTokens: InputTokenUsage,
+	outputTokens: OutputTokenUsage,
+	costMicrousd: Schema.Natural
+}) {};
+const RunUsageSummaryFields = Schema.Struct({
+	modelCalls: Schema.Natural,
+	inputTokens: InputTokenUsage,
+	outputTokens: OutputTokenUsage,
+	costMicrousd: Schema.Natural,
+	byModel: Schema.Array(ModelUsageGroup),
+	/** Coverage of recorded calls only; interruptions can make the Run less complete. */
+	usageStatus: Schema.optionalKey(UsageCompleteness),
+	pricingStatus: Schema.optionalKey(UsageCompleteness),
+	/** Observed invocations without retained accounting, excluded from numeric call/token totals. */
+	unobservedModelCalls: Schema.optionalKey(Schema.Natural)
+}).check(Schema.makeFilter((summary) => {
+	const identities = summary.byModel.map((group) => JSON.stringify([
+		group.provider,
+		group.model,
+		group.responseModel ?? null,
+		group.serviceTier ?? null,
+		group.pricingVersion ?? null
+	]));
+	return new Set(identities).size === identities.length && hasAdditiveTotal(summary.modelCalls, summary.byModel.map((group) => group.modelCalls)) && hasAdditiveTotal(summary.inputTokens.total, summary.byModel.map((group) => group.inputTokens.total)) && hasAdditiveTotal(summary.inputTokens.uncached, summary.byModel.map((group) => group.inputTokens.uncached)) && hasAdditiveTotal(summary.inputTokens.cacheRead, summary.byModel.map((group) => group.inputTokens.cacheRead)) && hasAdditiveTotal(summary.inputTokens.cacheWrite, summary.byModel.map((group) => group.inputTokens.cacheWrite)) && hasAdditiveTotal(summary.outputTokens.total, summary.byModel.map((group) => group.outputTokens.total)) && hasAdditiveTotal(summary.outputTokens.text, summary.byModel.map((group) => group.outputTokens.text)) && hasAdditiveTotal(summary.outputTokens.reasoning, summary.byModel.map((group) => group.outputTokens.reasoning)) && hasAdditiveTotal(summary.costMicrousd, summary.byModel.map((group) => group.costMicrousd));
+}, { title: "Run usage totals equal unique per-model pricing groups within safe-integer accounting" }));
+/** Settlement aggregate included with a terminal Run settlement. */
+var RunUsageSummary = class extends Schema.Class("@effect-agent/core/RunUsageSummary")(RunUsageSummaryFields) {};
+const emptyInputTokens = () => ({
+	total: 0,
+	uncached: 0,
+	cacheRead: 0,
+	cacheWrite: 0
+});
+const emptyOutputTokens = () => ({
+	total: 0,
+	text: 0,
+	reasoning: 0
+});
+/** Canonical usage could not be aggregated without exceeding safe-integer accounting. */
+var UsageAggregationError = class extends Schema.TaggedError()("UsageAggregationError", {
+	field: Schema.NonEmptyString,
+	message: Schema.String
+}) {};
+const checkedAdd = (field, left, right) => {
+	const total = left + right;
+	return Number.isSafeInteger(left) && left >= 0 && Number.isSafeInteger(right) && right >= 0 && Number.isSafeInteger(total) ? Effect.succeed(total) : Effect.fail(UsageAggregationError.make({
+		field,
+		message: `Canonical usage aggregation exceeded the safe-integer range at ${field}`
+	}));
+};
+/** Combine disjoint totals, retaining uncertainty and rejecting numeric overflow. */
+const sumRunTotals = Effect.fn("sumRunTotals")(function* (contributions) {
+	let modelCalls = 0;
+	let inputTokens = 0;
+	let outputTokens = 0;
+	let costMicrousd = 0;
+	let unobservedModelCalls = 0;
+	const usageStatuses = [];
+	const pricingStatuses = [];
+	for (const contribution of contributions) {
+		const value = yield* Schema.decodeEffect(RunTotals)(contribution).pipe(Effect.mapError(() => new UsageAggregationError({
+			field: "totals",
+			message: "Invalid Run totals"
+		})));
+		modelCalls = yield* checkedAdd("modelCalls", modelCalls, value.modelCalls);
+		inputTokens = yield* checkedAdd("inputTokens", inputTokens, value.inputTokens);
+		outputTokens = yield* checkedAdd("outputTokens", outputTokens, value.outputTokens);
+		costMicrousd = yield* checkedAdd("costMicrousd", costMicrousd, value.costMicrousd);
+		unobservedModelCalls = yield* checkedAdd("unobservedModelCalls", unobservedModelCalls, value.unobservedModelCalls ?? 0);
+		if (value.modelCalls > 0 || (value.unobservedModelCalls ?? 0) > 0 || value.usageStatus !== "complete") usageStatuses.push(value.usageStatus ?? "unknown");
+		if (value.modelCalls > 0 || (value.unobservedModelCalls ?? 0) > 0 || value.pricingStatus !== "complete") pricingStatuses.push(value.pricingStatus ?? "unknown");
+	}
+	const coverage = (statuses) => statuses.every((status) => status === "complete") ? "complete" : statuses.every((status) => status === "unknown") ? "unknown" : "partial";
+	return RunTotals.make({
+		modelCalls,
+		inputTokens,
+		outputTokens,
+		costMicrousd,
+		unobservedModelCalls,
+		usageStatus: coverage(usageStatuses),
+		pricingStatus: coverage(pricingStatuses)
+	});
+});
+/** Flatten a canonical settlement summary without discarding its coverage markers. */
+const runTotalsFromSummary = (summary) => RunTotals.make({
+	modelCalls: summary.modelCalls,
+	inputTokens: summary.inputTokens.total,
+	outputTokens: summary.outputTokens.total,
+	costMicrousd: summary.costMicrousd,
+	usageStatus: summary.usageStatus ?? "unknown",
+	pricingStatus: summary.pricingStatus ?? "unknown",
+	unobservedModelCalls: summary.unobservedModelCalls ?? 0
+});
+/**
+* Deterministically aggregate canonical per-call usage without making cached tokens free.
+* A validated seed retains earlier call totals and pricing groups without retaining those calls.
+* Empty contributions do not change completeness; the seed is never mutated.
+*/
+const summarizeModelUsage = Effect.fn("summarizeModelUsage")(function* (calls, seed) {
+	const initial = seed === void 0 ? void 0 : yield* Schema.decodeEffect(RunUsageSummary)(seed).pipe(Effect.mapError(() => new UsageAggregationError({
+		field: "seed",
+		message: "Canonical usage seed does not satisfy the RunUsageSummary Schema"
+	})));
+	const inputTokens = initial === void 0 ? emptyInputTokens() : { ...initial.inputTokens };
+	const outputTokens = initial === void 0 ? emptyOutputTokens() : { ...initial.outputTokens };
+	const groups = /* @__PURE__ */ new Map();
+	let modelCalls = initial?.modelCalls ?? 0;
+	let costMicrousd = initial?.costMicrousd ?? 0;
+	const hasSeedCalls = modelCalls > 0;
+	let allUsageUnknown = !hasSeedCalls || initial?.usageStatus === void 0 || initial.usageStatus === "unknown";
+	let allUsageComplete = !hasSeedCalls || initial?.usageStatus === "complete";
+	let allPricingUnknown = !hasSeedCalls || initial?.pricingStatus === void 0 || initial.pricingStatus === "unknown";
+	let allPricingComplete = !hasSeedCalls || initial?.pricingStatus === "complete";
+	for (const group of initial?.byModel ?? []) {
+		const key = JSON.stringify([
+			group.provider,
+			group.model,
+			group.responseModel ?? null,
+			group.serviceTier ?? null,
+			group.pricingVersion ?? null
+		]);
+		groups.set(key, {
+			...group,
+			inputTokens: { ...group.inputTokens },
+			outputTokens: { ...group.outputTokens }
+		});
+	}
+	for (const call of calls) {
+		allUsageUnknown &&= call.usageStatus === void 0 || call.usageStatus === "unknown";
+		allUsageComplete &&= call.usageStatus === "complete";
+		allPricingUnknown &&= call.pricingStatus !== "estimated";
+		allPricingComplete &&= call.pricingStatus === "estimated";
+		modelCalls = yield* checkedAdd("modelCalls", modelCalls, 1);
+		inputTokens.total = yield* checkedAdd("inputTokens.total", inputTokens.total, call.inputTokens.total);
+		inputTokens.uncached = yield* checkedAdd("inputTokens.uncached", inputTokens.uncached, call.inputTokens.uncached);
+		inputTokens.cacheRead = yield* checkedAdd("inputTokens.cacheRead", inputTokens.cacheRead, call.inputTokens.cacheRead);
+		inputTokens.cacheWrite = yield* checkedAdd("inputTokens.cacheWrite", inputTokens.cacheWrite, call.inputTokens.cacheWrite);
+		outputTokens.total = yield* checkedAdd("outputTokens.total", outputTokens.total, call.outputTokens.total);
+		outputTokens.text = yield* checkedAdd("outputTokens.text", outputTokens.text, call.outputTokens.text);
+		outputTokens.reasoning = yield* checkedAdd("outputTokens.reasoning", outputTokens.reasoning, call.outputTokens.reasoning);
+		costMicrousd = yield* checkedAdd("costMicrousd", costMicrousd, call.costMicrousd);
+		const key = JSON.stringify([
+			call.provider,
+			call.model,
+			call.response?.model ?? null,
+			call.serviceTier ?? null,
+			call.pricingVersion ?? null
+		]);
+		let group = groups.get(key);
+		if (group === void 0) {
+			group = {
+				provider: call.provider,
+				model: call.model,
+				...call.response?.model === void 0 ? {} : { responseModel: call.response.model },
+				...call.serviceTier === void 0 ? {} : { serviceTier: call.serviceTier },
+				...call.pricingVersion === void 0 ? {} : { pricingVersion: call.pricingVersion },
+				modelCalls: 0,
+				inputTokens: emptyInputTokens(),
+				outputTokens: emptyOutputTokens(),
+				costMicrousd: 0
+			};
+			groups.set(key, group);
+		}
+		group.modelCalls = yield* checkedAdd("byModel.modelCalls", group.modelCalls, 1);
+		group.inputTokens.total = yield* checkedAdd("byModel.inputTokens.total", group.inputTokens.total, call.inputTokens.total);
+		group.inputTokens.uncached = yield* checkedAdd("byModel.inputTokens.uncached", group.inputTokens.uncached, call.inputTokens.uncached);
+		group.inputTokens.cacheRead = yield* checkedAdd("byModel.inputTokens.cacheRead", group.inputTokens.cacheRead, call.inputTokens.cacheRead);
+		group.inputTokens.cacheWrite = yield* checkedAdd("byModel.inputTokens.cacheWrite", group.inputTokens.cacheWrite, call.inputTokens.cacheWrite);
+		group.outputTokens.total = yield* checkedAdd("byModel.outputTokens.total", group.outputTokens.total, call.outputTokens.total);
+		group.outputTokens.text = yield* checkedAdd("byModel.outputTokens.text", group.outputTokens.text, call.outputTokens.text);
+		group.outputTokens.reasoning = yield* checkedAdd("byModel.outputTokens.reasoning", group.outputTokens.reasoning, call.outputTokens.reasoning);
+		group.costMicrousd = yield* checkedAdd("byModel.costMicrousd", group.costMicrousd, call.costMicrousd);
+	}
+	return RunUsageSummary.make({
+		modelCalls,
+		inputTokens: InputTokenUsage.make(inputTokens),
+		outputTokens: OutputTokenUsage.make(outputTokens),
+		costMicrousd,
+		usageStatus: allUsageUnknown ? "unknown" : allUsageComplete ? "complete" : "partial",
+		pricingStatus: allPricingUnknown ? "unknown" : allPricingComplete ? "complete" : "partial",
+		...initial?.unobservedModelCalls === void 0 ? {} : { unobservedModelCalls: initial.unobservedModelCalls },
+		byModel: [...groups.values()].map((group) => ModelUsageGroup.make({
+			provider: group.provider,
+			model: group.model,
+			...group.responseModel === void 0 ? {} : { responseModel: group.responseModel },
+			...group.serviceTier === void 0 ? {} : { serviceTier: group.serviceTier },
+			...group.pricingVersion === void 0 ? {} : { pricingVersion: group.pricingVersion },
+			modelCalls: group.modelCalls,
+			inputTokens: InputTokenUsage.make(group.inputTokens),
+			outputTokens: OutputTokenUsage.make(group.outputTokens),
+			costMicrousd: group.costMicrousd
+		}))
+	});
+});
+//#endregion
+export { ChildRunUsage, InputTokenUsage, ModelCallUsage, ModelResponseIdentity, ModelUsageGroup, OutputTokenUsage, RunTotals, RunUsageReport, RunUsageSummary, UsageAggregationError, UsageCompleteness, emptyRunTotals, runTotalsFromSummary, sumRunTotals, summarizeModelUsage, Usage_exports as t, unknownRunTotals };
+
+//# sourceMappingURL=Usage.mjs.map

package/dist/core/Usage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Usage.mjs","names":[],"sources":["../../src/core/Usage.ts"],"sourcesContent":["import { Effect, Schema } from \"effect\";\n\nimport { RunId } from \"./Identifiers.ts\";\n\nconst UsageIdentity = Schema.NonEmptyString.check(Schema.isMaxLength(256));\n\n/** Bounded provider response identity. Request configuration is not response evidence. */\nexport class ModelResponseIdentity extends Schema.Class<ModelResponseIdentity>(\n  \"@effect-agent/core/ModelResponseIdentity\",\n)({\n  id: Schema.optionalKey(UsageIdentity),\n  model: Schema.optionalKey(UsageIdentity),\n}) {}\n\n/** Missing legacy status means unknown, never a free call or a complete report. */\nexport const UsageCompleteness = Schema.Literals([\"complete\", \"partial\", \"unknown\"]);\n\nconst hasAdditiveTotal = (total: number, components: ReadonlyArray<number>): boolean => {\n  const sum = components.reduce((accumulator, component) => accumulator + component, 0);\n\n  return Number.isSafeInteger(sum) && total === sum;\n};\n\nconst InputTokenUsageFields = Schema.Struct({\n  total: Schema.Natural,\n  uncached: Schema.Natural,\n  cacheRead: Schema.Natural,\n  cacheWrite: Schema.Natural,\n}).check(\n  Schema.makeFilter(\n    (usage) => hasAdditiveTotal(usage.total, [usage.uncached, usage.cacheRead, usage.cacheWrite]),\n    { title: \"Input token total equals uncached, cache-read, and cache-write components\" },\n  ),\n);\n\n/** Provider-reported input-token components for one completed model call. */\nexport class InputTokenUsage extends Schema.Class<InputTokenUsage>(\n  \"@effect-agent/core/InputTokenUsage\",\n)(InputTokenUsageFields) {}\n\nconst OutputTokenUsageFields = Schema.Struct({\n  total: Schema.Natural,\n  text: Schema.Natural,\n  reasoning: Schema.Natural,\n}).check(\n  Schema.makeFilter((usage) => hasAdditiveTotal(usage.total, [usage.text, usage.reasoning]), {\n    title: \"Output token total equals text and reasoning components\",\n  }),\n);\n\n/** Provider-reported output-token components for one completed model call. */\nexport class OutputTokenUsage extends Schema.Class<OutputTokenUsage>(\n  \"@effect-agent/core/OutputTokenUsage\",\n)(OutputTokenUsageFields) {}\n\n/** Canonical, provider-independent accounting for one completed model call. */\nexport class ModelCallUsage extends Schema.Class<ModelCallUsage>(\n  \"@effect-agent/core/ModelCallUsage\",\n)({\n  provider: UsageIdentity,\n  /** Configured binding identity. See response.model for provider-reported identity. */\n  model: UsageIdentity,\n  serviceTier: Schema.optionalKey(UsageIdentity),\n  pricingVersion: Schema.optionalKey(UsageIdentity),\n  response: Schema.optionalKey(ModelResponseIdentity),\n  purpose: Schema.optionalKey(Schema.Literals([\"turn\", \"summary\"])),\n  usageStatus: Schema.optionalKey(UsageCompleteness),\n  pricingStatus: Schema.optionalKey(Schema.Literals([\"estimated\", \"unknown\"])),\n  inputTokens: InputTokenUsage,\n  outputTokens: OutputTokenUsage,\n  costMicrousd: Schema.Natural,\n}) {}\n\n/**\n * Observed model usage and estimated cost, without per-model attribution.\n * Numeric zero with unknown coverage never establishes free execution. Missing legacy\n * statuses mean unknown. Unobserved calls are excluded from the numeric call/token totals.\n */\nexport class RunTotals extends Schema.Class<RunTotals>(\"@effect-agent/core/RunTotals\")({\n  modelCalls: Schema.Natural,\n  inputTokens: Schema.Natural,\n  outputTokens: Schema.Natural,\n  costMicrousd: Schema.Natural,\n  usageStatus: Schema.optionalKey(UsageCompleteness),\n  pricingStatus: Schema.optionalKey(UsageCompleteness),\n  unobservedModelCalls: Schema.optionalKey(Schema.Natural),\n}) {}\n\n/** Own Run usage and disjoint attached-descendant usage. Add each component once. */\nexport class RunUsageReport extends Schema.Class<RunUsageReport>(\n  \"@effect-agent/core/RunUsageReport\",\n)({\n  usage: RunTotals,\n  delegatedUsage: RunTotals,\n}) {}\n\n/** A verified child report retained across durable parent Attempts. */\nexport class ChildRunUsage extends Schema.Class<ChildRunUsage>(\"@effect-agent/core/ChildRunUsage\")({\n  runId: RunId,\n  report: RunUsageReport,\n}) {}\n\n/** Known absence of observed work. */\nexport const emptyRunTotals = (): RunTotals =>\n  RunTotals.make({\n    modelCalls: 0,\n    inputTokens: 0,\n    outputTokens: 0,\n    costMicrousd: 0,\n    usageStatus: \"complete\",\n    pricingStatus: \"complete\",\n    unobservedModelCalls: 0,\n  });\n\n/** No accounting evidence, including legacy child reports. This is not known zero spend. */\nexport const unknownRunTotals = (): RunTotals =>\n  RunTotals.make({\n    ...emptyRunTotals(),\n    usageStatus: \"unknown\",\n    pricingStatus: \"unknown\",\n  });\n\n/** Settlement-sized aggregate for calls sharing one pricing identity. */\nexport class ModelUsageGroup extends Schema.Class<ModelUsageGroup>(\n  \"@effect-agent/core/ModelUsageGroup\",\n)({\n  provider: UsageIdentity,\n  model: UsageIdentity,\n  /** Actual returned model; absent when only the configured binding is known. */\n  responseModel: Schema.optionalKey(UsageIdentity),\n  serviceTier: Schema.optionalKey(UsageIdentity),\n  pricingVersion: Schema.optionalKey(UsageIdentity),\n  modelCalls: Schema.Natural.check(Schema.isGreaterThan(0)),\n  inputTokens: InputTokenUsage,\n  outputTokens: OutputTokenUsage,\n  costMicrousd: Schema.Natural,\n}) {}\n\nconst RunUsageSummaryFields = Schema.Struct({\n  modelCalls: Schema.Natural,\n  inputTokens: InputTokenUsage,\n  outputTokens: OutputTokenUsage,\n  costMicrousd: Schema.Natural,\n  byModel: Schema.Array(ModelUsageGroup),\n  /** Coverage of recorded calls only; interruptions can make the Run less complete. */\n  usageStatus: Schema.optionalKey(UsageCompleteness),\n  pricingStatus: Schema.optionalKey(UsageCompleteness),\n  /** Observed invocations without retained accounting, excluded from numeric call/token totals. */\n  unobservedModelCalls: Schema.optionalKey(Schema.Natural),\n}).check(\n  Schema.makeFilter(\n    (summary) => {\n      const identities = summary.byModel.map((group) =>\n        JSON.stringify([\n          group.provider,\n          group.model,\n          group.responseModel ?? null,\n          group.serviceTier ?? null,\n          group.pricingVersion ?? null,\n        ]),\n      );\n\n      return (\n        new Set(identities).size === identities.length &&\n        hasAdditiveTotal(\n          summary.modelCalls,\n          summary.byModel.map((group) => group.modelCalls),\n        ) &&\n        hasAdditiveTotal(\n          summary.inputTokens.total,\n          summary.byModel.map((group) => group.inputTokens.total),\n        ) &&\n        hasAdditiveTotal(\n          summary.inputTokens.uncached,\n          summary.byModel.map((group) => group.inputTokens.uncached),\n        ) &&\n        hasAdditiveTotal(\n          summary.inputTokens.cacheRead,\n          summary.byModel.map((group) => group.inputTokens.cacheRead),\n        ) &&\n        hasAdditiveTotal(\n          summary.inputTokens.cacheWrite,\n          summary.byModel.map((group) => group.inputTokens.cacheWrite),\n        ) &&\n        hasAdditiveTotal(\n          summary.outputTokens.total,\n          summary.byModel.map((group) => group.outputTokens.total),\n        ) &&\n        hasAdditiveTotal(\n          summary.outputTokens.text,\n          summary.byModel.map((group) => group.outputTokens.text),\n        ) &&\n        hasAdditiveTotal(\n          summary.outputTokens.reasoning,\n          summary.byModel.map((group) => group.outputTokens.reasoning),\n        ) &&\n        hasAdditiveTotal(\n          summary.costMicrousd,\n          summary.byModel.map((group) => group.costMicrousd),\n        )\n      );\n    },\n    {\n      title:\n        \"Run usage totals equal unique per-model pricing groups within safe-integer accounting\",\n    },\n  ),\n);\n\n/** Settlement aggregate included with a terminal Run settlement. */\nexport class RunUsageSummary extends Schema.Class<RunUsageSummary>(\n  \"@effect-agent/core/RunUsageSummary\",\n)(RunUsageSummaryFields) {}\n\ninterface MutableUsageGroup {\n  readonly provider: string;\n  readonly model: string;\n  readonly responseModel?: string | undefined;\n  readonly serviceTier?: string | undefined;\n  readonly pricingVersion?: string | undefined;\n  modelCalls: number;\n  inputTokens: {\n    total: number;\n    uncached: number;\n    cacheRead: number;\n    cacheWrite: number;\n  };\n  outputTokens: { total: number; text: number; reasoning: number };\n  costMicrousd: number;\n}\n\nconst emptyInputTokens = () => ({ total: 0, uncached: 0, cacheRead: 0, cacheWrite: 0 });\nconst emptyOutputTokens = () => ({ total: 0, text: 0, reasoning: 0 });\n\n/** Canonical usage could not be aggregated without exceeding safe-integer accounting. */\nexport class UsageAggregationError extends Schema.TaggedError<UsageAggregationError>()(\n  \"UsageAggregationError\",\n  {\n    field: Schema.NonEmptyString,\n    message: Schema.String,\n  },\n) {}\n\nconst checkedAdd = (\n  field: string,\n  left: number,\n  right: number,\n): Effect.Effect<number, UsageAggregationError> => {\n  const total = left + right;\n\n  return Number.isSafeInteger(left) &&\n    left >= 0 &&\n    Number.isSafeInteger(right) &&\n    right >= 0 &&\n    Number.isSafeInteger(total)\n    ? Effect.succeed(total)\n    : Effect.fail(\n        UsageAggregationError.make({\n          field,\n          message: `Canonical usage aggregation exceeded the safe-integer range at ${field}`,\n        }),\n      );\n};\n\n/** Combine disjoint totals, retaining uncertainty and rejecting numeric overflow. */\nexport const sumRunTotals = Effect.fn(\"sumRunTotals\")(function* (\n  contributions: ReadonlyArray<RunTotals>,\n): Effect.fn.Return<RunTotals, UsageAggregationError> {\n  let modelCalls = 0;\n  let inputTokens = 0;\n  let outputTokens = 0;\n  let costMicrousd = 0;\n  let unobservedModelCalls = 0;\n  const usageStatuses: Array<typeof UsageCompleteness.Type> = [];\n  const pricingStatuses: Array<typeof UsageCompleteness.Type> = [];\n\n  for (const contribution of contributions) {\n    const value = yield* Schema.decodeEffect(RunTotals)(contribution).pipe(\n      Effect.mapError(\n        () => new UsageAggregationError({ field: \"totals\", message: \"Invalid Run totals\" }),\n      ),\n    );\n\n    modelCalls = yield* checkedAdd(\"modelCalls\", modelCalls, value.modelCalls);\n    inputTokens = yield* checkedAdd(\"inputTokens\", inputTokens, value.inputTokens);\n    outputTokens = yield* checkedAdd(\"outputTokens\", outputTokens, value.outputTokens);\n    costMicrousd = yield* checkedAdd(\"costMicrousd\", costMicrousd, value.costMicrousd);\n    unobservedModelCalls = yield* checkedAdd(\n      \"unobservedModelCalls\",\n      unobservedModelCalls,\n      value.unobservedModelCalls ?? 0,\n    );\n    // Known empty contributions are identities; unknown empty contributions are evidence gaps.\n    if (\n      value.modelCalls > 0 ||\n      (value.unobservedModelCalls ?? 0) > 0 ||\n      value.usageStatus !== \"complete\"\n    ) {\n      usageStatuses.push(value.usageStatus ?? \"unknown\");\n    }\n    if (\n      value.modelCalls > 0 ||\n      (value.unobservedModelCalls ?? 0) > 0 ||\n      value.pricingStatus !== \"complete\"\n    ) {\n      pricingStatuses.push(value.pricingStatus ?? \"unknown\");\n    }\n  }\n\n  const coverage = (statuses: ReadonlyArray<typeof UsageCompleteness.Type>) =>\n    statuses.every((status) => status === \"complete\")\n      ? (\"complete\" as const)\n      : statuses.every((status) => status === \"unknown\")\n        ? (\"unknown\" as const)\n        : (\"partial\" as const);\n\n  return RunTotals.make({\n    modelCalls,\n    inputTokens,\n    outputTokens,\n    costMicrousd,\n    unobservedModelCalls,\n    usageStatus: coverage(usageStatuses),\n    pricingStatus: coverage(pricingStatuses),\n  });\n});\n\n/** Flatten a canonical settlement summary without discarding its coverage markers. */\nexport const runTotalsFromSummary = (summary: RunUsageSummary): RunTotals =>\n  RunTotals.make({\n    modelCalls: summary.modelCalls,\n    inputTokens: summary.inputTokens.total,\n    outputTokens: summary.outputTokens.total,\n    costMicrousd: summary.costMicrousd,\n    usageStatus: summary.usageStatus ?? \"unknown\",\n    pricingStatus: summary.pricingStatus ?? \"unknown\",\n    unobservedModelCalls: summary.unobservedModelCalls ?? 0,\n  });\n\n/**\n * Deterministically aggregate canonical per-call usage without making cached tokens free.\n * A validated seed retains earlier call totals and pricing groups without retaining those calls.\n * Empty contributions do not change completeness; the seed is never mutated.\n */\nexport const summarizeModelUsage = Effect.fn(\"summarizeModelUsage\")(function* (\n  calls: ReadonlyArray<ModelCallUsage>,\n  seed?: RunUsageSummary,\n): Effect.fn.Return<RunUsageSummary, UsageAggregationError> {\n  const initial =\n    seed === undefined\n      ? undefined\n      : yield* Schema.decodeEffect(RunUsageSummary)(seed).pipe(\n          Effect.mapError(\n            () =>\n              new UsageAggregationError({\n                field: \"seed\",\n                message: \"Canonical usage seed does not satisfy the RunUsageSummary Schema\",\n              }),\n          ),\n        );\n\n  const inputTokens = initial === undefined ? emptyInputTokens() : { ...initial.inputTokens };\n  const outputTokens = initial === undefined ? emptyOutputTokens() : { ...initial.outputTokens };\n  const groups = new Map<string, MutableUsageGroup>();\n  let modelCalls = initial?.modelCalls ?? 0;\n  let costMicrousd = initial?.costMicrousd ?? 0;\n  const hasSeedCalls = modelCalls > 0;\n\n  let allUsageUnknown =\n    !hasSeedCalls || initial?.usageStatus === undefined || initial.usageStatus === \"unknown\";\n\n  let allUsageComplete = !hasSeedCalls || initial?.usageStatus === \"complete\";\n\n  let allPricingUnknown =\n    !hasSeedCalls || initial?.pricingStatus === undefined || initial.pricingStatus === \"unknown\";\n\n  let allPricingComplete = !hasSeedCalls || initial?.pricingStatus === \"complete\";\n\n  for (const group of initial?.byModel ?? []) {\n    const key = JSON.stringify([\n      group.provider,\n      group.model,\n      group.responseModel ?? null,\n      group.serviceTier ?? null,\n      group.pricingVersion ?? null,\n    ]);\n\n    groups.set(key, {\n      ...group,\n      inputTokens: { ...group.inputTokens },\n      outputTokens: { ...group.outputTokens },\n    });\n  }\n\n  for (const call of calls) {\n    allUsageUnknown &&= call.usageStatus === undefined || call.usageStatus === \"unknown\";\n    allUsageComplete &&= call.usageStatus === \"complete\";\n    allPricingUnknown &&= call.pricingStatus !== \"estimated\";\n    allPricingComplete &&= call.pricingStatus === \"estimated\";\n    modelCalls = yield* checkedAdd(\"modelCalls\", modelCalls, 1);\n    inputTokens.total = yield* checkedAdd(\n      \"inputTokens.total\",\n      inputTokens.total,\n      call.inputTokens.total,\n    );\n    inputTokens.uncached = yield* checkedAdd(\n      \"inputTokens.uncached\",\n      inputTokens.uncached,\n      call.inputTokens.uncached,\n    );\n    inputTokens.cacheRead = yield* checkedAdd(\n      \"inputTokens.cacheRead\",\n      inputTokens.cacheRead,\n      call.inputTokens.cacheRead,\n    );\n    inputTokens.cacheWrite = yield* checkedAdd(\n      \"inputTokens.cacheWrite\",\n      inputTokens.cacheWrite,\n      call.inputTokens.cacheWrite,\n    );\n    outputTokens.total = yield* checkedAdd(\n      \"outputTokens.total\",\n      outputTokens.total,\n      call.outputTokens.total,\n    );\n    outputTokens.text = yield* checkedAdd(\n      \"outputTokens.text\",\n      outputTokens.text,\n      call.outputTokens.text,\n    );\n    outputTokens.reasoning = yield* checkedAdd(\n      \"outputTokens.reasoning\",\n      outputTokens.reasoning,\n      call.outputTokens.reasoning,\n    );\n    costMicrousd = yield* checkedAdd(\"costMicrousd\", costMicrousd, call.costMicrousd);\n\n    const key = JSON.stringify([\n      call.provider,\n      call.model,\n      call.response?.model ?? null,\n      call.serviceTier ?? null,\n      call.pricingVersion ?? null,\n    ]);\n\n    let group = groups.get(key);\n\n    if (group === undefined) {\n      group = {\n        provider: call.provider,\n        model: call.model,\n        ...(call.response?.model === undefined ? {} : { responseModel: call.response.model }),\n        ...(call.serviceTier === undefined ? {} : { serviceTier: call.serviceTier }),\n        ...(call.pricingVersion === undefined ? {} : { pricingVersion: call.pricingVersion }),\n        modelCalls: 0,\n        inputTokens: emptyInputTokens(),\n        outputTokens: emptyOutputTokens(),\n        costMicrousd: 0,\n      };\n      groups.set(key, group);\n    }\n    group.modelCalls = yield* checkedAdd(\"byModel.modelCalls\", group.modelCalls, 1);\n    group.inputTokens.total = yield* checkedAdd(\n      \"byModel.inputTokens.total\",\n      group.inputTokens.total,\n      call.inputTokens.total,\n    );\n    group.inputTokens.uncached = yield* checkedAdd(\n      \"byModel.inputTokens.uncached\",\n      group.inputTokens.uncached,\n      call.inputTokens.uncached,\n    );\n    group.inputTokens.cacheRead = yield* checkedAdd(\n      \"byModel.inputTokens.cacheRead\",\n      group.inputTokens.cacheRead,\n      call.inputTokens.cacheRead,\n    );\n    group.inputTokens.cacheWrite = yield* checkedAdd(\n      \"byModel.inputTokens.cacheWrite\",\n      group.inputTokens.cacheWrite,\n      call.inputTokens.cacheWrite,\n    );\n    group.outputTokens.total = yield* checkedAdd(\n      \"byModel.outputTokens.total\",\n      group.outputTokens.total,\n      call.outputTokens.total,\n    );\n    group.outputTokens.text = yield* checkedAdd(\n      \"byModel.outputTokens.text\",\n      group.outputTokens.text,\n      call.outputTokens.text,\n    );\n    group.outputTokens.reasoning = yield* checkedAdd(\n      \"byModel.outputTokens.reasoning\",\n      group.outputTokens.reasoning,\n      call.outputTokens.reasoning,\n    );\n    group.costMicrousd = yield* checkedAdd(\n      \"byModel.costMicrousd\",\n      group.costMicrousd,\n      call.costMicrousd,\n    );\n  }\n\n  return RunUsageSummary.make({\n    modelCalls,\n    inputTokens: InputTokenUsage.make(inputTokens),\n    outputTokens: OutputTokenUsage.make(outputTokens),\n    costMicrousd,\n    usageStatus: allUsageUnknown ? \"unknown\" : allUsageComplete ? \"complete\" : \"partial\",\n    pricingStatus: allPricingUnknown ? \"unknown\" : allPricingComplete ? \"complete\" : \"partial\",\n    ...(initial?.unobservedModelCalls === undefined\n      ? {}\n      : { unobservedModelCalls: initial.unobservedModelCalls }),\n    byModel: [...groups.values()].map((group) =>\n      ModelUsageGroup.make({\n        provider: group.provider,\n        model: group.model,\n        ...(group.responseModel === undefined ? {} : { responseModel: group.responseModel }),\n        ...(group.serviceTier === undefined ? {} : { serviceTier: group.serviceTier }),\n        ...(group.pricingVersion === undefined ? {} : { pricingVersion: group.pricingVersion }),\n        modelCalls: group.modelCalls,\n        inputTokens: InputTokenUsage.make(group.inputTokens),\n        outputTokens: OutputTokenUsage.make(group.outputTokens),\n        costMicrousd: group.costMicrousd,\n      }),\n    ),\n  });\n});\n"],"mappings":"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"}

package/dist/core/Worker.d.mts

@@ -0,0 +1,3 @@
+import { p as WorkerOperationTool } from "../SubagentContract-DdT7Cqe6.mjs";
+import { _ as WorkerStop, a as WorkerBudgetScope, b as WorkerUpdate, c as WorkerError, d as WorkerPage, f as WorkerRef, g as WorkerStarted, h as WorkerSource, i as WorkerAppliedInput, l as WorkerHistoryEntry, m as WorkerRun, n as AssignmentTerminal, o as WorkerCompletion, p as WorkerReport, r as FrameworkMessage, s as WorkerContext, t as AssignmentDisposition, u as WorkerInput, v as WorkerStopped, y as WorkerSummary } from "../Worker-fwWkBg12.mjs";
+export { AssignmentDisposition, AssignmentTerminal, FrameworkMessage, WorkerAppliedInput, WorkerBudgetScope, WorkerCompletion, WorkerContext, WorkerError, WorkerHistoryEntry, WorkerInput, WorkerOperationTool, WorkerPage, WorkerRef, WorkerReport, WorkerRun, WorkerSource, WorkerStarted, WorkerStop, WorkerStopped, WorkerSummary, WorkerUpdate };

package/dist/core/Worker.mjs

@@ -0,0 +1,3 @@
+import { WorkerOperationTool } from "./SubagentContract.mjs";
+import { _ as WorkerStop, a as WorkerBudgetScope, b as WorkerUpdate, c as WorkerError, d as WorkerPage, f as WorkerRef, g as WorkerStarted, h as WorkerSource, i as WorkerAppliedInput, l as WorkerHistoryEntry, m as WorkerRun, n as AssignmentTerminal, o as WorkerCompletion, p as WorkerReport, r as FrameworkMessage, s as WorkerContext, t as AssignmentDisposition, u as WorkerInput, v as WorkerStopped, y as WorkerSummary } from "../Worker-CfwzMZEK.mjs";
+export { AssignmentDisposition, AssignmentTerminal, FrameworkMessage, WorkerAppliedInput, WorkerBudgetScope, WorkerCompletion, WorkerContext, WorkerError, WorkerHistoryEntry, WorkerInput, WorkerOperationTool, WorkerPage, WorkerRef, WorkerReport, WorkerRun, WorkerSource, WorkerStarted, WorkerStop, WorkerStopped, WorkerSummary, WorkerUpdate };

package/dist/durable/ActivityStore.d.mts

@@ -0,0 +1,116 @@
+import { _ as Digest } from "../Records-D88mgvyS.mjs";
+import { Context, Effect, Layer, Schema } from "effect";
+declare namespace ActivityStore_d_exports {
+  export { ActivityBusy, ActivityClaim, ActivityClaimRequest, ActivityMutationFailpoint, ActivityMutationFailure, ActivityMutationPoint, ActivityOwnershipLost, ActivityProcessorKey, ActivityProcessorStore, ActivityProgress, ActivityStoreError, ActivityStoreFailure, ActivityWorkConflict, PreparedActivity };
+}
+declare const ActivityProcessorKey_base: Schema.Class<ActivityProcessorKey, Schema.Struct<{
+  readonly processorId: Schema.NonEmptyString;
+  readonly processorVersion: Schema.NonEmptyString;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+}>, {}>;
+/** Application-owned processor identity. Changing the version starts independent progress. */
+export declare class ActivityProcessorKey extends ActivityProcessorKey_base {}
+declare const PreparedActivity_base: Schema.Class<PreparedActivity, Schema.Struct<{
+  readonly version: Schema.Literal<1>;
+  readonly key: typeof ActivityProcessorKey;
+  readonly sequence: Schema.brand<Schema.Natural, "@effect-agent/thread/CanonicalSequence">;
+  readonly workId: Schema.brand<Schema.String, "@effect-agent/thread/Digest">;
+  readonly recordId: Schema.brand<Schema.NonEmptyString, "@effect-agent/thread/RecordId">;
+  readonly recordDigest: Schema.brand<Schema.String, "@effect-agent/thread/Digest">;
+  readonly output: Schema.declare<Schema.Json, Schema.Json>;
+}>, {}>;
+/** Durable extraction output, pinned before any external application of that output. */
+export declare class PreparedActivity extends PreparedActivity_base {}
+declare const ActivityClaim_base: Schema.Class<ActivityClaim, Schema.Struct<{
+  readonly key: typeof ActivityProcessorKey;
+  readonly owner: Schema.NonEmptyString;
+  readonly epoch: Schema.Int;
+  readonly throughSequence: Schema.brand<Schema.Natural, "@effect-agent/thread/CanonicalSequence">;
+  readonly leaseExpiresAt: Schema.Finite;
+  /** Pending output captured atomically at acquisition; advance returns null here. */
+  readonly pending: Schema.NullOr<typeof PreparedActivity>;
+}>, {}>;
+/** Independent from Thread ownership, submission delivery, and canonical checkpoints. */
+export declare class ActivityClaim extends ActivityClaim_base {}
+declare const ActivityProgress_base: Schema.Class<ActivityProgress, Schema.Struct<{
+  readonly version: Schema.Literal<1>;
+  readonly key: typeof ActivityProcessorKey;
+  readonly throughSequence: Schema.brand<Schema.Natural, "@effect-agent/thread/CanonicalSequence">;
+  readonly epoch: Schema.Int;
+  readonly owner: Schema.NullOr<Schema.NonEmptyString>;
+  readonly leaseExpiresAt: Schema.Finite;
+  readonly pending: Schema.NullOr<typeof PreparedActivity>;
+  /** Time of the last cursor advance, not the activity time or a global freshness clock. */
+  readonly advancedAt: Schema.NullOr<Schema.Finite>;
+}>, {}>;
+export declare class ActivityProgress extends ActivityProgress_base {}
+declare const ActivityStoreError_base: Schema.Class<ActivityStoreError, Schema.TaggedStruct<"ActivityStoreError", {
+  readonly operation: Schema.NonEmptyString;
+  readonly reason: Schema.Literals<readonly ["invalid-input", "unavailable", "corrupt", "incompatible"]>;
+}>, import("effect/Cause").YieldableError>;
+export declare class ActivityStoreError extends ActivityStoreError_base {}
+declare const ActivityBusy_base: Schema.Class<ActivityBusy, Schema.TaggedStruct<"ActivityBusy", {
+  readonly key: typeof ActivityProcessorKey;
+  readonly leaseExpiresAt: Schema.Finite;
+}>, import("effect/Cause").YieldableError>;
+export declare class ActivityBusy extends ActivityBusy_base {}
+declare const ActivityOwnershipLost_base: Schema.Class<ActivityOwnershipLost, Schema.TaggedStruct<"ActivityOwnershipLost", {
+  readonly key: typeof ActivityProcessorKey;
+  readonly owner: Schema.NonEmptyString;
+  readonly epoch: Schema.Int;
+}>, import("effect/Cause").YieldableError>;
+export declare class ActivityOwnershipLost extends ActivityOwnershipLost_base {}
+declare const ActivityWorkConflict_base: Schema.Class<ActivityWorkConflict, Schema.TaggedStruct<"ActivityWorkConflict", {
+  readonly key: typeof ActivityProcessorKey;
+  readonly workId: Schema.brand<Schema.String, "@effect-agent/thread/Digest">;
+}>, import("effect/Cause").YieldableError>;
+export declare class ActivityWorkConflict extends ActivityWorkConflict_base {}
+export declare const ActivityMutationPoint: Schema.Literals<readonly ["activity:initialize:before", "activity:initialize:after", "activity:claim:before", "activity:claim:after-state", "activity:claim:after", "activity:prepare:before", "activity:prepare:after-state", "activity:prepare:after", "activity:advance:before", "activity:advance:after-state", "activity:advance:after", "activity:release:before", "activity:release:after-state", "activity:release:after"]>;
+export type ActivityMutationPoint = typeof ActivityMutationPoint.Type;
+declare const ActivityMutationFailure_base: Schema.Class<ActivityMutationFailure, Schema.TaggedStruct<"ActivityMutationFailure", {
+  readonly point: Schema.Literals<readonly ["activity:initialize:before", "activity:initialize:after", "activity:claim:before", "activity:claim:after-state", "activity:claim:after", "activity:prepare:before", "activity:prepare:after-state", "activity:prepare:after", "activity:advance:before", "activity:advance:after-state", "activity:advance:after", "activity:release:before", "activity:release:after-state", "activity:release:after"]>;
+}>, import("effect/Cause").YieldableError>;
+export declare class ActivityMutationFailure extends ActivityMutationFailure_base {}
+declare const ActivityMutationFailpoint_base: Context.ServiceClass<ActivityMutationFailpoint, "@effect-agent/thread/ActivityMutationFailpoint", {
+  readonly hit: (point: ActivityMutationPoint) => Effect.Effect<void, ActivityMutationFailure>;
+}>;
+export declare class ActivityMutationFailpoint extends ActivityMutationFailpoint_base {
+  static readonly layer: Layer.Layer<ActivityMutationFailpoint, never, never>;
+}
+export type ActivityStoreFailure = ActivityStoreError | ActivityBusy | ActivityOwnershipLost | ActivityWorkConflict | ActivityMutationFailure;
+declare const ActivityClaimRequest_base: Schema.Class<ActivityClaimRequest, Schema.Struct<{
+  readonly key: typeof ActivityProcessorKey;
+  readonly owner: Schema.NonEmptyString;
+  readonly leaseMillis: Schema.Int;
+}>, {}>;
+export declare class ActivityClaimRequest extends ActivityClaimRequest_base {}
+declare const ActivityProcessorStore_base: Context.ServiceClass<ActivityProcessorStore, "@effect-agent/thread/ActivityProcessorStore", {
+  readonly inspect: (key: ActivityProcessorKey) => Effect.Effect<ActivityProgress | null, ActivityStoreError>;
+  readonly claim: (request: ActivityClaimRequest) => Effect.Effect<ActivityClaim, ActivityStoreFailure>;
+  readonly prepare: (request: {
+    readonly claim: ActivityClaim;
+    readonly work: PreparedActivity;
+  }) => Effect.Effect<PreparedActivity, ActivityStoreFailure>;
+  readonly advance: (request: {
+    readonly claim: ActivityClaim;
+    readonly workId: Digest;
+  }) => Effect.Effect<ActivityClaim, ActivityStoreFailure>;
+  readonly release: (claim: ActivityClaim) => Effect.Effect<void, ActivityStoreFailure>;
+}>;
+/**
+ * Optional durable progress for finite committed-activity passes. Every mutation is atomic.
+ * claim rejects an unexpired owner and allocates a strictly newer epoch on every successful
+ * acquisition, including an initial grant and reacquisition after release with the same owner. It preserves
+ * pending output and returns it with the claim. prepare and advance reject expired or superseded claims and
+ * require the claim's throughSequence to equal current progress. prepare accepts only the next
+ * sequence, pins one output, and rejects divergent reuse. advance requires its pending work ID,
+ * increments progress by exactly one, and clears pending in the same transaction.
+ *
+ * release checks owner/epoch, independent of the cursor, and never discards pending output.
+ * The adapter owns its lease clock. A failed release leaves only a bounded lease to expire.
+ * This port never owns, mutates, or checkpoints the canonical Thread log.
+ */
+export declare class ActivityProcessorStore extends ActivityProcessorStore_base {}
+//#endregion
+export { ActivityStore_d_exports as t };
+//# sourceMappingURL=ActivityStore.d.mts.map

package/dist/durable/ActivityStore.mjs

@@ -0,0 +1,131 @@
+import { t as __exportAll } from "../rolldown-runtime-D7D4PA-g.mjs";
+import { ThreadId } from "../core/Identifiers.mjs";
+import { CanonicalSequence, Digest, PersistedJson, RecordId } from "./Records.mjs";
+import { Context, Effect, Layer, Schema } from "effect";
+//#region src/durable/ActivityStore.ts
+var ActivityStore_exports = /* @__PURE__ */ __exportAll({
+	ActivityBusy: () => ActivityBusy,
+	ActivityClaim: () => ActivityClaim,
+	ActivityClaimRequest: () => ActivityClaimRequest,
+	ActivityMutationFailpoint: () => ActivityMutationFailpoint,
+	ActivityMutationFailure: () => ActivityMutationFailure,
+	ActivityMutationPoint: () => ActivityMutationPoint,
+	ActivityOwnershipLost: () => ActivityOwnershipLost,
+	ActivityProcessorKey: () => ActivityProcessorKey,
+	ActivityProcessorStore: () => ActivityProcessorStore,
+	ActivityProgress: () => ActivityProgress,
+	ActivityStoreError: () => ActivityStoreError,
+	ActivityWorkConflict: () => ActivityWorkConflict,
+	PreparedActivity: () => PreparedActivity
+});
+const Identity = Schema.NonEmptyString.check(Schema.isMaxLength(256));
+const Epoch = Schema.Int.check(Schema.isBetween({
+	minimum: 0,
+	maximum: Number.MAX_SAFE_INTEGER
+}));
+const Timestamp = Schema.Finite.check(Schema.isGreaterThanOrEqualTo(0));
+/** Application-owned processor identity. Changing the version starts independent progress. */
+var ActivityProcessorKey = class extends Schema.Class("@effect-agent/thread/ActivityProcessorKey")({
+	processorId: Identity,
+	processorVersion: Identity,
+	threadId: ThreadId.check(Schema.isMaxLength(1024))
+}) {};
+/** Durable extraction output, pinned before any external application of that output. */
+var PreparedActivity = class extends Schema.Class("@effect-agent/thread/PreparedActivity")({
+	version: Schema.Literal(1),
+	key: ActivityProcessorKey,
+	sequence: CanonicalSequence.check(Schema.isGreaterThan(0)),
+	workId: Digest,
+	recordId: RecordId,
+	recordDigest: Digest,
+	output: PersistedJson
+}) {};
+/** Independent from Thread ownership, submission delivery, and canonical checkpoints. */
+var ActivityClaim = class extends Schema.Class("@effect-agent/thread/ActivityClaim")({
+	key: ActivityProcessorKey,
+	owner: Identity,
+	epoch: Epoch,
+	throughSequence: CanonicalSequence,
+	leaseExpiresAt: Timestamp,
+	/** Pending output captured atomically at acquisition; advance returns null here. */
+	pending: Schema.NullOr(PreparedActivity)
+}) {};
+var ActivityProgress = class extends Schema.Class("@effect-agent/thread/ActivityProgress")({
+	version: Schema.Literal(1),
+	key: ActivityProcessorKey,
+	throughSequence: CanonicalSequence,
+	epoch: Epoch,
+	owner: Schema.NullOr(Identity),
+	leaseExpiresAt: Timestamp,
+	pending: Schema.NullOr(PreparedActivity),
+	/** Time of the last cursor advance, not the activity time or a global freshness clock. */
+	advancedAt: Schema.NullOr(Timestamp)
+}) {};
+var ActivityStoreError = class extends Schema.TaggedError()("ActivityStoreError", {
+	operation: Schema.NonEmptyString,
+	reason: Schema.Literals([
+		"invalid-input",
+		"unavailable",
+		"corrupt",
+		"incompatible"
+	])
+}) {};
+var ActivityBusy = class extends Schema.TaggedError()("ActivityBusy", {
+	key: ActivityProcessorKey,
+	leaseExpiresAt: Timestamp
+}) {};
+var ActivityOwnershipLost = class extends Schema.TaggedError()("ActivityOwnershipLost", {
+	key: ActivityProcessorKey,
+	owner: Identity,
+	epoch: Epoch
+}) {};
+var ActivityWorkConflict = class extends Schema.TaggedError()("ActivityWorkConflict", {
+	key: ActivityProcessorKey,
+	workId: Digest
+}) {};
+const ActivityMutationPoint = Schema.Literals([
+	"activity:initialize:before",
+	"activity:initialize:after",
+	"activity:claim:before",
+	"activity:claim:after-state",
+	"activity:claim:after",
+	"activity:prepare:before",
+	"activity:prepare:after-state",
+	"activity:prepare:after",
+	"activity:advance:before",
+	"activity:advance:after-state",
+	"activity:advance:after",
+	"activity:release:before",
+	"activity:release:after-state",
+	"activity:release:after"
+]);
+var ActivityMutationFailure = class extends Schema.TaggedError()("ActivityMutationFailure", { point: ActivityMutationPoint }) {};
+var ActivityMutationFailpoint = class extends Context.Service()("@effect-agent/thread/ActivityMutationFailpoint") {
+	static layer = Layer.succeed(this, { hit: () => Effect.void });
+};
+var ActivityClaimRequest = class extends Schema.Class("@effect-agent/thread/ActivityClaimRequest")({
+	key: ActivityProcessorKey,
+	owner: Identity,
+	leaseMillis: Schema.Int.check(Schema.isBetween({
+		minimum: 1,
+		maximum: 6e5
+	}))
+}) {};
+/**
+* Optional durable progress for finite committed-activity passes. Every mutation is atomic.
+* claim rejects an unexpired owner and allocates a strictly newer epoch on every successful
+* acquisition, including an initial grant and reacquisition after release with the same owner. It preserves
+* pending output and returns it with the claim. prepare and advance reject expired or superseded claims and
+* require the claim's throughSequence to equal current progress. prepare accepts only the next
+* sequence, pins one output, and rejects divergent reuse. advance requires its pending work ID,
+* increments progress by exactly one, and clears pending in the same transaction.
+*
+* release checks owner/epoch, independent of the cursor, and never discards pending output.
+* The adapter owns its lease clock. A failed release leaves only a bounded lease to expire.
+* This port never owns, mutates, or checkpoints the canonical Thread log.
+*/
+var ActivityProcessorStore = class extends Context.Service()("@effect-agent/thread/ActivityProcessorStore") {};
+//#endregion
+export { ActivityBusy, ActivityClaim, ActivityClaimRequest, ActivityMutationFailpoint, ActivityMutationFailure, ActivityMutationPoint, ActivityOwnershipLost, ActivityProcessorKey, ActivityProcessorStore, ActivityProgress, ActivityStoreError, ActivityWorkConflict, PreparedActivity, ActivityStore_exports as t };
+
+//# sourceMappingURL=ActivityStore.mjs.map