@effect-agent/workflow 0.1.0-beta.46

package/dist/AgentWorkflow.d.mts

@@ -0,0 +1,30 @@
+import { WorkflowDispatchError } from "./WorkflowDispatch.mjs";
+import { WorkflowAgent, WorkflowExecuteOptions, WorkflowExecutionFailure } from "./WorkflowExecution.mjs";
+import { WorkflowAdmissionClosed, WorkflowAgentHost } from "./WorkflowAgentHost.mjs";
+import { AgentInputError, AgentOutputError } from "@effect-agent/core/AgentError";
+import { BindingUnavailable } from "@effect-agent/thread/AgentRegistration";
+import { DigestError } from "@effect-agent/thread/Digest";
+import { DurableRuntimeFailpointError } from "@effect-agent/thread/DurableFailpoint";
+import { OperationDenied } from "@effect-agent/thread/OperationAuthorizer";
+import { AdmissionConflict, LedgerError, SettlementConflict } from "@effect-agent/thread/SubmissionLedger";
+import { AppendConflict, FenceRejected, ThreadNotMaterialized, ThreadStoreError } from "@effect-agent/thread/ThreadStore";
+import { Effect, Schema } from "effect";
+declare namespace AgentWorkflow_d_exports {
+  export { Error, execute };
+}
+/** Schema for the exact typed failure channel of execute, suitable for Workflow.make({ error }). */
+declare const Error: Schema.Union<readonly [typeof AgentInputError, typeof AgentOutputError, typeof AdmissionConflict, typeof AppendConflict, typeof BindingUnavailable, typeof DigestError, typeof DurableRuntimeFailpointError, typeof FenceRejected, typeof LedgerError, typeof OperationDenied, typeof SettlementConflict, typeof ThreadNotMaterialized, typeof ThreadStoreError, typeof WorkflowDispatchError, typeof WorkflowAdmissionClosed, typeof WorkflowExecutionFailure]>;
+type Error = typeof Error.Type;
+/**
+ * Run a registered agent inside a native Workflow.toLayer handler. One stable name identifies
+ * one submission in that parent execution. Replays verify admission identity and decode the
+ * canonical output again. Pending work suspends through Effect DurableDeferred; neither
+ * suspension nor parent interruption aborts accepted agent work. Use the host's authorized abort.
+ * Provide WorkflowAgentHost at the application boundary, sharing the parent's WorkflowEngine.
+ * Pass the exact Agent Definition instance used in runtime registration; a same-ID copy fails
+ * with BindingUnavailable before input encoding or admission.
+ */
+declare const execute: <Input extends Schema.Top, Output extends Schema.Top>(agent: WorkflowAgent<Input, Output>, input: Input["Type"], options: WorkflowExecuteOptions) => Effect.Effect<Output["Type"], AdmissionConflict | AgentInputError | AgentOutputError | AppendConflict | BindingUnavailable | DigestError | DurableRuntimeFailpointError | FenceRejected | LedgerError | OperationDenied | SettlementConflict | ThreadNotMaterialized | ThreadStoreError | WorkflowAdmissionClosed | WorkflowDispatchError | WorkflowExecutionFailure, WorkflowAgentHost | import("effect/unstable/workflow/WorkflowEngine").WorkflowEngine | import("effect/unstable/workflow/WorkflowEngine").WorkflowInstance | Input["EncodingServices"] | Output["DecodingServices"]>;
+//#endregion
+export { Error, execute, AgentWorkflow_d_exports as t };
+//# sourceMappingURL=AgentWorkflow.d.mts.map

package/dist/AgentWorkflow.mjs

@@ -0,0 +1,52 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { WorkflowDispatchError } from "./WorkflowDispatch.mjs";
+import { n as WorkflowAgentHost, t as WorkflowAdmissionClosed } from "./WorkflowAgentHost-DOGuS1cg.mjs";
+import { WorkflowExecutionFailure } from "./WorkflowExecution.mjs";
+import { AgentInputError, AgentOutputError } from "@effect-agent/core/AgentError";
+import { BindingUnavailable } from "@effect-agent/thread/AgentRegistration";
+import { DigestError } from "@effect-agent/thread/Digest";
+import { DurableRuntimeFailpointError } from "@effect-agent/thread/DurableFailpoint";
+import { OperationDenied } from "@effect-agent/thread/OperationAuthorizer";
+import { AdmissionConflict, LedgerError, SettlementConflict } from "@effect-agent/thread/SubmissionLedger";
+import { AppendConflict, FenceRejected, ThreadNotMaterialized, ThreadStoreError } from "@effect-agent/thread/ThreadStore";
+import { Effect, Schema } from "effect";
+//#region src/AgentWorkflow.ts
+var AgentWorkflow_exports = /* @__PURE__ */ __exportAll({
+	Error: () => Error,
+	execute: () => execute
+});
+/** Schema for the exact typed failure channel of execute, suitable for Workflow.make({ error }). */
+const Error = Schema.Union([
+	AgentInputError,
+	AgentOutputError,
+	AdmissionConflict,
+	AppendConflict,
+	BindingUnavailable,
+	DigestError,
+	DurableRuntimeFailpointError,
+	FenceRejected,
+	LedgerError,
+	OperationDenied,
+	SettlementConflict,
+	ThreadNotMaterialized,
+	ThreadStoreError,
+	WorkflowDispatchError,
+	WorkflowAdmissionClosed,
+	WorkflowExecutionFailure
+]);
+/**
+* Run a registered agent inside a native Workflow.toLayer handler. One stable name identifies
+* one submission in that parent execution. Replays verify admission identity and decode the
+* canonical output again. Pending work suspends through Effect DurableDeferred; neither
+* suspension nor parent interruption aborts accepted agent work. Use the host's authorized abort.
+* Provide WorkflowAgentHost at the application boundary, sharing the parent's WorkflowEngine.
+* Pass the exact Agent Definition instance used in runtime registration; a same-ID copy fails
+* with BindingUnavailable before input encoding or admission.
+*/
+const execute = Effect.fn("AgentWorkflow.execute")(function* (agent, input, options) {
+	return yield* (yield* WorkflowAgentHost).execute(agent, input, options);
+});
+//#endregion
+export { Error, execute, AgentWorkflow_exports as t };
+
+//# sourceMappingURL=AgentWorkflow.mjs.map

package/dist/AgentWorkflow.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentWorkflow.mjs","names":[],"sources":["../src/AgentWorkflow.ts"],"sourcesContent":["import { AgentInputError, AgentOutputError } from \"@effect-agent/core/AgentError\";\nimport { BindingUnavailable } from \"@effect-agent/thread/AgentRegistration\";\nimport { DigestError } from \"@effect-agent/thread/Digest\";\nimport { DurableRuntimeFailpointError } from \"@effect-agent/thread/DurableFailpoint\";\nimport { OperationDenied } from \"@effect-agent/thread/OperationAuthorizer\";\nimport {\n  AdmissionConflict,\n  LedgerError,\n  SettlementConflict,\n} from \"@effect-agent/thread/SubmissionLedger\";\nimport {\n  AppendConflict,\n  FenceRejected,\n  ThreadNotMaterialized,\n  ThreadStoreError,\n} from \"@effect-agent/thread/ThreadStore\";\nimport { Effect, Schema } from \"effect\";\n\nimport { WorkflowAdmissionClosed, WorkflowAgentHost } from \"./WorkflowAgentHost.ts\";\nimport { WorkflowDispatchError } from \"./WorkflowDispatch.ts\";\nimport {\n  WorkflowExecutionFailure,\n  type WorkflowAgent,\n  type WorkflowExecuteOptions,\n} from \"./WorkflowExecution.ts\";\n\n/** Schema for the exact typed failure channel of execute, suitable for Workflow.make({ error }). */\nexport const Error = Schema.Union([\n  AgentInputError,\n  AgentOutputError,\n  AdmissionConflict,\n  AppendConflict,\n  BindingUnavailable,\n  DigestError,\n  DurableRuntimeFailpointError,\n  FenceRejected,\n  LedgerError,\n  OperationDenied,\n  SettlementConflict,\n  ThreadNotMaterialized,\n  ThreadStoreError,\n  WorkflowDispatchError,\n  WorkflowAdmissionClosed,\n  WorkflowExecutionFailure,\n]);\n\nexport type Error = typeof Error.Type;\n\n/**\n * Run a registered agent inside a native Workflow.toLayer handler. One stable name identifies\n * one submission in that parent execution. Replays verify admission identity and decode the\n * canonical output again. Pending work suspends through Effect DurableDeferred; neither\n * suspension nor parent interruption aborts accepted agent work. Use the host's authorized abort.\n * Provide WorkflowAgentHost at the application boundary, sharing the parent's WorkflowEngine.\n * Pass the exact Agent Definition instance used in runtime registration; a same-ID copy fails\n * with BindingUnavailable before input encoding or admission.\n */\nexport const execute = Effect.fn(\"AgentWorkflow.execute\")(function* <\n  Input extends Schema.Top,\n  Output extends Schema.Top,\n>(agent: WorkflowAgent<Input, Output>, input: Input[\"Type\"], options: WorkflowExecuteOptions) {\n  const host = yield* WorkflowAgentHost;\n\n  return yield* host.execute(agent, input, options);\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;AA2BA,MAAa,QAAQ,OAAO,MAAM;CAChC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;;;;;;AAaD,MAAa,UAAU,OAAO,GAAG,uBAAuB,CAAC,CAAC,WAGxD,OAAqC,OAAsB,SAAiC;CAG5F,OAAO,QAAO,OAFM,kBAAA,CAED,QAAQ,OAAO,OAAO,OAAO;AAClD,CAAC"}

