effect-agent 0.1.0-beta.119 → 0.1.0-beta.120

package/dist/{DurableAgentRuntime-DQqxmn2h.mjs → DurableAgentRuntime-B-9w7jDt.mjs}

@@ -1862,8 +1862,10 @@ const makeWorkerRuntime = Effect.fn("WorkerHost.make")(function* (options) {
 //#endregion
 //#region src/durable/DurableAgentRuntime.ts
 var DurableAgentRuntime_exports = /* @__PURE__ */ __exportAll({
+	ApprovalSuspensionError: () => ApprovalSuspensionError,
 	DurableAgentRuntime: () => DurableAgentRuntime,
 	DurableApprovalResolver: () => DurableApprovalResolver,
+	DurableApprovalSuspension: () => DurableApprovalSuspension,
 	DurableRuntimeConfig: () => DurableRuntimeConfig,
 	Receipt: () => Receipt,
 	RecoveryBlocked: () => RecoveryBlocked,
@@ -2123,6 +2125,8 @@ var RecoverySweepResult = class extends Schema.Class("RecoverySweepResult")({
 	/** Exactly one fault per failed Thread, regardless of its queued Submission count. */
 	blocked: Schema.Array(RecoveryBlocked)
 }) {};
+/** Attempt resources could not be retained before deliberate approval suspension. */
+var ApprovalSuspensionError = class extends Schema.TaggedError()("ApprovalSuspensionError", { cause: Schema.Defect() }) {};
 /**
 * Optional policy-auto approval delegate consulted by the durable approval hook (plan §2.6 step
 * 2) AFTER the recorded-decision lookup misses. An immediate `approved`/`denied` answer becomes
@@ -2133,6 +2137,17 @@ var RecoverySweepResult = class extends Schema.Class("RecoverySweepResult")({
 * `@effect-agent/capabilities`' `toDurableRunApprovalHook`.
 */
 const DurableApprovalResolver = Context.Reference("@effect-agent/thread/DurableApprovalResolver", { defaultValue: () => void 0 });
+/**
+* Optional attempt-local retention before an unresolved approval releases ownership. Supply
+* this from the Attempt's Layer, capturing its live resources. The canonical approval request
+* already exists; claim renewal and abort observation remain active while this operation runs.
+* Return only after retention is confirmed. Failure leaves the accepted work owed and preserves
+* its cause; interruption keeps normal resource cleanup. No approval-gated Tool runs here.
+*
+* A decision racing with successful retention resumes the pending batch in a fresh Attempt,
+* after the old services and claim finalize. The default leaves existing suspension unchanged.
+*/
+const DurableApprovalSuspension = Context.Reference("@effect-agent/thread/DurableApprovalSuspension", { defaultValue: () => void 0 });
 /** Deployment-scoped identity and liveness cadences for the durable coordinator. */
 var DurableRuntimeConfig = class DurableRuntimeConfig extends Context.Service()("@effect-agent/thread/DurableRuntimeConfig") {
 	static make(options) {
@@ -2175,6 +2190,7 @@ var CoordinatorHalt = class {
 		this.failure = failure;
 	}
 };
+const isCoordinatorHaltCause = (cause) => cause.reasons.every((reason) => reason._tag !== "Fail" || reason.error instanceof CoordinatorHalt);
 const PolicyFailure = Schema.TaggedStruct("AgentPolicyError", { limit: PolicyLimit });
 const decodePolicyFailure = Schema.decodeUnknownOption(PolicyFailure);
 const decodePolicyFailureSafely = (error) => {
@@ -2184,9 +2200,10 @@ const decodePolicyFailureSafely = (error) => {
 		return Option.none();
 	}
 };
-const agentApprovalPendingOption = (error) => {
+const agentApprovalPendingOption = (cause) => {
 	try {
-		return error instanceof AgentApprovalPending ? Option.some(error) : Option.none();
+		const first = cause.reasons.find(Cause.isFailReason);
+		return first !== void 0 && first.error instanceof AgentApprovalPending && cause.reasons.every((reason) => reason._tag !== "Fail" || reason.error instanceof AgentApprovalPending) ? Option.some(first.error) : Option.none();
 	} catch {
 		return Option.none();
 	}
@@ -3972,7 +3989,7 @@ const make = Effect.fn("DurableAgentRuntime.make")(function* (bindings) {
 			onSome: ({ limit }) => ({ policyLimit: limit })
 		})
 	})));
-	const halt = (effect) => Effect.mapError(effect, (failure) => new CoordinatorHalt(failure));
+	const halt = (effect) => Effect.catchCause(effect, (cause) => Effect.failCause(Cause.map(cause, (failure) => new CoordinatorHalt(failure))));
 	/**
 	* Superseding-Attempt interruption audit (durability §9): appended at most once per superseded
 	* fence epoch before this Attempt re-invokes the model. It deliberately over-approximates — a
@@ -4345,7 +4362,7 @@ const make = Effect.fn("DurableAgentRuntime.make")(function* (bindings) {
 		const budgetRejectedCalls = /* @__PURE__ */ new Set();
 		const haltRef = yield* Ref.make(void 0);
 		const yieldSignal = yield* Deferred.make();
-		const recordHalt = (effect) => effect.pipe(Effect.tapError((failure) => Ref.set(haltRef, failure)), Effect.mapError((failure) => new CoordinatorHalt(failure)));
+		const recordHalt = (effect) => effect.pipe(Effect.tapError((failure) => Ref.set(haltRef, failure)), halt);
 		const stateRef = yield* Ref.make({
 			baseLen: void 0,
 			lastCommitLen: 0,
@@ -5389,7 +5406,7 @@ const make = Effect.fn("DurableAgentRuntime.make")(function* (bindings) {
 			const failure = yield* Ref.get(haltRef);
 			if (failure !== void 0) return yield* Effect.fail(failure);
 			yield* handleEvent(event);
-		}))).pipe(Effect.as({ _tag: "run" }));
+		}))).pipe(Effect.tapCause((cause) => Option.isSome(agentApprovalPendingOption(cause)) && cause.reasons.every(Cause.isFailReason) ? Effect.flatMap(DurableApprovalSuspension, (retain) => retain === void 0 ? Effect.void : halt(retain)) : Effect.void), Effect.as({ _tag: "run" }));
 		const abortWatcher = halt(Effect.gen(function* () {
 			while (true) {
 				yield* Effect.sleep(config.abortPollInterval);
@@ -5409,12 +5426,16 @@ const make = Effect.fn("DurableAgentRuntime.make")(function* (bindings) {
 		}).pipe(Effect.uninterruptible), { schedule: Schedule.spaced(config.leaseRenewalInterval) }).pipe(Effect.andThen(Effect.never)));
 		const execution = Effect.raceFirst(consume, Effect.raceFirst(abortWatcher, renewal));
 		const result = yield* (yieldAfter === void 0 ? execution : Effect.raceFirst(execution, Deferred.await(yieldSignal).pipe(Effect.as({ _tag: "yielded" })))).pipe(Effect.provideService(IdGenerator$1, idGenerator)).pipe(Effect.catchCauseFilter(Cause.findError, (error, cause) => {
-			if (error instanceof CoordinatorHalt) return Effect.fail(error.failure);
-			const approvalPending = agentApprovalPendingOption(error);
-			if (Option.isSome(approvalPending)) return decodeToolCallIdUnknown(approvalPending.value.toolCallId).pipe(Effect.orDie, Effect.map((toolCallId) => ({
-				_tag: "suspendedRun",
-				toolCallId
-			})));
+			if (isCoordinatorHaltCause(cause)) return Effect.failCause(Cause.map(cause, (halt) => halt.failure));
+			const approvalPending = agentApprovalPendingOption(cause);
+			if (Option.isSome(approvalPending)) {
+				const residual = Cause.fromReasons(cause.reasons.filter((reason) => reason._tag !== "Fail"));
+				if (residual.reasons.length > 0) return Effect.failCause(residual);
+				return decodeToolCallIdUnknown(approvalPending.value.toolCallId).pipe(Effect.orDie, Effect.map((toolCallId) => ({
+					_tag: "suspendedRun",
+					toolCallId
+				})));
+			}
 			const childPending = agentChildPendingOption(error);
 			if (Option.isSome(childPending)) return commitSiblingLateSettles(childPending.value.children).pipe(Effect.map(() => ({
 				_tag: "suspendedChildRun",
@@ -5483,7 +5504,7 @@ const make = Effect.fn("DurableAgentRuntime.make")(function* (bindings) {
 	* (Unknown Outcomes, or a durable approval suspension) — no settlement occurs and the
 	* obligation stays owed.
 	*/
-	const runAttempt = (registeredAgent, threadId, claim, tokenRef, yieldAfter) => Effect.gen(function* () {
+	const runAttempt = (registeredAgent, threadId, claim, tokenRef, resumeAfterRetention, yieldAfter) => Effect.gen(function* () {
 		const submissionId = claim.submissionId;
 		const supersededEpoch = yield* store.inspectTail(ThreadTailRequest.make({ threadId })).pipe(Effect.map((tail) => tail.producerEpoch), Effect.catchTag("ThreadNotMaterialized", () => Effect.succeed(ZERO_EPOCH)));
 		yield* store.materialize(ThreadMaterialization.make({
@@ -5696,6 +5717,10 @@ const make = Effect.fn("DurableAgentRuntime.make")(function* (bindings) {
 				}));
 				yield* hit("approval:after-suspend");
 				if (suspension === "suspended") return Option.none();
+				if ((yield* DurableApprovalSuspension) !== void 0) {
+					resumeAfterRetention();
+					return Option.none();
+				}
 				approvalDecisionIntents = (yield* ledger.loadRecoverySnapshot(RecoverySnapshotRequest.make({ submissionId }))).approvalDecisions;
 				continue;
 			}
@@ -5760,45 +5785,55 @@ const make = Effect.fn("DurableAgentRuntime.make")(function* (bindings) {
 			tokenRef
 		});
 	}, Effect.uninterruptible);
-	const processThreadHead = (resolve, threadId, options) => Effect.scoped(Effect.gen(function* () {
-		const claimed = yield* acquireClaim(threadId);
-		if (Option.isNone(claimed)) return Option.none();
-		const { claim, tokenRef } = claimed.value;
-		const attributes = {
-			threadId,
-			submissionId: claim.submissionId,
-			attemptId: claim.attemptId
-		};
-		yield* Effect.annotateCurrentSpan(attributes);
-		yield* Effect.annotateLogsScoped(attributes);
-		yield* hit("claim:after-claim");
-		const found = yield* ledger.lookup(SubmissionLookupById.make({ submissionId: claim.submissionId }));
-		if (Option.isNone(found)) return yield* LedgerError.make({
-			operation: "processThreadHead",
-			message: `Claimed unknown Submission ${claim.submissionId}`
-		});
-		const submission = found.value;
-		if (submission.parentLinkage !== void 0 && submission.state === "admitted") {
-			if (!(yield* readAllTolerant(threadId, [])).records.some((envelope) => envelope.record.payload._tag === "SubagentLineageRecorded")) {
-				yield* ledger.releaseOwnership(ReleaseOwnershipRequest.make({
-					submissionId: claim.submissionId,
-					ownershipToken: claim.ownershipToken
-				})).pipe(Effect.catchTag("OwnershipLost", () => Effect.void));
-				const parent = yield* ledger.lookup(SubmissionLookupById.make({ submissionId: submission.parentLinkage.parentSubmissionId }));
-				if (Option.isSome(parent)) yield* wake.notify(parent.value.threadId);
-				return Option.none();
+	const processThreadHead = (resolve, threadId, options) => Effect.gen(function* () {
+		let resumeAfterRetention = false;
+		const attempt = Effect.scoped(Effect.gen(function* () {
+			const claimed = yield* acquireClaim(threadId);
+			if (Option.isNone(claimed)) return Option.none();
+			const { claim, tokenRef } = claimed.value;
+			const attributes = {
+				threadId,
+				submissionId: claim.submissionId,
+				attemptId: claim.attemptId
+			};
+			yield* Effect.annotateCurrentSpan(attributes);
+			yield* Effect.annotateLogsScoped(attributes);
+			yield* hit("claim:after-claim");
+			const found = yield* ledger.lookup(SubmissionLookupById.make({ submissionId: claim.submissionId }));
+			if (Option.isNone(found)) return yield* LedgerError.make({
+				operation: "processThreadHead",
+				message: `Claimed unknown Submission ${claim.submissionId}`
+			});
+			const submission = found.value;
+			if (submission.parentLinkage !== void 0 && submission.state === "admitted") {
+				if (!(yield* readAllTolerant(threadId, [])).records.some((envelope) => envelope.record.payload._tag === "SubagentLineageRecorded")) {
+					yield* ledger.releaseOwnership(ReleaseOwnershipRequest.make({
+						submissionId: claim.submissionId,
+						ownershipToken: claim.ownershipToken
+					})).pipe(Effect.catchTag("OwnershipLost", () => Effect.void));
+					const parent = yield* ledger.lookup(SubmissionLookupById.make({ submissionId: submission.parentLinkage.parentSubmissionId }));
+					if (Option.isSome(parent)) yield* wake.notify(parent.value.threadId);
+					return Option.none();
+				}
 			}
+			const resolution = yield* resolve(submission).pipe(Effect.map((binding) => ({
+				_tag: "resolved",
+				binding
+			})), Effect.catchTags({ BindingUnavailable: (failure) => Effect.succeed({
+				_tag: "refused",
+				failure
+			}) }));
+			if (resolution._tag === "refused") return yield* resolution.failure;
+			return yield* resolution.binding.attempt((agent, attemptThreadId, attemptClaim) => runAttempt(agent, attemptThreadId, attemptClaim, tokenRef, () => {
+				resumeAfterRetention = true;
+			}, options?.yieldAfter), threadId, claim);
+		}));
+		while (true) {
+			resumeAfterRetention = false;
+			const settlement = yield* attempt;
+			if (!resumeAfterRetention) return settlement;
 		}
-		const resolution = yield* resolve(submission).pipe(Effect.map((binding) => ({
-			_tag: "resolved",
-			binding
-		})), Effect.catchTags({ BindingUnavailable: (failure) => Effect.succeed({
-			_tag: "refused",
-			failure
-		}) }));
-		if (resolution._tag === "refused") return yield* resolution.failure;
-		return yield* resolution.binding.attempt((agent, attemptThreadId, attemptClaim) => runAttempt(agent, attemptThreadId, attemptClaim, tokenRef, options?.yieldAfter), threadId, claim);
-	})).pipe(withThreadHeadSpan);
+	}).pipe(withThreadHeadSpan);
 	const eligibleThreadHead = (threadId) => Stream.runHead(ledger.scanNonterminal.pipe(Stream.filter((entry) => entry.threadId === threadId), Stream.filterEffect((entry) => entry.state !== "unknown" ? Effect.succeed(true) : ledger.loadRecoverySnapshot(RecoverySnapshotRequest.make({ submissionId: entry.submissionId })).pipe(Effect.map((snapshot) => snapshot.abortIntent !== void 0)))));
 	const drainThread = (resolve, threadId) => Effect.gen(function* () {
 		const settlements = [];
@@ -7021,6 +7056,6 @@ var DurableAgentRuntime = class DurableAgentRuntime extends Context.Service()("@
 	static layer = DurableAgentRuntime.layerWithServices.pipe(Layer.provide([RunContextPreparationPassthrough, RunToolAuthorization.allowAll]));
 };
 //#endregion
-export { RecoveryBlocked as a, RecoverySweepResult as c, recoveryRepairBatchId as d, recoveryRepairRecordId as f, DurableRuntimeConfig as i, childReservationIdFor as l, threadCreatedRecordId as m, DurableAgentRuntime_exports as n, RecoveryFailure as o, threadCreatedBatchId as p, DurableApprovalResolver as r, RecoveryReport as s, DurableAgentRuntime as t, isolateRecovery as u };
+export { DurableApprovalSuspension as a, RecoveryFailure as c, childReservationIdFor as d, isolateRecovery as f, threadCreatedRecordId as g, threadCreatedBatchId as h, DurableApprovalResolver as i, RecoveryReport as l, recoveryRepairRecordId as m, DurableAgentRuntime as n, DurableRuntimeConfig as o, recoveryRepairBatchId as p, DurableAgentRuntime_exports as r, RecoveryBlocked as s, ApprovalSuspensionError as t, RecoverySweepResult as u };
 
-//# sourceMappingURL=DurableAgentRuntime-DQqxmn2h.mjs.map
+//# sourceMappingURL=DurableAgentRuntime-B-9w7jDt.mjs.map