package/dist/WorkflowAgentHost-DOGuS1cg.mjs

@@ -0,0 +1,298 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { WorkflowDispatchError, WorkflowDispatchFailpoint, WorkflowDispatchIntent, WorkflowDispatchScan, WorkflowDispatchStore, WorkflowRepairReport, WorkflowRepairTrigger, WorkflowSettlementReference, WorkflowSubmission } from "./WorkflowDispatch.mjs";
+import { WorkflowExecutionFailure } from "./WorkflowExecution.mjs";
+import { AgentOutputError } from "@effect-agent/core/AgentError";
+import "@effect-agent/thread/AgentRegistration";
+import { digestJson } from "@effect-agent/thread/Digest";
+import { IdempotencyKey, Principal, SubmissionLedger, SubmissionLookupById } from "@effect-agent/thread/SubmissionLedger";
+import { Cause, Context, Crypto, Effect, Exit, Layer, Option, RcMap, Ref, Result, Schema, Semaphore, Stream } from "effect";
+import { ThreadId } from "@effect-agent/core/Identifiers";
+import { DurableAgentRuntime, DurableRuntimeConfig, Receipt } from "@effect-agent/thread/DurableAgentRuntime";
+import { DeploymentId } from "@effect-agent/thread/Records";
+import { DurableDeferred, Workflow, WorkflowEngine } from "effect/unstable/workflow";
+//#region src/internal/completion.ts
+/** Native deferred results contain only canonical identities, never a second agent result. */
+const workflowCompletion = (name) => DurableDeferred.make(name, { success: WorkflowSettlementReference });
+//#endregion
+//#region src/WorkflowAgentHost.ts
+var WorkflowAgentHost_exports = /* @__PURE__ */ __exportAll({
+	WorkflowAdmissionClosed: () => WorkflowAdmissionClosed,
+	WorkflowAgentHost: () => WorkflowAgentHost,
+	WorkflowHostConfigError: () => WorkflowHostConfigError
+});
+const WorkflowHostConfig = Schema.Struct({
+	deploymentId: DeploymentId,
+	principal: Principal,
+	workflowName: Schema.NonEmptyString,
+	executionConcurrency: Schema.Int.check(Schema.isBetween({
+		minimum: 1,
+		maximum: 64
+	})),
+	repairBatchSize: Schema.Int.check(Schema.isBetween({
+		minimum: 1,
+		maximum: 1e3
+	})),
+	dispatchTimeoutMillis: Schema.Int.check(Schema.isBetween({
+		minimum: 1,
+		maximum: 3e5
+	}))
+});
+var WorkflowHostConfigError = class extends Schema.TaggedError()("WorkflowHostConfigError", { message: Schema.String }) {};
+var WorkflowAdmissionClosed = class extends Schema.TaggedError()("WorkflowAdmissionClosed", { message: Schema.String }) {};
+const nativeOperation = (operation, effect) => effect.pipe(Effect.catchDefect((cause) => Effect.fail(new WorkflowDispatchError({
+	operation,
+	message: "Workflow engine operation failed",
+	cause
+}))));
+const makeHost = Effect.fn("WorkflowAgentHost.make")(function* (options) {
+	const config = yield* Schema.decodeUnknownEffect(WorkflowHostConfig)({
+		deploymentId: options.deploymentId,
+		principal: options.principal,
+		workflowName: options.workflowName ?? "effect-agent/Submission/v1",
+		executionConcurrency: options.executionConcurrency ?? 1,
+		repairBatchSize: options.repairBatchSize ?? 32,
+		dispatchTimeoutMillis: options.dispatchTimeoutMillis ?? 1e4
+	}).pipe(Effect.mapError((error) => new WorkflowHostConfigError({ message: error.message })));
+	const runtime = yield* DurableAgentRuntime;
+	const crypto = yield* Crypto.Crypto;
+	const runtimeConfig = yield* DurableRuntimeConfig;
+	const ledger = yield* SubmissionLedger;
+	const engine = yield* WorkflowEngine.WorkflowEngine;
+	const dispatch = yield* WorkflowDispatchStore;
+	const trigger = yield* WorkflowRepairTrigger;
+	const failpoint = yield* WorkflowDispatchFailpoint;
+	if (runtimeConfig.deploymentId !== config.deploymentId) return yield* new WorkflowHostConfigError({ message: "Workflow and durable runtime deploymentId must match" });
+	const permits = yield* Semaphore.make(config.executionConcurrency);
+	const lanes = yield* RcMap.make({ lookup: (_threadId) => Semaphore.make(1) });
+	const repairPermit = yield* Semaphore.make(1);
+	const admission = yield* Ref.make(true);
+	const nativeName = `${config.workflowName}/deployment/${config.deploymentId.length}:${config.deploymentId}`;
+	const workflow = Workflow.make(nativeName, {
+		payload: WorkflowSubmission,
+		success: WorkflowSettlementReference,
+		idempotencyKey: ({ deploymentId, receipt }) => `v1/${deploymentId.length}:${deploymentId}/${receipt.submissionId}`
+	}).annotate(Workflow.SuspendOnFailure, true);
+	const bounded = (operation, effect) => nativeOperation(operation, effect).pipe(Effect.timeout(config.dispatchTimeoutMillis), Effect.catchTag("TimeoutError", () => Effect.fail(WorkflowDispatchError.make({
+		operation,
+		message: "Workflow dispatch operation timed out; accepted work remains recoverable"
+	}))));
+	const validateReceipt = Effect.fn("WorkflowAgentHost.validateReceipt")(function* (receipt) {
+		const found = yield* ledger.lookup(SubmissionLookupById.make({ submissionId: receipt.submissionId }));
+		if (Option.isNone(found) || found.value.deploymentId !== config.deploymentId || found.value.threadId !== receipt.threadId || found.value.receiptId !== receipt.receiptId || found.value.queueSequence !== receipt.queueSequence) return yield* WorkflowDispatchError.make({
+			operation: "identity",
+			message: "Workflow Receipt does not match its authoritative deployment and Submission"
+		});
+	});
+	yield* engine.register(workflow, Effect.fn("WorkflowAgentHost.execute")(function* (payload, executionId) {
+		yield* Effect.annotateCurrentSpan({
+			"workflow.execution.id": executionId,
+			"agent.submission.id": payload.receipt.submissionId,
+			"agent.thread.id": payload.receipt.threadId
+		});
+		if (payload.deploymentId !== config.deploymentId) return yield* Effect.die("Workflow payload belongs to another deployment");
+		if (executionId !== (yield* workflow.executionId(payload))) return yield* Effect.die("Workflow execution identity does not match its Submission");
+		yield* validateReceipt(payload.receipt).pipe(Effect.orDie);
+		const initial = yield* runtime.inspectSubmissionStatus(payload.receipt).pipe(Effect.orDie);
+		if (initial._tag === "settled") return new WorkflowSettlementReference({
+			version: 1,
+			submissionId: initial.settlement.submissionId,
+			threadId: payload.receipt.threadId,
+			settlementId: initial.settlement.settlementId
+		});
+		const status = yield* Effect.scoped(Effect.gen(function* () {
+			return yield* (yield* RcMap.get(lanes, payload.receipt.threadId)).withPermit(permits.withPermit(Effect.scoped(Effect.gen(function* () {
+				yield* runtime.recoverSubmission(payload.receipt.submissionId);
+				const recovered = yield* runtime.inspectSubmissionStatus(payload.receipt);
+				if (recovered._tag === "settled") return recovered;
+				yield* runtime.processThreadHead(payload.receipt.threadId);
+				return yield* runtime.inspectSubmissionStatus(payload.receipt);
+			}))));
+		})).pipe(Effect.orDie);
+		if (status._tag === "settled") return new WorkflowSettlementReference({
+			version: 1,
+			submissionId: status.settlement.submissionId,
+			threadId: payload.receipt.threadId,
+			settlementId: status.settlement.settlementId
+		});
+		const instance = yield* WorkflowEngine.WorkflowInstance;
+		return yield* Workflow.suspend(instance);
+	}));
+	const intentFor = Effect.fn("WorkflowAgentHost.intentFor")(function* (receipt) {
+		const payload = new WorkflowSubmission({
+			version: 1,
+			deploymentId: config.deploymentId,
+			receipt
+		});
+		const executionId = yield* workflow.executionId(payload);
+		return new WorkflowDispatchIntent({
+			...payload,
+			workflowName: nativeName,
+			executionId
+		});
+	});
+	const dispatchIntent = Effect.fn("WorkflowAgentHost.dispatch")(function* (requested) {
+		let intent = requested;
+		const expected = yield* intentFor(intent.receipt);
+		if (intent.executionId !== expected.executionId || intent.deploymentId !== expected.deploymentId || intent.workflowName !== expected.workflowName) return yield* new WorkflowDispatchError({
+			operation: "dispatch",
+			message: "Dispatch identity does not match the configured Workflow"
+		});
+		yield* validateReceipt(intent.receipt);
+		yield* failpoint.hit("intent:before-persist", intent);
+		intent = yield* dispatch.put(intent);
+		yield* failpoint.hit("intent:after-persist", intent);
+		yield* failpoint.hit("launch:before", intent);
+		yield* nativeOperation("execute", engine.execute(workflow, {
+			executionId: intent.executionId,
+			payload: new WorkflowSubmission(intent),
+			discard: true
+		}).pipe(Effect.updateContext((context) => Context.omit(WorkflowEngine.WorkflowInstance)(context))));
+		yield* failpoint.hit("launch:after", intent);
+		yield* nativeOperation("resume", engine.resume(workflow, intent.executionId));
+		yield* failpoint.hit("completion:before-observe", intent);
+		const result = yield* nativeOperation("poll", engine.poll(workflow, intent.executionId));
+		yield* failpoint.hit("completion:after-observe", intent);
+		if (Option.isNone(result) || result.value._tag !== "Complete") return false;
+		if (Exit.isFailure(result.value.exit)) return yield* new WorkflowDispatchError({
+			operation: "completion",
+			message: "Native Workflow completed without a Settlement reference; intent retained",
+			cause: result.value.exit.cause
+		});
+		const status = yield* runtime.inspectSubmissionStatus(intent.receipt);
+		const reference = result.value.exit.value;
+		if (status._tag !== "settled" || reference.version !== 1 || reference.submissionId !== intent.receipt.submissionId || reference.threadId !== intent.receipt.threadId || reference.settlementId !== status.settlement.settlementId) return yield* new WorkflowDispatchError({
+			operation: "completion",
+			message: "Native completion disagrees with canonical Settlement; intent retained"
+		});
+		if (intent.completionToken !== void 0) {
+			yield* failpoint.hit("completion:before-notify", intent);
+			yield* nativeOperation("notify", DurableDeferred.succeed(workflowCompletion("settlement"), {
+				token: intent.completionToken,
+				value: reference
+			}).pipe(Effect.provideService(WorkflowEngine.WorkflowEngine, engine)));
+			yield* failpoint.hit("completion:after-notify", intent);
+		}
+		yield* failpoint.hit("cleanup:before", intent);
+		yield* dispatch.remove(intent);
+		yield* failpoint.hit("cleanup:after", intent);
+		return true;
+	}, (effect) => bounded("dispatch", effect));
+	let submissionOffset = 0;
+	let intentCursor;
+	const repair = repairPermit.withPermit(Effect.gen(function* () {
+		const discovery = yield* bounded("scanSubmissions", ledger.scanNonterminal.pipe(Stream.filter((row) => row.deploymentId === config.deploymentId), Stream.drop(submissionOffset), Stream.take(config.repairBatchSize), Stream.runCollect)).pipe(Effect.result);
+		const submissions = Result.isSuccess(discovery) ? discovery.success : [];
+		if (Result.isSuccess(discovery)) submissionOffset = submissions.length < config.repairBatchSize ? 0 : submissionOffset + submissions.length;
+		const discovered = yield* Effect.forEach(submissions, (row) => Effect.flatMap(intentFor(new Receipt(row)), dispatchIntent).pipe(Effect.result));
+		const outstanding = yield* bounded("scanIntents", dispatch.scan(new WorkflowDispatchScan({
+			deploymentId: config.deploymentId,
+			workflowName: nativeName,
+			...intentCursor === void 0 ? {} : { after: intentCursor },
+			limit: config.repairBatchSize
+		}))).pipe(Effect.result);
+		const intents = Result.isSuccess(outstanding) ? outstanding.success : [];
+		if (Result.isSuccess(outstanding)) intentCursor = intents.length < config.repairBatchSize ? void 0 : intents[intents.length - 1]?.executionId;
+		const inspected = yield* Effect.forEach(intents, (intent) => dispatchIntent(intent).pipe(Effect.result));
+		const results = [...discovered, ...inspected];
+		if (Result.isFailure(discovery)) return yield* discovery.failure;
+		if (Result.isFailure(outstanding)) return yield* outstanding.failure;
+		const failure = results.find(Result.isFailure);
+		if (failure !== void 0) return yield* Effect.fail(failure.failure);
+		return new WorkflowRepairReport({
+			discovered: submissions.length,
+			inspected: intents.length,
+			completed: results.filter((result) => Result.isSuccess(result) && result.success).length
+		});
+	}));
+	yield* trigger.register(repair.pipe(Effect.asVoid, Effect.catchCause((cause) => Cause.hasInterruptsOnly(cause) ? Effect.interrupt : Effect.logError("Workflow dispatch repair failed; durable obligations remain", cause))));
+	yield* Effect.addFinalizer(() => Ref.set(admission, false));
+	const submit = Effect.fn("WorkflowAgentHost.submit")(function* (agent, input, options) {
+		if (!(yield* Ref.get(admission))) return yield* new WorkflowAdmissionClosed({ message: "The Workflow host is shutting down" });
+		const receipt = yield* runtime.submit(agent, input, options);
+		yield* dispatchIntent(yield* intentFor(receipt));
+		return receipt;
+	});
+	const execute = Effect.fn("AgentWorkflow.execute")(function* (agent, input, options) {
+		if ((yield* WorkflowEngine.WorkflowEngine) !== engine) return yield* new WorkflowExecutionFailure({
+			reason: "engine-mismatch",
+			message: "Agent host and parent workflow must share one WorkflowEngine Layer"
+		});
+		const name = yield* Schema.decodeUnknownEffect(Schema.NonEmptyString)(options.name).pipe(Effect.mapError(() => new WorkflowExecutionFailure({
+			reason: "invalid-name",
+			message: "Workflow agent steps need a nonempty stable name"
+		})));
+		const completion = workflowCompletion(`effect-agent/${name}`);
+		const completionToken = yield* DurableDeferred.token(completion);
+		const identity = yield* digestJson([
+			config.deploymentId,
+			config.principal,
+			completionToken
+		]).pipe(Effect.provideService(Crypto.Crypto, crypto));
+		if (!(yield* Ref.get(admission))) return yield* new WorkflowAdmissionClosed({ message: "The Workflow host is shutting down" });
+		const receipt = yield* runtime.submitRegistered({ definition: agent }, input, {
+			threadId: ThreadId.make(`workflow/${identity}`),
+			idempotencyKey: IdempotencyKey.make(identity),
+			principal: config.principal
+		});
+		yield* Effect.annotateCurrentSpan({
+			"agent.submission.id": receipt.submissionId,
+			"agent.workflow.step": name
+		});
+		yield* runtime.submissionStatus(receipt);
+		yield* dispatchIntent(new WorkflowDispatchIntent({
+			...yield* intentFor(receipt),
+			completionToken
+		}));
+		const reference = yield* DurableDeferred.await(completion);
+		const record = yield* runtime.settlementRecord(receipt);
+		if (reference.submissionId !== receipt.submissionId || reference.threadId !== receipt.threadId || reference.settlementId !== record.settlementId) return yield* new WorkflowDispatchError({
+			operation: "result",
+			message: "Workflow completion disagrees with canonical Settlement"
+		});
+		if (record.outcome === "failed") return yield* new WorkflowExecutionFailure({
+			reason: "failed",
+			message: "Agent submission failed",
+			receipt,
+			failure: record.result
+		});
+		if (record.outcome === "aborted") return yield* new WorkflowExecutionFailure({
+			reason: "aborted",
+			message: "Agent submission was aborted",
+			receipt
+		});
+		if (record.result === void 0) return yield* new WorkflowExecutionFailure({
+			reason: "missing-output",
+			message: "Completed submission has no independent output",
+			receipt
+		});
+		return yield* Schema.decodeUnknownEffect(agent.output)(record.result).pipe(Effect.mapError((cause) => new AgentOutputError({ message: `Cannot decode canonical agent output: ${cause.message}` })));
+	});
+	return WorkflowAgentHost.of({
+		execute,
+		submit,
+		awaitSettlement: runtime.awaitSettlement,
+		observe: runtime.observe,
+		abort: runtime.abort,
+		resolveApproval: runtime.resolveApproval,
+		resolveUnknown: runtime.resolveUnknown,
+		submissionStatus: runtime.submissionStatus,
+		repair,
+		executionId: Effect.fn("WorkflowAgentHost.executionId")((receipt) => intentFor(receipt).pipe(Effect.map((intent) => intent.executionId)))
+	});
+});
+/**
+* Optional engine-independent host. Supply the upstream WorkflowEngine, the existing
+* durable runtime and ledger, durable dispatch storage, and a host-owned repair trigger.
+* Do not also start the ordinary Node worker loop. Waiter interruption only detaches;
+* abort and resolutions retain the runtime's authorization and durable intent protocol.
+*/
+var WorkflowAgentHost = class WorkflowAgentHost extends Context.Service()("@effect-agent/workflow/WorkflowAgentHost") {
+	/** Drive the injected runtime, whose Layer owns executable registrations and their services. */
+	static layer(options) {
+		return Layer.effect(WorkflowAgentHost)(makeHost(options));
+	}
+};
+//#endregion
+export { WorkflowHostConfigError as i, WorkflowAgentHost as n, WorkflowAgentHost_exports as r, WorkflowAdmissionClosed as t };
+
+//# sourceMappingURL=WorkflowAgentHost-DOGuS1cg.mjs.map

package/dist/WorkflowAgentHost-DOGuS1cg.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowAgentHost-DOGuS1cg.mjs","names":[],"sources":["../src/internal/completion.ts","../src/WorkflowAgentHost.ts"],"sourcesContent":["import { DurableDeferred } from \"effect/unstable/workflow\";\n\nimport { WorkflowSettlementReference } from \"../WorkflowDispatch.ts\";\n\n/** Native deferred results contain only canonical identities, never a second agent result. */\nexport const workflowCompletion = (name: string) =>\n  DurableDeferred.make(name, { success: WorkflowSettlementReference });\n","import { AgentOutputError } from \"@effect-agent/core/AgentError\";\nimport { ThreadId } from \"@effect-agent/core/Identifiers\";\nimport { type BindingUnavailable } from \"@effect-agent/thread/AgentRegistration\";\nimport { digestJson } from \"@effect-agent/thread/Digest\";\nimport {\n  DurableAgentRuntime,\n  DurableRuntimeConfig,\n  Receipt,\n  type DurableAwaitFailure,\n  type DurableSubmitAgent,\n  type DurableSubmitFailure,\n  type DurableSubmitOptions,\n} from \"@effect-agent/thread/DurableAgentRuntime\";\nimport { DeploymentId } from \"@effect-agent/thread/Records\";\nimport {\n  IdempotencyKey,\n  Principal,\n  SubmissionLedger,\n  SubmissionLookupById,\n} from \"@effect-agent/thread/SubmissionLedger\";\nimport {\n  Cause,\n  Context,\n  Crypto,\n  Effect,\n  Exit,\n  Layer,\n  Option,\n  RcMap,\n  Ref,\n  Result,\n  Schema,\n  Semaphore,\n  Stream,\n} from \"effect\";\nimport { DurableDeferred, Workflow, WorkflowEngine } from \"effect/unstable/workflow\";\n\nimport { workflowCompletion } from \"./internal/completion.ts\";\nimport {\n  WorkflowDispatchError,\n  WorkflowDispatchFailpoint,\n  WorkflowDispatchIntent,\n  WorkflowDispatchScan,\n  WorkflowDispatchStore,\n  WorkflowRepairReport,\n  WorkflowRepairTrigger,\n  WorkflowSettlementReference,\n  WorkflowSubmission,\n} from \"./WorkflowDispatch.ts\";\nimport {\n  WorkflowExecutionFailure,\n  type WorkflowAgent,\n  type WorkflowExecuteOptions,\n} from \"./WorkflowExecution.ts\";\n\nconst WorkflowHostConfig = Schema.Struct({\n  deploymentId: DeploymentId,\n  principal: Principal,\n  workflowName: Schema.NonEmptyString,\n  executionConcurrency: Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 64 })),\n  repairBatchSize: Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 1000 })),\n  dispatchTimeoutMillis: Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 300_000 })),\n});\n\nexport class WorkflowHostConfigError extends Schema.TaggedError<WorkflowHostConfigError>()(\n  \"WorkflowHostConfigError\",\n  { message: Schema.String },\n) {}\n\nexport class WorkflowAdmissionClosed extends Schema.TaggedError<WorkflowAdmissionClosed>()(\n  \"WorkflowAdmissionClosed\",\n  { message: Schema.String },\n) {}\n\nexport interface WorkflowAgentHostOptions {\n  readonly deploymentId: string;\n  /** Application-owned identity for submissions from AgentWorkflow.execute. */\n  readonly principal: string;\n  /** Stable versioned name prefix. The native name also includes deploymentId. */\n  readonly workflowName?: string;\n  /** Concurrent Attempts within this host Layer instance, not a fleet-wide limit. Default 1. */\n  readonly executionConcurrency?: number;\n  /** Maximum entries per scan per repair invocation. Default 32. */\n  readonly repairBatchSize?: number;\n  /** Bound each dispatch or scan, including a retrying native engine. Default 10000 ms. */\n  readonly dispatchTimeoutMillis?: number;\n}\n\nexport type WorkflowRepairFailure = WorkflowDispatchError | DurableAwaitFailure;\n\nconst nativeOperation = <A, E, R>(operation: string, effect: Effect.Effect<A, E, R>) =>\n  effect.pipe(\n    Effect.catchDefect((cause) =>\n      Effect.fail(\n        new WorkflowDispatchError({\n          operation,\n          message: \"Workflow engine operation failed\",\n          cause,\n        }),\n      ),\n    ),\n  );\n\nconst makeHost = Effect.fn(\"WorkflowAgentHost.make\")(function* (options: WorkflowAgentHostOptions) {\n  const config = yield* Schema.decodeUnknownEffect(WorkflowHostConfig)({\n    deploymentId: options.deploymentId,\n    principal: options.principal,\n    workflowName: options.workflowName ?? \"effect-agent/Submission/v1\",\n    executionConcurrency: options.executionConcurrency ?? 1,\n    repairBatchSize: options.repairBatchSize ?? 32,\n    dispatchTimeoutMillis: options.dispatchTimeoutMillis ?? 10_000,\n  }).pipe(Effect.mapError((error) => new WorkflowHostConfigError({ message: error.message })));\n\n  const runtime = yield* DurableAgentRuntime;\n  const crypto = yield* Crypto.Crypto;\n  const runtimeConfig = yield* DurableRuntimeConfig;\n  const ledger = yield* SubmissionLedger;\n  const engine = yield* WorkflowEngine.WorkflowEngine;\n  const dispatch = yield* WorkflowDispatchStore;\n  const trigger = yield* WorkflowRepairTrigger;\n  const failpoint = yield* WorkflowDispatchFailpoint;\n\n  if (runtimeConfig.deploymentId !== config.deploymentId) {\n    return yield* new WorkflowHostConfigError({\n      message: \"Workflow and durable runtime deploymentId must match\",\n    });\n  }\n  const permits = yield* Semaphore.make(config.executionConcurrency);\n  const lanes = yield* RcMap.make({ lookup: (_threadId: ThreadId) => Semaphore.make(1) });\n  const repairPermit = yield* Semaphore.make(1);\n  const admission = yield* Ref.make(true);\n  const nativeName = `${config.workflowName}/deployment/${config.deploymentId.length}:${config.deploymentId}`;\n\n  const workflow = Workflow.make(nativeName, {\n    payload: WorkflowSubmission,\n    success: WorkflowSettlementReference,\n    idempotencyKey: ({ deploymentId, receipt }) =>\n      `v1/${deploymentId.length}:${deploymentId}/${receipt.submissionId}`,\n  }).annotate(Workflow.SuspendOnFailure, true);\n\n  const bounded = <A, E, R>(operation: string, effect: Effect.Effect<A, E, R>) =>\n    nativeOperation(operation, effect).pipe(\n      Effect.timeout(config.dispatchTimeoutMillis),\n      Effect.catchTag(\"TimeoutError\", () =>\n        Effect.fail(\n          WorkflowDispatchError.make({\n            operation,\n            message: \"Workflow dispatch operation timed out; accepted work remains recoverable\",\n          }),\n        ),\n      ),\n    );\n\n  const validateReceipt = Effect.fn(\"WorkflowAgentHost.validateReceipt\")(function* (\n    receipt: Receipt,\n  ) {\n    const found = yield* ledger.lookup(\n      SubmissionLookupById.make({ submissionId: receipt.submissionId }),\n    );\n\n    if (\n      Option.isNone(found) ||\n      found.value.deploymentId !== config.deploymentId ||\n      found.value.threadId !== receipt.threadId ||\n      found.value.receiptId !== receipt.receiptId ||\n      found.value.queueSequence !== receipt.queueSequence\n    ) {\n      return yield* WorkflowDispatchError.make({\n        operation: \"identity\",\n        message: \"Workflow Receipt does not match its authoritative deployment and Submission\",\n      });\n    }\n  });\n\n  // No Activities: rerun journal recovery directly on every native resume. The upstream\n  // failure annotation suspends infrastructure failures and defects instead of settling them.\n  yield* engine.register(\n    workflow,\n    Effect.fn(\"WorkflowAgentHost.execute\")(function* (payload, executionId) {\n      yield* Effect.annotateCurrentSpan({\n        \"workflow.execution.id\": executionId,\n        \"agent.submission.id\": payload.receipt.submissionId,\n        \"agent.thread.id\": payload.receipt.threadId,\n      });\n      if (payload.deploymentId !== config.deploymentId) {\n        return yield* Effect.die(\"Workflow payload belongs to another deployment\");\n      }\n      if (executionId !== (yield* workflow.executionId(payload))) {\n        return yield* Effect.die(\"Workflow execution identity does not match its Submission\");\n      }\n      yield* validateReceipt(payload.receipt).pipe(Effect.orDie);\n      const initial = yield* runtime.inspectSubmissionStatus(payload.receipt).pipe(Effect.orDie);\n\n      if (initial._tag === \"settled\") {\n        return new WorkflowSettlementReference({\n          version: 1,\n          submissionId: initial.settlement.submissionId,\n          threadId: payload.receipt.threadId,\n          settlementId: initial.settlement.settlementId,\n        });\n      }\n\n      const status = yield* Effect.scoped(\n        Effect.gen(function* () {\n          // Serialize recovery and processing for one Thread even when a ledger allows\n          // same-producer takeover. Followers wait without consuming a global permit.\n          const lane = yield* RcMap.get(lanes, payload.receipt.threadId);\n\n          return yield* lane.withPermit(\n            permits.withPermit(\n              Effect.scoped(\n                Effect.gen(function* () {\n                  yield* runtime.recoverSubmission(payload.receipt.submissionId);\n                  const recovered = yield* runtime.inspectSubmissionStatus(payload.receipt);\n\n                  if (recovered._tag === \"settled\") return recovered;\n                  yield* runtime.processThreadHead(payload.receipt.threadId);\n\n                  return yield* runtime.inspectSubmissionStatus(payload.receipt);\n                }),\n              ),\n            ),\n          );\n        }),\n      ).pipe(Effect.orDie);\n\n      if (status._tag === \"settled\") {\n        return new WorkflowSettlementReference({\n          version: 1,\n          submissionId: status.settlement.submissionId,\n          threadId: payload.receipt.threadId,\n          settlementId: status.settlement.settlementId,\n        });\n      }\n      // Release the permit and Attempt Scope before native suspension, whose lifetime may\n      // outlast this process. Completion is never inferred from an empty processing result.\n      const instance = yield* WorkflowEngine.WorkflowInstance;\n\n      return yield* Workflow.suspend(instance);\n    }),\n  );\n\n  const intentFor = Effect.fn(\"WorkflowAgentHost.intentFor\")(function* (receipt: Receipt) {\n    const payload = new WorkflowSubmission({\n      version: 1,\n      deploymentId: config.deploymentId,\n      receipt,\n    });\n\n    const executionId = yield* workflow.executionId(payload);\n\n    return new WorkflowDispatchIntent({\n      ...payload,\n      workflowName: nativeName,\n      executionId,\n    });\n  });\n\n  const dispatchIntent = Effect.fn(\"WorkflowAgentHost.dispatch\")(\n    function* (\n      requested: WorkflowDispatchIntent,\n    ): Effect.fn.Return<boolean, WorkflowRepairFailure> {\n      let intent = requested;\n      const expected = yield* intentFor(intent.receipt);\n\n      if (\n        intent.executionId !== expected.executionId ||\n        intent.deploymentId !== expected.deploymentId ||\n        intent.workflowName !== expected.workflowName\n      ) {\n        return yield* new WorkflowDispatchError({\n          operation: \"dispatch\",\n          message: \"Dispatch identity does not match the configured Workflow\",\n        });\n      }\n      yield* validateReceipt(intent.receipt);\n      yield* failpoint.hit(\"intent:before-persist\", intent);\n      intent = yield* dispatch.put(intent);\n      yield* failpoint.hit(\"intent:after-persist\", intent);\n      yield* failpoint.hit(\"launch:before\", intent);\n      // Submission lifetime belongs to the durable host. Strip the optional parent\n      // instance so upstream child interruption cannot cancel this recovery workflow.\n      yield* nativeOperation(\n        \"execute\",\n        engine\n          .execute(workflow, {\n            executionId: intent.executionId,\n            payload: new WorkflowSubmission(intent),\n            discard: true,\n          })\n          .pipe(\n            Effect.updateContext((context: Context.Context<never>) =>\n              Context.omit(WorkflowEngine.WorkflowInstance)(context),\n            ),\n          ),\n      );\n      yield* failpoint.hit(\"launch:after\", intent);\n      // Resume before suspension may be a no-op. Keep the intent and retry on a later trigger.\n      yield* nativeOperation(\"resume\", engine.resume(workflow, intent.executionId));\n      yield* failpoint.hit(\"completion:before-observe\", intent);\n      const result = yield* nativeOperation(\"poll\", engine.poll(workflow, intent.executionId));\n\n      yield* failpoint.hit(\"completion:after-observe\", intent);\n      if (Option.isNone(result) || result.value._tag !== \"Complete\") return false;\n      if (Exit.isFailure(result.value.exit)) {\n        return yield* new WorkflowDispatchError({\n          operation: \"completion\",\n          message: \"Native Workflow completed without a Settlement reference; intent retained\",\n          cause: result.value.exit.cause,\n        });\n      }\n      const status = yield* runtime.inspectSubmissionStatus(intent.receipt);\n      const reference = result.value.exit.value;\n\n      if (\n        status._tag !== \"settled\" ||\n        reference.version !== 1 ||\n        reference.submissionId !== intent.receipt.submissionId ||\n        reference.threadId !== intent.receipt.threadId ||\n        reference.settlementId !== status.settlement.settlementId\n      ) {\n        return yield* new WorkflowDispatchError({\n          operation: \"completion\",\n          message: \"Native completion disagrees with canonical Settlement; intent retained\",\n        });\n      }\n      if (intent.completionToken !== undefined) {\n        yield* failpoint.hit(\"completion:before-notify\", intent);\n        yield* nativeOperation(\n          \"notify\",\n          DurableDeferred.succeed(workflowCompletion(\"settlement\"), {\n            token: intent.completionToken,\n            value: reference,\n          }).pipe(Effect.provideService(WorkflowEngine.WorkflowEngine, engine)),\n        );\n        yield* failpoint.hit(\"completion:after-notify\", intent);\n      }\n      yield* failpoint.hit(\"cleanup:before\", intent);\n      yield* dispatch.remove(intent);\n      yield* failpoint.hit(\"cleanup:after\", intent);\n\n      return true;\n    },\n    (effect) => bounded(\"dispatch\", effect),\n  );\n\n  let submissionOffset = 0;\n  let intentCursor: string | undefined;\n\n  const repair = repairPermit.withPermit(\n    Effect.gen(function* () {\n      // Respect adapter ordering, which may differ from JavaScript string comparison.\n      // Deletions may defer a row until the next wrap; restarts repeat idempotent work.\n      const discovery = yield* bounded(\n        \"scanSubmissions\",\n        ledger.scanNonterminal.pipe(\n          Stream.filter((row) => row.deploymentId === config.deploymentId),\n          Stream.drop(submissionOffset),\n          Stream.take(config.repairBatchSize),\n          Stream.runCollect,\n        ),\n      ).pipe(Effect.result);\n\n      const submissions = Result.isSuccess(discovery) ? discovery.success : [];\n\n      if (Result.isSuccess(discovery)) {\n        submissionOffset =\n          submissions.length < config.repairBatchSize ? 0 : submissionOffset + submissions.length;\n      }\n\n      const discovered = yield* Effect.forEach(submissions, (row) =>\n        Effect.flatMap(intentFor(new Receipt(row)), dispatchIntent).pipe(Effect.result),\n      );\n\n      const outstanding = yield* bounded(\n        \"scanIntents\",\n        dispatch.scan(\n          new WorkflowDispatchScan({\n            deploymentId: config.deploymentId,\n            workflowName: nativeName,\n            ...(intentCursor === undefined ? {} : { after: intentCursor }),\n            limit: config.repairBatchSize,\n          }),\n        ),\n      ).pipe(Effect.result);\n\n      const intents = Result.isSuccess(outstanding) ? outstanding.success : [];\n\n      if (Result.isSuccess(outstanding))\n        intentCursor =\n          intents.length < config.repairBatchSize\n            ? undefined\n            : intents[intents.length - 1]?.executionId;\n\n      const inspected = yield* Effect.forEach(intents, (intent) =>\n        dispatchIntent(intent).pipe(Effect.result),\n      );\n\n      const results = [...discovered, ...inspected];\n\n      if (Result.isFailure(discovery)) return yield* discovery.failure;\n      if (Result.isFailure(outstanding)) return yield* outstanding.failure;\n      const failure = results.find(Result.isFailure);\n\n      if (failure !== undefined) return yield* Effect.fail(failure.failure);\n\n      return new WorkflowRepairReport({\n        discovered: submissions.length,\n        inspected: intents.length,\n        completed: results.filter((result) => Result.isSuccess(result) && result.success).length,\n      });\n    }),\n  );\n\n  yield* trigger.register(\n    repair.pipe(\n      Effect.asVoid,\n      Effect.catchCause((cause) =>\n        Cause.hasInterruptsOnly(cause)\n          ? Effect.interrupt\n          : Effect.logError(\"Workflow dispatch repair failed; durable obligations remain\", cause),\n      ),\n    ),\n  );\n  yield* Effect.addFinalizer(() => Ref.set(admission, false));\n\n  const submit = Effect.fn(\"WorkflowAgentHost.submit\")(function* <InputSchema extends Schema.Top>(\n    agent: DurableSubmitAgent<InputSchema>,\n    input: InputSchema[\"Type\"],\n    options: DurableSubmitOptions,\n  ): Effect.fn.Return<\n    Receipt,\n    DurableSubmitFailure | WorkflowRepairFailure | WorkflowAdmissionClosed,\n    InputSchema[\"EncodingServices\"]\n  > {\n    if (!(yield* Ref.get(admission))) {\n      return yield* new WorkflowAdmissionClosed({ message: \"The Workflow host is shutting down\" });\n    }\n    const receipt = yield* runtime.submit(agent, input, options);\n\n    yield* dispatchIntent(yield* intentFor(receipt));\n\n    return receipt;\n  });\n\n  const execute = Effect.fn(\"AgentWorkflow.execute\")(function* <\n    Input extends Schema.Top,\n    Output extends Schema.Top,\n  >(agent: WorkflowAgent<Input, Output>, input: Input[\"Type\"], options: WorkflowExecuteOptions) {\n    const parentEngine = yield* WorkflowEngine.WorkflowEngine;\n\n    if (parentEngine !== engine) {\n      return yield* new WorkflowExecutionFailure({\n        reason: \"engine-mismatch\",\n        message: \"Agent host and parent workflow must share one WorkflowEngine Layer\",\n      });\n    }\n\n    const name = yield* Schema.decodeUnknownEffect(Schema.NonEmptyString)(options.name).pipe(\n      Effect.mapError(\n        () =>\n          new WorkflowExecutionFailure({\n            reason: \"invalid-name\",\n            message: \"Workflow agent steps need a nonempty stable name\",\n          }),\n      ),\n    );\n\n    const completion = workflowCompletion(`effect-agent/${name}`);\n    const completionToken = yield* DurableDeferred.token(completion);\n\n    // Agent identity and input deliberately do not participate: changing either on replay\n    // must conflict with the original admission rather than launch new external work.\n    const identity = yield* digestJson([\n      config.deploymentId,\n      config.principal,\n      completionToken,\n    ]).pipe(Effect.provideService(Crypto.Crypto, crypto));\n\n    if (!(yield* Ref.get(admission))) {\n      return yield* new WorkflowAdmissionClosed({ message: \"The Workflow host is shutting down\" });\n    }\n\n    const receipt = yield* runtime.submitRegistered({ definition: agent }, input, {\n      threadId: ThreadId.make(`workflow/${identity}`),\n      idempotencyKey: IdempotencyKey.make(identity),\n      principal: config.principal,\n    });\n\n    yield* Effect.annotateCurrentSpan({\n      \"agent.submission.id\": receipt.submissionId,\n      \"agent.workflow.step\": name,\n    });\n    yield* runtime.submissionStatus(receipt);\n    yield* dispatchIntent(\n      new WorkflowDispatchIntent({ ...(yield* intentFor(receipt)), completionToken }),\n    );\n\n    // The deferred stores only a reference. Always reauthorize and read canonical data,\n    // including on replay after the workflow engine has cached the notification.\n    const reference = yield* DurableDeferred.await(completion);\n\n    const record = yield* runtime.settlementRecord(receipt);\n\n    if (\n      reference.submissionId !== receipt.submissionId ||\n      reference.threadId !== receipt.threadId ||\n      reference.settlementId !== record.settlementId\n    ) {\n      return yield* new WorkflowDispatchError({\n        operation: \"result\",\n        message: \"Workflow completion disagrees with canonical Settlement\",\n      });\n    }\n    if (record.outcome === \"failed\") {\n      return yield* new WorkflowExecutionFailure({\n        reason: \"failed\",\n        message: \"Agent submission failed\",\n        receipt,\n        failure: record.result,\n      });\n    }\n    if (record.outcome === \"aborted\") {\n      return yield* new WorkflowExecutionFailure({\n        reason: \"aborted\",\n        message: \"Agent submission was aborted\",\n        receipt,\n      });\n    }\n    if (record.result === undefined) {\n      return yield* new WorkflowExecutionFailure({\n        reason: \"missing-output\",\n        message: \"Completed submission has no independent output\",\n        receipt,\n      });\n    }\n\n    return yield* Schema.decodeUnknownEffect(agent.output)(record.result).pipe(\n      Effect.mapError(\n        (cause) =>\n          new AgentOutputError({\n            message: `Cannot decode canonical agent output: ${cause.message}`,\n          }),\n      ),\n    );\n  });\n\n  return WorkflowAgentHost.of({\n    execute,\n    submit,\n    awaitSettlement: runtime.awaitSettlement,\n    observe: runtime.observe,\n    abort: runtime.abort,\n    resolveApproval: runtime.resolveApproval,\n    resolveUnknown: runtime.resolveUnknown,\n    submissionStatus: runtime.submissionStatus,\n    repair,\n    executionId: Effect.fn(\"WorkflowAgentHost.executionId\")((receipt: Receipt) =>\n      intentFor(receipt).pipe(Effect.map((intent) => intent.executionId)),\n    ),\n  });\n});\n\n/**\n * Optional engine-independent host. Supply the upstream WorkflowEngine, the existing\n * durable runtime and ledger, durable dispatch storage, and a host-owned repair trigger.\n * Do not also start the ordinary Node worker loop. Waiter interruption only detaches;\n * abort and resolutions retain the runtime's authorization and durable intent protocol.\n */\nexport class WorkflowAgentHost extends Context.Service<\n  WorkflowAgentHost,\n  {\n    readonly execute: <Input extends Schema.Top, Output extends Schema.Top>(\n      agent: WorkflowAgent<Input, Output>,\n      input: Input[\"Type\"],\n      options: WorkflowExecuteOptions,\n    ) => Effect.Effect<\n      Output[\"Type\"],\n      | DurableSubmitFailure\n      | BindingUnavailable\n      | DurableAwaitFailure\n      | WorkflowDispatchError\n      | WorkflowAdmissionClosed\n      | WorkflowExecutionFailure\n      | AgentOutputError,\n      | Input[\"EncodingServices\"]\n      | Output[\"DecodingServices\"]\n      | WorkflowEngine.WorkflowInstance\n      | WorkflowEngine.WorkflowEngine\n    >;\n    readonly submit: <InputSchema extends Schema.Top>(\n      agent: DurableSubmitAgent<InputSchema>,\n      input: InputSchema[\"Type\"],\n      options: DurableSubmitOptions,\n    ) => Effect.Effect<\n      Receipt,\n      DurableSubmitFailure | WorkflowRepairFailure | WorkflowAdmissionClosed,\n      InputSchema[\"EncodingServices\"]\n    >;\n    readonly awaitSettlement: DurableAgentRuntime[\"Service\"][\"awaitSettlement\"];\n    readonly observe: DurableAgentRuntime[\"Service\"][\"observe\"];\n    readonly abort: DurableAgentRuntime[\"Service\"][\"abort\"];\n    readonly resolveApproval: DurableAgentRuntime[\"Service\"][\"resolveApproval\"];\n    readonly resolveUnknown: DurableAgentRuntime[\"Service\"][\"resolveUnknown\"];\n    readonly submissionStatus: DurableAgentRuntime[\"Service\"][\"submissionStatus\"];\n    readonly repair: Effect.Effect<WorkflowRepairReport, WorkflowRepairFailure>;\n    readonly executionId: (receipt: Receipt) => Effect.Effect<string>;\n  }\n>()(\"@effect-agent/workflow/WorkflowAgentHost\") {\n  /** Drive the injected runtime, whose Layer owns executable registrations and their services. */\n  static layer(options: WorkflowAgentHostOptions) {\n    return Layer.effect(WorkflowAgentHost)(makeHost(options));\n  }\n}\n"],"mappings":"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"}

package/dist/WorkflowAgentHost.d.mts

@@ -0,0 +1,58 @@
+import { WorkflowDispatchError, WorkflowDispatchStore, WorkflowRepairReport, WorkflowRepairTrigger } from "./WorkflowDispatch.mjs";
+import { WorkflowAgent, WorkflowExecuteOptions, WorkflowExecutionFailure } from "./WorkflowExecution.mjs";
+import { AgentOutputError } from "@effect-agent/core/AgentError";
+import { BindingUnavailable } from "@effect-agent/thread/AgentRegistration";
+import { SubmissionLedger } from "@effect-agent/thread/SubmissionLedger";
+import { Cause, Context, Crypto, Effect, Layer, Schema } from "effect";
+import { DurableAgentRuntime, DurableAwaitFailure, DurableRuntimeConfig, DurableSubmitAgent, DurableSubmitFailure, DurableSubmitOptions, Receipt } from "@effect-agent/thread/DurableAgentRuntime";
+import { WorkflowEngine } from "effect/unstable/workflow";
+declare namespace WorkflowAgentHost_d_exports {
+  export { WorkflowAdmissionClosed, WorkflowAgentHost, WorkflowAgentHostOptions, WorkflowHostConfigError, WorkflowRepairFailure };
+}
+declare const WorkflowHostConfigError_base: Schema.Class<WorkflowHostConfigError, Schema.TaggedStruct<"WorkflowHostConfigError", {
+  readonly message: Schema.String;
+}>, Cause.YieldableError>;
+declare class WorkflowHostConfigError extends WorkflowHostConfigError_base {}
+declare const WorkflowAdmissionClosed_base: Schema.Class<WorkflowAdmissionClosed, Schema.TaggedStruct<"WorkflowAdmissionClosed", {
+  readonly message: Schema.String;
+}>, Cause.YieldableError>;
+declare class WorkflowAdmissionClosed extends WorkflowAdmissionClosed_base {}
+interface WorkflowAgentHostOptions {
+  readonly deploymentId: string;
+  /** Application-owned identity for submissions from AgentWorkflow.execute. */
+  readonly principal: string;
+  /** Stable versioned name prefix. The native name also includes deploymentId. */
+  readonly workflowName?: string;
+  /** Concurrent Attempts within this host Layer instance, not a fleet-wide limit. Default 1. */
+  readonly executionConcurrency?: number;
+  /** Maximum entries per scan per repair invocation. Default 32. */
+  readonly repairBatchSize?: number;
+  /** Bound each dispatch or scan, including a retrying native engine. Default 10000 ms. */
+  readonly dispatchTimeoutMillis?: number;
+}
+type WorkflowRepairFailure = WorkflowDispatchError | DurableAwaitFailure;
+declare const WorkflowAgentHost_base: Context.ServiceClass<WorkflowAgentHost, "@effect-agent/workflow/WorkflowAgentHost", {
+  readonly execute: <Input extends Schema.Top, Output extends Schema.Top>(agent: WorkflowAgent<Input, Output>, input: Input["Type"], options: WorkflowExecuteOptions) => Effect.Effect<Output["Type"], DurableSubmitFailure | BindingUnavailable | DurableAwaitFailure | WorkflowDispatchError | WorkflowAdmissionClosed | WorkflowExecutionFailure | AgentOutputError, Input["EncodingServices"] | Output["DecodingServices"] | WorkflowEngine.WorkflowInstance | WorkflowEngine.WorkflowEngine>;
+  readonly submit: <InputSchema extends Schema.Top>(agent: DurableSubmitAgent<InputSchema>, input: InputSchema["Type"], options: DurableSubmitOptions) => Effect.Effect<Receipt, DurableSubmitFailure | WorkflowRepairFailure | WorkflowAdmissionClosed, InputSchema["EncodingServices"]>;
+  readonly awaitSettlement: DurableAgentRuntime["Service"]["awaitSettlement"];
+  readonly observe: DurableAgentRuntime["Service"]["observe"];
+  readonly abort: DurableAgentRuntime["Service"]["abort"];
+  readonly resolveApproval: DurableAgentRuntime["Service"]["resolveApproval"];
+  readonly resolveUnknown: DurableAgentRuntime["Service"]["resolveUnknown"];
+  readonly submissionStatus: DurableAgentRuntime["Service"]["submissionStatus"];
+  readonly repair: Effect.Effect<WorkflowRepairReport, WorkflowRepairFailure>;
+  readonly executionId: (receipt: Receipt) => Effect.Effect<string>;
+}>;
+/**
+ * Optional engine-independent host. Supply the upstream WorkflowEngine, the existing
+ * durable runtime and ledger, durable dispatch storage, and a host-owned repair trigger.
+ * Do not also start the ordinary Node worker loop. Waiter interruption only detaches;
+ * abort and resolutions retain the runtime's authorization and durable intent protocol.
+ */
+declare class WorkflowAgentHost extends WorkflowAgentHost_base {
+  /** Drive the injected runtime, whose Layer owns executable registrations and their services. */
+  static layer(options: WorkflowAgentHostOptions): Layer.Layer<WorkflowAgentHost, WorkflowHostConfigError, Crypto.Crypto | DurableAgentRuntime | DurableRuntimeConfig | SubmissionLedger | WorkflowDispatchStore | WorkflowEngine.WorkflowEngine | WorkflowRepairTrigger>;
+}
+//#endregion
+export { WorkflowAdmissionClosed, WorkflowAgentHost, WorkflowAgentHostOptions, WorkflowHostConfigError, WorkflowRepairFailure, WorkflowAgentHost_d_exports as t };
+//# sourceMappingURL=WorkflowAgentHost.d.mts.map

package/dist/WorkflowAgentHost.mjs

@@ -0,0 +1,4 @@
+import "./WorkflowDispatch.mjs";
+import { i as WorkflowHostConfigError, n as WorkflowAgentHost, t as WorkflowAdmissionClosed } from "./WorkflowAgentHost-DOGuS1cg.mjs";
+import "./WorkflowExecution.mjs";
+export { WorkflowAdmissionClosed, WorkflowAgentHost, WorkflowHostConfigError };

package/dist/WorkflowDispatch.d.mts

@@ -0,0 +1,81 @@
+import { Context, Effect, Schema, Scope } from "effect";
+import { Receipt } from "@effect-agent/thread/DurableAgentRuntime";
+declare namespace WorkflowDispatch_d_exports {
+  export { WorkflowDispatchError, WorkflowDispatchFailpoint, WorkflowDispatchFailpointLocation, WorkflowDispatchIntent, WorkflowDispatchScan, WorkflowDispatchStore, WorkflowRepairReport, WorkflowRepairTrigger, WorkflowSettlementReference, WorkflowSubmission };
+}
+declare const WorkflowSubmission_base: Schema.Class<WorkflowSubmission, Schema.Struct<{
+  readonly version: Schema.Literal<1>;
+  readonly deploymentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/thread/DeploymentId">;
+  readonly receipt: typeof Receipt;
+}>, {}>;
+/** Only identities cross the Workflow boundary; the agent journal owns the outcome. */
+declare class WorkflowSubmission extends WorkflowSubmission_base {}
+declare const WorkflowSettlementReference_base: Schema.Class<WorkflowSettlementReference, Schema.Struct<{
+  readonly version: Schema.Literal<1>;
+  readonly submissionId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/SubmissionId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly settlementId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/SettlementId">;
+}>, {}>;
+declare class WorkflowSettlementReference extends WorkflowSettlementReference_base {}
+declare const WorkflowDispatchIntent_base: Schema.Class<WorkflowDispatchIntent, Schema.Struct<{
+  readonly version: Schema.Literal<1>;
+  readonly deploymentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/thread/DeploymentId">;
+  readonly receipt: typeof Receipt;
+  readonly workflowName: Schema.NonEmptyString;
+  readonly executionId: Schema.NonEmptyString;
+  /** One workflow step owns this submission. Repair must notify it before removing the intent. */
+  readonly completionToken: Schema.optionalKey<Schema.brand<Schema.String, "~effect/workflow/DurableDeferred/Token">>;
+}>, {}>;
+/** Retained until native success has been checked against the canonical Settlement. */
+declare class WorkflowDispatchIntent extends WorkflowDispatchIntent_base {}
+declare const WorkflowDispatchError_base: Schema.Class<WorkflowDispatchError, Schema.TaggedStruct<"WorkflowDispatchError", {
+  readonly operation: Schema.String;
+  readonly message: Schema.String;
+  readonly cause: Schema.optionalKey<Schema.Defect>;
+}>, import("effect/Cause").YieldableError>;
+declare class WorkflowDispatchError extends WorkflowDispatchError_base {}
+declare const WorkflowDispatchScan_base: Schema.Class<WorkflowDispatchScan, Schema.Struct<{
+  readonly deploymentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/thread/DeploymentId">;
+  readonly workflowName: Schema.NonEmptyString;
+  readonly after: Schema.optionalKey<Schema.String>;
+  readonly limit: Schema.Int;
+}>, {}>;
+declare class WorkflowDispatchScan extends WorkflowDispatchScan_base {}
+declare const WorkflowDispatchStore_base: Context.ServiceClass<WorkflowDispatchStore, "@effect-agent/workflow/WorkflowDispatchStore", {
+  readonly put: (intent: WorkflowDispatchIntent) => Effect.Effect<WorkflowDispatchIntent, WorkflowDispatchError>;
+  readonly scan: (request: WorkflowDispatchScan) => Effect.Effect<ReadonlyArray<WorkflowDispatchIntent>, WorkflowDispatchError>;
+  readonly remove: (intent: WorkflowDispatchIntent) => Effect.Effect<void, WorkflowDispatchError>;
+}>;
+/**
+ * Adapter-private outbox. `put` returns the stored intent, preserving an existing completion
+ * token when omitted and allowing its one-time attachment. Different identities or tokens
+ * conflict. `remove` must compare the entire intent, so a concurrent token attachment cannot
+ * be lost. `scan` returns at most limit rows in executionId order, after
+ * the exclusive cursor, filtered by deployment and workflow. All writes are durable
+ * before returning. No transcript, outcome, or native engine storage belongs here.
+ */
+declare class WorkflowDispatchStore extends WorkflowDispatchStore_base {}
+declare const WorkflowRepairTrigger_base: Context.ServiceClass<WorkflowRepairTrigger, "@effect-agent/workflow/WorkflowRepairTrigger", {
+  readonly register: (repair: Effect.Effect<void>) => Effect.Effect<void, never, Scope.Scope>;
+}>;
+/**
+ * Host-owned durable repair trigger. Register before admission opens. The host must
+ * invoke repair at startup and repeatedly after lost hints or process loss. A Node
+ * deployment may use a scoped poller; other hosts may use alarms or durable jobs.
+ * Stop invoking the callback when this Scope closes. The shared driver starts no loop.
+ */
+declare class WorkflowRepairTrigger extends WorkflowRepairTrigger_base {}
+declare const WorkflowDispatchFailpointLocation: Schema.Literals<readonly ["intent:before-persist", "intent:after-persist", "launch:before", "launch:after", "completion:before-observe", "completion:after-observe", "completion:before-notify", "completion:after-notify", "cleanup:before", "cleanup:after"]>;
+type WorkflowDispatchFailpointLocation = typeof WorkflowDispatchFailpointLocation.Type;
+declare const WorkflowDispatchFailpoint: Context.Reference<{
+  readonly hit: (location: WorkflowDispatchFailpointLocation, intent: WorkflowDispatchIntent) => Effect.Effect<void, WorkflowDispatchError>;
+}>;
+declare const WorkflowRepairReport_base: Schema.Class<WorkflowRepairReport, Schema.Struct<{
+  readonly discovered: Schema.Int;
+  readonly inspected: Schema.Int;
+  readonly completed: Schema.Int;
+}>, {}>;
+declare class WorkflowRepairReport extends WorkflowRepairReport_base {}
+//#endregion
+export { WorkflowDispatchError, WorkflowDispatchFailpoint, WorkflowDispatchFailpointLocation, WorkflowDispatchIntent, WorkflowDispatchScan, WorkflowDispatchStore, WorkflowRepairReport, WorkflowRepairTrigger, WorkflowSettlementReference, WorkflowSubmission, WorkflowDispatch_d_exports as t };
+//# sourceMappingURL=WorkflowDispatch.d.mts.map