alchemy 2.0.0-beta.37 → 2.0.0-beta.39

package/bin/exec.js

@@ -28,6 +28,7 @@ import "effect/Scope";
 import * as Duration from "effect/Duration";
 import * as Exit from "effect/Exit";
 import * as Metric from "effect/Metric";
+import { createHash } from "node:crypto";
 import * as Argument from "effect/unstable/cli/Argument";
 import * as CliError from "effect/unstable/cli/CliError";
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -469,17 +470,17 @@ const effectClass = ((impl) => impl === void 0 ? (innerImpl) => effectClass(inne
 		return impl;
 	}
 	static [Symbol.iterator]() {
-		return new SingleShotGen(this);
+		return new SingleShotGen(this.asEffect());
 	}
 	static pipe(...fns) {
-		return pipeArguments(this.asEffect(), fns);
+		return pipeArguments(this, fns);
 	}
 }, impl));
 const taggedFunction = (tag$1, fn) => {
 	const overrides = {
-		asEffect: () => tag$1.asEffect(),
+		asEffect: () => tag$1,
 		[Symbol.iterator]: () => tag$1[Symbol.iterator](),
-		pipe: (...fns) => pipeArguments(tag$1.asEffect(), fns),
+		pipe: (...fns) => pipeArguments(tag$1, fns),
 		toString: () => `${tag$1.toString()}.${fn.name}`
 	};
 	return new Proxy(fn, {
@@ -516,22 +517,23 @@ const StackName = Stack.use((stack) => Effect.succeed(stack.name));
 const make$1 = (options) => (effect) => Effect.scope.pipe(Effect.flatMap((scope) => {
 	if (options.state == null) return Effect.die(/* @__PURE__ */ new Error(`Stack "${options.name}" is missing a state store. Add a \`state\` layer to the stack options, e.g.:\n  Alchemy.Stack("${options.name}", {\n    providers: Cloudflare.providers(),\n    state: Cloudflare.state(), // <-- required\n  }, ...)\nSee https://v2.alchemy.run/concepts/state-store for available state stores.`));
 	if (options.providers == null) return Effect.die(/* @__PURE__ */ new Error(`Stack "${options.name}" is missing a providers layer. Add a \`providers\` layer to the stack options, e.g.:\n  Alchemy.Stack("${options.name}", {\n    providers: Cloudflare.providers(), // <-- required\n    state: Cloudflare.state(),\n  }, ...)`));
-	return options.providers.pipe(Layer.provideMerge(options.state), Layer.provideMerge(Layer.effect(Stack, Stage.asEffect().pipe(Effect.map((stage$1) => options.stack ?? {
+	return options.providers.pipe(Layer.provideMerge(options.state), Layer.provideMerge(Layer.effect(Stack, Stage.pipe(Effect.map((stage$1) => options.stack ?? {
 		name: options.name,
 		stage: stage$1,
 		resources: {},
-		bindings: {}
+		bindings: {},
+		actions: {}
 	})))), Layer.buildWithScope(scope));
 }), Effect.flatMap((context) => Effect.all([
 	effect,
-	Stack.asEffect(),
+	Stack,
 	Effect.context()
 ]).pipe(Effect.map(([output, stack, services$1]) => ({
 	...stack,
 	output,
 	services: EffectContext.merge(services$1, context)
 })), Effect.provideContext(context))));
-const CurrentStack = Effect.serviceOption(Stack).asEffect().pipe(Effect.map(Option.getOrUndefined));
+const CurrentStack = Effect.serviceOption(Stack).pipe(Effect.map(Option.getOrUndefined));
 const platform = Layer.mergeAll(PlatformServices, FetchHttpClient.layer, Logger.layer([fileLogger("out")], { mergeWithExisting: true }), Layer.provide(ProfileLive, PlatformServices), Layer.provide(CredentialsStoreLive, PlatformServices));
 
 //#endregion
@@ -552,6 +554,7 @@ const CurrentRuntimeContext = Effect.serviceOption(RuntimeContext).pipe(Effect.m
 
 //#endregion
 //#region lib/State/State.js
+const isActionState = (s) => !!s && s.kind === "action";
 var State = class extends EffectContext.Service()("alchemy/State") {};
 
 //#endregion
@@ -577,13 +580,13 @@ var BaseExpr = class {
 		return this;
 	}
 	[Symbol.iterator]() {
-		return new SingleShotGen(this);
+		return new SingleShotGen(this.asEffect());
 	}
 	asEffect() {
 		return this.bind(this.toString());
 	}
 	bind(id) {
-		return RuntimeContext.asEffect().pipe(Effect.flatMap((ctx) => Effect.map(ctx.set(id, this), (key) => ctx.get(key))));
+		return RuntimeContext.pipe(Effect.flatMap((ctx) => Effect.map(ctx.set(id, this), (key) => ctx.get(key))));
 	}
 	pipe(...fns) {
 		return pipe(this, ...fns);
@@ -670,7 +673,7 @@ const isNamedExpr = (node) => node?.kind === "NamedExpr";
 /**
 * Wraps another `Expr` and overrides its `toString()` / inspect output.
 *
-* `BaseExpr.asEffect()` derives the binding id from `this.toString()`, so
+* `BaseExpr` derives the binding id from `this.toString()`, so
 * wrapping an expression in `NamedExpr` makes that derived id stable and
 * caller-controlled (e.g. an env var name like `"API_KEY"`).
 */
@@ -812,7 +815,7 @@ const evaluate = (expr, upstream$1) => Effect.gen(function* () {
 				stage: stage$1,
 				resourceId: expr.resourceId
 			}));
-			return resource.attr;
+			return resource.attr ?? resource.output;
 		} else if (isStackRefExpr(expr)) {
 			const state = yield* State;
 			const stack = expr.stack;
@@ -994,6 +997,19 @@ const recordOutcome = (baseAttrs, status, duration) => {
 	return Effect.all([Metric.update(Metric.withAttributes(resourceCounter, attrs), 1), Metric.update(Metric.withAttributes(resourceDuration, attrs), duration)], { discard: true });
 };
 
+//#endregion
+//#region lib/Action.js
+const isAction = (value) => typeof value === "object" && value !== null && value?.Kind === "action";
+
+//#endregion
+//#region lib/Util/hash.js
+/**
+* Stable hash of a resolved Task input. Wrapped in `Effect.sync` so the
+* call participates in the Effect runtime (tracing/interruption) per the
+* Effect-platform conventions.
+*/
+const hashInput = (input) => Effect.sync(() => createHash("sha256").update(JSON.stringify(input ?? null)).digest("hex"));
+
 //#endregion
 //#region lib/Util/scc.js
 /**
@@ -1072,6 +1088,7 @@ const findCycleMembers = (edges) => {
 const make = (stack, options = {}) => Effect.gen(function* () {
 	const state = yield* State;
 	const resources = Object.values(stack.resources);
+	const actions = Object.values(stack.actions ?? {});
 	const stackName = stack.name;
 	const stage$1 = stack.stage;
 	const shouldAdopt = Effect.gen(function* () {
@@ -1094,15 +1111,17 @@ const make = (stack, options = {}) => Effect.gen(function* () {
 	})), { concurrency: "unbounded" });
 	const resolvedResources = {};
 	const resolveResource = (resourceExpr) => Effect.gen(function* () {
+		if (isAction(resourceExpr.src)) return resourceExpr;
 		return yield* resolvedResources[resourceExpr.src.FQN] ??= yield* Effect.cached(Effect.gen(function* () {
 			const resource = resourceExpr.src;
 			const provider = yield* findProviderByType(resource.Type);
 			const props = yield* resolveInput(resource.Props);
-			const oldState = yield* state.get({
+			const persisted = yield* state.get({
 				stack: stackName,
 				stage: stage$1,
 				fqn: resource.FQN
 			});
+			const oldState = isActionState(persisted) ? void 0 : persisted;
 			if (!oldState || oldState.status === "creating") return resourceExpr;
 			const oldProps = oldState.status === "updating" ? oldState.old.props : oldState.props;
 			const oldBindings = oldState.bindings ?? [];
@@ -1160,7 +1179,7 @@ const make = (stack, options = {}) => Effect.gen(function* () {
 				stage: refStage,
 				resourceId: expr.resourceId
 			}));
-			return refState.attr;
+			return refState.attr ?? refState.output;
 		} else if (isStackRefExpr(expr)) {
 			const refStack = expr.stack;
 			const refStage = expr.stage ?? stage$1;
@@ -1180,21 +1199,28 @@ const make = (stack, options = {}) => Effect.gen(function* () {
 	});
 	const oldDownstreamDependencies = Object.fromEntries(oldResources.filter((resource) => !!resource).map((resource) => [resource.fqn, resource.downstream]));
 	const newResourceFqns = new Set(resources.map((r) => r.FQN));
-	const newUpstreamDependencies = Object.fromEntries(resources.map((resource) => [resource.FQN, Object.values(upstreamAny(resource.Props)).map((r) => r.FQN)]));
+	const newActionFqns = new Set(actions.map((t) => t.FQN));
+	const newNodeFqns = new Set([...newResourceFqns, ...newActionFqns]);
+	const newUpstreamDependencies = Object.fromEntries([...resources.map((resource) => [resource.FQN, Object.values(upstreamAny(resource.Props)).map((r) => r.FQN)]), ...actions.map((action) => [action.FQN, Object.values(upstreamAny(action.Input)).map((r) => r.FQN)])]);
 	const bindingUpstreamDependencies = Object.fromEntries(resources.map((resource) => [resource.FQN, Object.values(upstreamAny(stack.bindings[resource.FQN] ?? [])).map((r) => r.FQN)]));
-	const rawUpstreamDependencies = Object.fromEntries(resources.map((resource) => {
+	const rawUpstreamDependencies = Object.fromEntries([...resources.map((resource) => {
 		const fqn = resource.FQN;
 		const propDeps = newUpstreamDependencies[fqn] ?? [];
 		const bindDeps = bindingUpstreamDependencies[fqn] ?? [];
 		return [fqn, [...new Set([...propDeps, ...bindDeps])]];
-	}));
-	const allUpstreamDependencies = Object.fromEntries(resources.map((resource) => {
+	}), ...actions.map((action) => {
+		const fqn = action.FQN;
+		return [fqn, newUpstreamDependencies[fqn] ?? []];
+	})]);
+	const allUpstreamDependencies = Object.fromEntries([...resources.map((resource) => {
 		const fqn = resource.FQN;
-		return [fqn, (rawUpstreamDependencies[fqn] ?? []).filter((dep) => newResourceFqns.has(dep))];
-	}));
+		return [fqn, (rawUpstreamDependencies[fqn] ?? []).filter((dep) => newNodeFqns.has(dep))];
+	}), ...actions.map((action) => {
+		const fqn = action.FQN;
+		return [fqn, (newUpstreamDependencies[fqn] ?? []).filter((dep) => newNodeFqns.has(dep))];
+	})]);
 	const combinedCycleMembers = findCycleMembers(allUpstreamDependencies);
-	const newDownstreamDependencies = Object.fromEntries(resources.map((resource) => {
-		const upFqn = resource.FQN;
+	const computeDownstream = (upFqn) => {
 		const downstream = [];
 		for (const [downFqn, upstreams] of Object.entries(rawUpstreamDependencies)) {
 			if (downFqn === upFqn) continue;
@@ -1206,8 +1232,9 @@ const make = (stack, options = {}) => Effect.gen(function* () {
 			if (combinedCycleMembers.has(upFqn) && combinedCycleMembers.has(downFqn)) continue;
 			downstream.push(downFqn);
 		}
-		return [upFqn, downstream];
-	}));
+		return downstream;
+	};
+	const newDownstreamDependencies = Object.fromEntries([...resources.map((resource) => [resource.FQN, computeDownstream(resource.FQN)]), ...actions.map((action) => [action.FQN, computeDownstream(action.FQN)])]);
 	const resourceGraph = Object.fromEntries((yield* Effect.all(resources.map(Effect.fn("plan.diff.resource")(function* (resource) {
 		const provider = yield* findProviderByType(resource.Type);
 		const id = resource.LogicalId;
@@ -1215,11 +1242,12 @@ const make = (stack, options = {}) => Effect.gen(function* () {
 		const news = yield* resolveInput(resource.Props);
 		const downstream = newDownstreamDependencies[fqn] ?? [];
 		const newBindings = yield* resolveInput(stack.bindings[fqn] ?? []);
-		let oldState = yield* state.get({
+		const persisted = yield* state.get({
 			stack: stackName,
 			stage: stage$1,
 			fqn
 		});
+		let oldState = isActionState(persisted) ? void 0 : persisted;
 		let forceUpdateAfterAdoption = false;
 		if (oldState === void 0 && provider.read && isResolved(news)) {
 			const adoptInstanceId = yield* generateInstanceId();
@@ -1390,6 +1418,42 @@ const make = (stack, options = {}) => Effect.gen(function* () {
 			state: oldState
 		});
 	})), { concurrency: "unbounded" })).map((update) => [update.resource.FQN, update]));
+	const actionGraph = Object.fromEntries(yield* Effect.all(actions.map(Effect.fn("plan.diff.action")(function* (action) {
+		const fqn = action.FQN;
+		const downstream = newDownstreamDependencies[fqn] ?? [];
+		const inputHash = yield* hashInput(yield* resolveInput(action.Input));
+		const oldState = yield* state.get({
+			stack: stackName,
+			stage: stage$1,
+			fqn
+		});
+		if (oldState && !isActionState(oldState)) return [fqn, {
+			kind: "action",
+			action: "run",
+			def: action,
+			input: action.Input,
+			state: void 0,
+			downstream,
+			forced: false
+		}];
+		const prior = oldState;
+		if (prior?.status === "ran" && prior.inputHash === inputHash && !options.force) return [fqn, {
+			kind: "action",
+			action: "noop",
+			def: action,
+			state: prior,
+			downstream
+		}];
+		return [fqn, {
+			kind: "action",
+			action: "run",
+			def: action,
+			input: action.Input,
+			state: prior,
+			downstream,
+			forced: !!options.force
+		}];
+	})), { concurrency: "unbounded" }));
 	const cycleMembers = combinedCycleMembers;
 	{
 		const createReplaceNodes = new Set(Object.entries(resourceGraph).filter(([_, node]) => node.action === "create" || node.action === "replace").map(([fqn]) => fqn));
@@ -1418,16 +1482,47 @@ const make = (stack, options = {}) => Effect.gen(function* () {
 			}
 		}
 	}
+	const actionDeletions = Object.fromEntries((yield* Effect.all((yield* state.list({
+		stack: stackName,
+		stage: stage$1
+	})).map(Effect.fn("plan.diff.actionDeletion")(function* (fqn) {
+		if (newActionFqns.has(fqn) || newResourceFqns.has(fqn)) return;
+		const persisted = yield* state.get({
+			stack: stackName,
+			stage: stage$1,
+			fqn
+		});
+		if (!isActionState(persisted)) return;
+		const { logicalId } = parseFqn(fqn);
+		return [fqn, {
+			kind: "action",
+			action: "delete",
+			state: persisted,
+			downstream: persisted.downstream ?? [],
+			def: {
+				Kind: "action",
+				Namespace: persisted.namespace,
+				FQN: fqn,
+				LogicalId: logicalId,
+				Type: persisted.actionType,
+				Input: persisted.input,
+				Run: () => void 0,
+				Output: void 0
+			}
+		}];
+	})), { concurrency: "unbounded" })).filter((v) => !!v));
 	const deletions = Object.fromEntries((yield* Effect.all((yield* state.list({
 		stack: stackName,
 		stage: stage$1
 	})).map(Effect.fn("plan.diff.deletion")(function* (fqn) {
-		if (newResourceFqns.has(fqn)) return;
-		const oldState = yield* state.get({
+		if (newResourceFqns.has(fqn) || newActionFqns.has(fqn)) return;
+		const persisted = yield* state.get({
 			stack: stackName,
 			stage: stage$1,
 			fqn
 		});
+		if (isActionState(persisted)) return;
+		const oldState = persisted;
 		let attr = oldState?.attr;
 		if (oldState) {
 			const { logicalId } = parseFqn(fqn);
@@ -1480,7 +1575,9 @@ const make = (stack, options = {}) => Effect.gen(function* () {
 	}
 	return {
 		resources: resourceGraph,
+		actions: actionGraph,
 		deletions,
+		actionDeletions,
 		output: stack.output,
 		cycleMembers
 	};
@@ -1546,14 +1643,20 @@ const apply = (plan) => Effect.gen(function* () {
 	"alchemy.deletions.count": Object.keys(plan.deletions).length
 } }));
 const executePlan = Effect.fnUntraced(function* (plan, tracker, terminalStatuses, session, state, stackName, stage$1) {
-	const ready = Object.fromEntries(yield* Effect.all(Object.keys(plan.resources).map((fqn) => Effect.map(Deferred.make(), (d) => [fqn, d]))));
+	const allNodes = {
+		...plan.resources,
+		...plan.actions
+	};
+	const ready = Object.fromEntries(yield* Effect.all(Object.keys(allNodes).map((fqn) => Effect.map(Deferred.make(), (d) => [fqn, d]))));
+	const readyStable = Object.fromEntries(yield* Effect.all(Object.keys(allNodes).map((fqn) => Effect.map(Deferred.make(), (d) => [fqn, d]))));
 	const getOutputs = () => Object.fromEntries(Object.entries(tracker).map(([fqn, t]) => [fqn, t.output]));
 	const waitForDeps = (fqns) => Effect.all(fqns.filter((fqn) => fqn in ready).map((fqn) => Deferred.await(ready[fqn])), { concurrency: "unbounded" });
+	const waitForStableDeps = (fqns) => Effect.all(fqns.filter((fqn) => fqn in readyStable).map((fqn) => Deferred.await(readyStable[fqn])), { concurrency: "unbounded" });
 	const failures = [];
-	yield* Effect.all(Object.entries(plan.resources).map(([fqn, node]) => executeNode(fqn, node, tracker, ready, terminalStatuses, session, state, stackName, stage$1, getOutputs, waitForDeps, failures, plan.cycleMembers.has(fqn))), { concurrency: "unbounded" });
+	yield* Effect.all(Object.entries(allNodes).map(([fqn, node]) => node.kind === "action" ? executeActionNode(fqn, node, tracker, ready, readyStable, terminalStatuses, session, state, stackName, stage$1, getOutputs, waitForStableDeps, failures) : executeNode(fqn, node, tracker, ready, readyStable, terminalStatuses, session, state, stackName, stage$1, getOutputs, waitForDeps, failures, plan.cycleMembers.has(fqn))), { concurrency: "unbounded" });
 	if (failures.length > 0) yield* Effect.failCause(failures.map((f) => f.cause).reduce(Cause.combine));
 });
-const executeNode = (fqn, node, tracker, ready, terminalStatuses, session, state, stackName, stage$1, getOutputs, waitForDeps, failures, inCycle) => Effect.gen(function* () {
+const executeNode = (fqn, node, tracker, ready, readyStable, terminalStatuses, session, state, stackName, stage$1, getOutputs, waitForDeps, failures, inCycle) => Effect.gen(function* () {
 	const logicalId = node.resource.LogicalId;
 	const namespace = node.resource.Namespace;
 	const commit = (value) => state.set({
@@ -1587,11 +1690,13 @@ const executeNode = (fqn, node, tracker, ready, terminalStatuses, session, state
 		});
 	});
 	const signalReady = Deferred.succeed(ready[fqn], void 0);
+	const signalReadyStable = Deferred.succeed(readyStable[fqn], void 0);
 	const storeAndSignal = (t) => Effect.gen(function* () {
 		tracker[fqn] = t;
 		yield* signalReady;
 	});
 	if (node.action === "noop") {
+		yield* signalReadyStable;
 		yield* storeAndSignal({
 			output: node.state.attr,
 			props: node.state.props,
@@ -1727,6 +1832,7 @@ const executeNode = (fqn, node, tracker, ready, terminalStatuses, session, state
 				instanceId
 			};
 			yield* signalReady;
+			yield* signalReadyStable;
 			yield* markTerminal("created");
 			return;
 		}
@@ -1795,6 +1901,7 @@ const executeNode = (fqn, node, tracker, ready, terminalStatuses, session, state
 				instanceId
 			};
 			yield* signalReady;
+			yield* signalReadyStable;
 			yield* markTerminal("updated");
 			return;
 		}
@@ -1807,6 +1914,7 @@ const executeNode = (fqn, node, tracker, ready, terminalStatuses, session, state
 					instanceId
 				};
 				yield* signalReady;
+				yield* signalReadyStable;
 				yield* markTerminal("created");
 				return;
 			}
@@ -1901,6 +2009,7 @@ const executeNode = (fqn, node, tracker, ready, terminalStatuses, session, state
 				instanceId
 			};
 			yield* signalReady;
+			yield* signalReadyStable;
 			yield* markTerminal("created");
 			return;
 		}
@@ -1914,6 +2023,7 @@ const executeNode = (fqn, node, tracker, ready, terminalStatuses, session, state
 		cause
 	});
 	yield* Deferred.failCause(ready[fqn], cause);
+	yield* Deferred.failCause(readyStable[fqn], cause);
 	yield* session.emit({
 		kind: "status-change",
 		id: node.resource.LogicalId,
@@ -1926,6 +2036,104 @@ const executeNode = (fqn, node, tracker, ready, terminalStatuses, session, state
 	"alchemy.resource.logical_id": node.resource.LogicalId,
 	"alchemy.resource.action": node.action
 } }));
+const executeActionNode = (fqn, node, tracker, ready, readyStable, terminalStatuses, session, state, stackName, stage$1, getOutputs, waitForDeps, failures) => Effect.gen(function* () {
+	const task = node.def;
+	const logicalId = task.LogicalId;
+	const namespace = task.Namespace;
+	const commit = (value) => state.set({
+		stack: stackName,
+		stage: stage$1,
+		fqn,
+		value: {
+			...value,
+			namespace
+		}
+	});
+	const report = (status) => session.emit({
+		kind: "status-change",
+		id: logicalId,
+		type: task.Type,
+		status
+	});
+	const signalReady = Deferred.succeed(ready[fqn], void 0);
+	const signalReadyStable = Deferred.succeed(readyStable[fqn], void 0);
+	if (node.action === "noop") {
+		tracker[fqn] = {
+			output: node.state.output,
+			props: { __input: node.state.input },
+			bindings: [],
+			instanceId: fqn
+		};
+		yield* signalReady;
+		yield* signalReadyStable;
+		terminalStatuses.set(fqn, {
+			id: logicalId,
+			type: task.Type,
+			status: "skipped"
+		});
+		return;
+	}
+	yield* waitForDeps(Object.keys(resolveUpstream(node.input)).filter((f) => f in readyStable));
+	const outputs = getOutputs();
+	const resolvedInput = yield* evaluate(node.input, outputs);
+	const inputHashValue = yield* hashInput(resolvedInput);
+	yield* commit({
+		kind: "action",
+		status: "running",
+		fqn,
+		logicalId,
+		actionType: task.Type,
+		inputHash: inputHashValue,
+		input: resolvedInput,
+		downstream: node.downstream
+	});
+	yield* report("running");
+	const result = yield* task.Run(resolvedInput);
+	yield* commit({
+		kind: "action",
+		status: "ran",
+		fqn,
+		logicalId,
+		actionType: task.Type,
+		inputHash: inputHashValue,
+		input: resolvedInput,
+		output: result,
+		downstream: node.downstream
+	});
+	tracker[fqn] = {
+		output: result,
+		props: { __input: resolvedInput },
+		bindings: [],
+		instanceId: fqn
+	};
+	yield* signalReady;
+	yield* signalReadyStable;
+	terminalStatuses.set(fqn, {
+		id: logicalId,
+		type: task.Type,
+		status: "ran"
+	});
+}).pipe(Effect.catchCause((cause) => Effect.gen(function* () {
+	failures.push({
+		fqn,
+		logicalId: node.def.LogicalId,
+		type: node.def.Type,
+		cause
+	});
+	yield* Deferred.failCause(ready[fqn], cause);
+	yield* Deferred.failCause(readyStable[fqn], cause);
+	yield* session.emit({
+		kind: "status-change",
+		id: node.def.LogicalId,
+		type: node.def.Type,
+		status: "fail"
+	});
+})), Effect.withSpan("apply.action", { attributes: {
+	"alchemy.action.fqn": fqn,
+	"alchemy.action.type": node.def.Type,
+	"alchemy.action.logical_id": node.def.LogicalId,
+	"alchemy.action.verb": node.action
+} }));
 const converge = Effect.fnUntraced(function* (plan, tracker, terminalStatuses, session, state, stackName, stage$1) {
 	for (;;) {
 		let anyUpdated = false;
@@ -1992,6 +2200,61 @@ const converge = Effect.fnUntraced(function* (plan, tracker, terminalStatuses, s
 				status: "updated"
 			});
 		}
+		for (const [fqn, node] of Object.entries(plan.actions)) {
+			if (node.action !== "run") continue;
+			if (!tracker[fqn]) continue;
+			const outputs = Object.fromEntries(Object.entries(tracker).map(([k, t]) => [k, t.output]));
+			const newInput = yield* evaluate(node.input, outputs);
+			const newHash = yield* hashInput(newInput);
+			const oldInput = tracker[fqn].props?.__input;
+			if (newHash === (yield* hashInput(oldInput))) continue;
+			anyUpdated = true;
+			yield* state.set({
+				stack: stackName,
+				stage: stage$1,
+				fqn,
+				value: {
+					kind: "action",
+					status: "running",
+					fqn,
+					logicalId: node.def.LogicalId,
+					namespace: node.def.Namespace,
+					actionType: node.def.Type,
+					inputHash: newHash,
+					input: newInput,
+					downstream: node.downstream
+				}
+			});
+			const result = yield* node.def.Run(newInput);
+			yield* state.set({
+				stack: stackName,
+				stage: stage$1,
+				fqn,
+				value: {
+					kind: "action",
+					status: "ran",
+					fqn,
+					logicalId: node.def.LogicalId,
+					namespace: node.def.Namespace,
+					actionType: node.def.Type,
+					inputHash: newHash,
+					input: newInput,
+					output: result,
+					downstream: node.downstream
+				}
+			});
+			tracker[fqn] = {
+				output: result,
+				props: { __input: newInput },
+				bindings: [],
+				instanceId: fqn
+			};
+			terminalStatuses.set(fqn, {
+				id: node.def.LogicalId,
+				type: node.def.Type,
+				status: "ran"
+			});
+		}
 		if (!anyUpdated) break;
 	}
 });
@@ -1999,6 +2262,25 @@ const collectGarbage = Effect.fnUntraced(function* (plan, session) {
 	const state = yield* State;
 	const stackName = (yield* Stack).name;
 	const stage$1 = yield* Stage;
+	yield* Effect.all(Object.entries(plan.actionDeletions ?? {}).map(([fqn, node]) => node === void 0 ? Effect.void : Effect.gen(function* () {
+		yield* session.emit({
+			kind: "status-change",
+			id: node.def.LogicalId,
+			type: node.def.Type,
+			status: "deleting"
+		});
+		yield* state.delete({
+			stack: stackName,
+			stage: stage$1,
+			fqn
+		});
+		yield* session.emit({
+			kind: "status-change",
+			id: node.def.LogicalId,
+			type: node.def.Type,
+			status: "deleted"
+		});
+	})), { concurrency: "unbounded" });
 	const deleteGraph = Effect.fnUntraced(function* (deletionGraph) {
 		const deletions = {};
 		const deleteResource = (node, ancestors = /* @__PURE__ */ new Set()) => Effect.gen(function* () {
@@ -2153,10 +2435,10 @@ var __rewriteRelativeImportExtension = void 0 && (void 0).__rewriteRelativeImpor
 	return path$1;
 };
 const USER = Config.string("USER").pipe(Config.orElse(() => Config.string("USERNAME")), Config.withDefault("unknown"));
-const STAGE = Config.string("stage").pipe(Config.option, (a) => a.asEffect(), Effect.map(Option.getOrUndefined));
+const STAGE = Config.string("stage").pipe(Config.option, (a) => a, Effect.map(Option.getOrUndefined));
 const stage = Flag.string("stage").pipe(Flag.withSchema(S.String.check(S.isPattern(/^[a-z0-9]+([-_a-z0-9]+)*$/gi))), Flag.withDescription("Stage to deploy to, defaults to dev_${USER}"), Flag.optional, Flag.map(Option.getOrUndefined), Flag.mapEffect(Effect.fn(function* (stage$1) {
 	if (stage$1) return stage$1;
-	return yield* STAGE.pipe(Effect.catch(() => Effect.fail(new CliError.MissingOption({ option: "stage" }))), Effect.flatMap((s) => s === void 0 ? USER.asEffect().pipe(Effect.map((user) => `dev_${user}`), Effect.catch(() => Effect.succeed("unknown"))) : Effect.succeed(s)));
+	return yield* STAGE.pipe(Effect.catch(() => Effect.fail(new CliError.MissingOption({ option: "stage" }))), Effect.flatMap((s) => s === void 0 ? USER.pipe(Effect.map((user) => `dev_${user}`), Effect.catch(() => Effect.succeed("unknown"))) : Effect.succeed(s)));
 })));
 const envFile = Flag.file("env-file").pipe(Flag.optional, Flag.withDescription("File to load environment variables from, defaults to .env"));
 const dryRun = Flag.boolean("dry-run").pipe(Flag.withDescription("Dry run the deployment, do not actually deploy"), Flag.withDefault(false));
@@ -2219,7 +2501,7 @@ const stackSpanAttrs = (args) => ({
 const adopt = Flag.boolean("adopt").pipe(Flag.withDescription("Adopt pre-existing cloud resources that conflict with this stack instead of failing. Useful for re-importing infrastructure into a fresh state store."), Flag.withDefault(false));
 const execStack = Effect.fn(function* ({ main, stage: stage$1, envFile: envFile$1, profile: profile$1, dryRun: dryRun$1 = false, force: force$1 = false, yes: yes$1 = false, destroy = false, dev = false, adopt: adopt$1 = false }) {
 	const stackEffect = yield* importStack(main);
-	const services$1 = Layer.mergeAll(Layer.effect(AlchemyContext, AlchemyContext.asEffect().pipe(Effect.map((ctx) => ({
+	const services$1 = Layer.mergeAll(Layer.effect(AlchemyContext, AlchemyContext.pipe(Effect.map((ctx) => ({
 		...ctx,
 		dev,
 		adopt: adopt$1
@@ -2373,12 +2655,13 @@ const LoggingCli = Layer.succeed(Cli, Cli.of({
 
 //#endregion
 //#region lib/Cli/NamespaceTree.js
-function buildNamespaceTree(items) {
+function buildNamespaceTree(items, actions = []) {
 	const root = {
 		id: "",
 		path: [],
 		children: /* @__PURE__ */ new Map(),
-		resources: []
+		resources: [],
+		actions: []
 	};
 	const getNode = (path$1) => {
 		let current = root;
@@ -2390,7 +2673,8 @@ function buildNamespaceTree(items) {
 					id: segment,
 					path: path$1.slice(0, i + 1),
 					children: /* @__PURE__ */ new Map(),
-					resources: []
+					resources: [],
+					actions: []
 				};
 				current.children.set(segment, child);
 			}
@@ -2399,11 +2683,13 @@ function buildNamespaceTree(items) {
 		return current;
 	};
 	for (const item of items) getNode(toPath(item.resource.Namespace)).resources.push(item);
+	for (const action of actions) getNode(toPath(action.def.Namespace)).actions.push(action);
 	return root;
 }
 function deriveNamespaceAction(node) {
 	const actions = /* @__PURE__ */ new Set();
 	for (const resource of node.resources) actions.add(deriveResourceChildrenAction(resource, node));
+	for (const action of node.actions) actions.add(action.action === "run" ? "create" : action.action === "delete" ? "delete" : "noop");
 	for (const child of node.children.values()) {
 		const childAction = deriveNamespaceAction(child);
 		if (childAction === "mixed") return "mixed";
@@ -2456,8 +2742,17 @@ const flattenNamespace = (node, depth, result) => {
 		});
 		if (childNamespace) flattenNamespace(childNamespace, depth + 1, result);
 	}
+	const sortedActions = [...node.actions].sort((a, b) => a.def.LogicalId.localeCompare(b.def.LogicalId));
+	for (const action of sortedActions) result.push({
+		type: "action",
+		depth,
+		id: action.def.LogicalId,
+		path: [...node.path, action.def.LogicalId],
+		action: action.action,
+		actionType: action.def.Type
+	});
 };
-const isEmpty = (node) => node.resources.length === 0 && Array.from(node.children.values()).every(isEmpty);
+const isEmpty = (node) => node.resources.length === 0 && node.actions.length === 0 && Array.from(node.children.values()).every(isEmpty);
 const deriveResourceChildrenAction = (resource, node) => {
 	const actions = new Set([resource.action]);
 	for (const binding of resource.bindings) actions.add(binding.action);
@@ -2478,10 +2773,11 @@ const deriveAction = (actions) => {
 //#region lib/Cli/tui/components/Plan.js
 function Plan({ plan }) {
 	const items = useMemo(() => [...Object.values(plan.resources), ...Object.values(plan.deletions)], [plan]);
+	const taskItems = useMemo(() => [...Object.values(plan.actions ?? {}), ...Object.values(plan.actionDeletions ?? {})].filter((t) => t !== void 0), [plan]);
 	const flatItems = useMemo(() => {
-		return flattenTree(buildNamespaceTree(items));
-	}, [items]);
-	if (items.length === 0) return jsx(Text, {
+		return flattenTree(buildNamespaceTree(items, taskItems));
+	}, [items, taskItems]);
+	if (items.length === 0 && taskItems.length === 0) return jsx(Text, {
 		color: "gray",
 		children: "No changes planned"
 	});
@@ -2492,12 +2788,18 @@ function Plan({ plan }) {
 		noop: 0,
 		replace: 0
 	});
+	const taskCounts = taskItems.reduce((acc, item) => (acc[item.action]++, acc), {
+		run: 0,
+		noop: 0,
+		delete: 0
+	});
 	const actions = [
 		"create",
 		"update",
 		"delete",
 		"replace"
 	].filter((action) => counts[action] > 0);
+	const taskHeaderEntries = [taskCounts.run > 0 ? `${taskCounts.run} to run` : void 0, taskCounts.delete > 0 ? `${taskCounts.delete} to drop` : void 0].filter((s) => !!s);
 	return jsxs(Box, {
 		flexDirection: "column",
 		children: [jsxs(Box, {
@@ -2508,20 +2810,20 @@ function Plan({ plan }) {
 					children: "Plan"
 				}),
 				jsx(Text, { children: ": " }),
-				actions.flatMap((action, i) => {
+				[...actions.map((action) => {
 					const count = counts[action];
-					const color = actionColor(action);
-					if (count === 0) return [];
-					const box = jsx(Box, { children: jsxs(Text, {
-						color,
+					return jsx(Box, { children: jsxs(Text, {
+						color: actionColor(action),
 						children: [
 							count,
 							" to ",
 							action
 						]
 					}) }, action);
-					return i === actions.length - 1 ? [box] : [box, jsx(Text, { children: " | " }, `${action}-separator`)];
-				})
+				}), ...taskHeaderEntries.map((label, i) => jsx(Box, { children: jsx(Text, {
+					color: "cyan",
+					children: label
+				}) }, `task-${i}`))].flatMap((box, i, arr) => i === arr.length - 1 ? [box] : [box, jsx(Text, { children: " | " }, `sep-${i}`)])
 			]
 		}), jsx(Box, {
 			flexDirection: "column",
@@ -2565,6 +2867,41 @@ function Plan({ plan }) {
 						})
 					]
 				}, key);
+				if (item.type === "action") return jsxs(Box, {
+					flexDirection: "row",
+					children: [
+						jsx(Text, { children: indent }),
+						jsx(Box, {
+							width: 2,
+							children: jsxs(Text, {
+								color,
+								children: [icon, " "]
+							})
+						}),
+						jsx(Box, { children: jsx(Text, {
+							bold: true,
+							children: item.id
+						}) }),
+						jsx(Box, {
+							marginLeft: 1,
+							children: jsxs(Text, {
+								color: "blackBright",
+								children: [
+									"(",
+									item.actionType,
+									")"
+								]
+							})
+						}),
+						jsx(Box, {
+							marginLeft: 1,
+							children: jsx(Text, {
+								color: "cyan",
+								children: "[action]"
+							})
+						})
+					]
+				}, key);
 				return jsxs(Box, {
 					flexDirection: "row",
 					children: [
@@ -2614,7 +2951,8 @@ const getActionColor = (action) => ({
 	update: "yellow",
 	delete: "red",
 	replace: "magenta",
-	mixed: "cyan"
+	mixed: "cyan",
+	run: "cyan"
 })[action] ?? "gray";
 const getActionIcon = (action) => ({
 	create: "+",
@@ -2622,7 +2960,8 @@ const getActionIcon = (action) => ({
 	delete: "-",
 	noop: "•",
 	replace: "!",
-	mixed: "*"
+	mixed: "*",
+	run: "λ"
 })[action] ?? "?";
 const actionColor = (action) => getActionColor(action);
 
@@ -2665,29 +3004,40 @@ function ApprovePlan(props) {
 //#region lib/Cli/tui/components/PlanProgress.js
 const getTaskKey = (item) => item.path.join("/");
 const buildProgressRows = (plan) => {
-	return flattenTree(buildNamespaceTree([...Object.values(plan.resources), ...Object.values(plan.deletions).filter((item) => item !== void 0)])).filter((item) => item.type !== "binding").map((item) => item.type === "namespace" ? {
-		key: getTaskKey(item),
-		type: "namespace",
-		id: item.id,
-		depth: item.depth,
-		action: item.action
-	} : {
-		key: getTaskKey(item),
-		type: "resource",
-		id: item.id,
-		depth: item.depth,
-		resourceType: item.resourceType ?? "unknown",
-		action: item.action,
-		persistedApplyStatus: item.action === "noop" ? (() => {
-			const crud = findCrudByLogicalId(plan, item.id);
-			return crud?.action === "noop" ? crud.state.status : void 0;
-		})() : void 0
+	return flattenTree(buildNamespaceTree([...Object.values(plan.resources), ...Object.values(plan.deletions).filter((item) => item !== void 0)], [...Object.values(plan.actions ?? {}), ...Object.values(plan.actionDeletions ?? {})].filter((t) => t !== void 0))).filter((item) => item.type !== "binding").map((item) => {
+		if (item.type === "namespace") return {
+			key: getTaskKey(item),
+			type: "namespace",
+			id: item.id,
+			depth: item.depth,
+			action: item.action
+		};
+		if (item.type === "action") return {
+			key: getTaskKey(item),
+			type: "task",
+			id: item.id,
+			depth: item.depth,
+			actionType: item.actionType ?? "unknown",
+			action: item.action
+		};
+		return {
+			key: getTaskKey(item),
+			type: "resource",
+			id: item.id,
+			depth: item.depth,
+			resourceType: item.resourceType ?? "unknown",
+			action: item.action,
+			persistedApplyStatus: item.action === "noop" ? (() => {
+				const crud = findCrudByLogicalId(plan, item.id);
+				return crud?.action === "noop" ? crud.state.status : void 0;
+			})() : void 0
+		};
 	});
 };
 const buildLogicalIdIndex = (rows) => {
 	const index = /* @__PURE__ */ new Map();
 	for (const row of rows) {
-		if (row.type !== "resource") continue;
+		if (row.type !== "resource" && row.type !== "task") continue;
 		const keys = index.get(row.id);
 		if (keys) keys.push(row.key);
 		else index.set(row.id, [row.key]);
@@ -2710,7 +3060,13 @@ function toPlanTask(rowOrId, planItem) {
 		updatedAt: Date.now()
 	};
 }
-const buildInitialTasks = (rows) => new Map(rows.flatMap((row) => row.type === "resource" ? [[row.key, toPlanTask(row)]] : []));
+const buildInitialTasks = (rows) => new Map(rows.flatMap((row) => row.type === "resource" ? [[row.key, toPlanTask(row)]] : row.type === "task" ? [[row.key, {
+	key: row.key,
+	id: row.id,
+	type: row.actionType,
+	status: row.action === "noop" ? "skipped" : "pending",
+	updatedAt: Date.now()
+}]] : []));
 function PlanProgress(props) {
 	const { source, plan } = props;
 	const spinner = useGlobalSpinner();
@@ -2777,6 +3133,56 @@ function PlanProgress(props) {
 					})
 				]
 			}, row.key);
+			if (row.type === "task") {
+				const t = tasks.get(row.key);
+				const status = t?.status ?? (row.action === "noop" ? "ran" : "pending");
+				const color$1 = statusColor(status);
+				const icon$1 = taskIcon(row.action, status, spinner);
+				const label = row.action === "delete" ? status === "deleted" ? "deleted" : "drop" : status === "ran" ? row.action === "noop" ? "skip" : "ran" : status === "running" ? "running" : status === "fail" ? "fail" : row.action === "noop" ? "skip" : "run";
+				return jsxs(Box, {
+					flexDirection: "column",
+					children: [jsxs(Box, {
+						flexDirection: "row",
+						children: [
+							jsx(Text, { children: indent }),
+							jsx(Box, {
+								width: 2,
+								children: jsxs(Text, {
+									color: color$1,
+									children: [icon$1, " "]
+								})
+							}),
+							jsx(Text, {
+								bold: true,
+								children: row.id
+							}),
+							jsxs(Text, {
+								dimColor: true,
+								children: [
+									" (",
+									row.actionType,
+									")"
+								]
+							}),
+							jsxs(Text, {
+								color: color$1,
+								children: [" ", label]
+							}),
+							jsxs(Text, {
+								color: "cyan",
+								dimColor: true,
+								children: [" ", "[action]"]
+							})
+						]
+					}), t?.message ? jsx(Box, {
+						paddingLeft: row.depth * 2 + 2,
+						children: jsxs(Text, {
+							dimColor: true,
+							children: ["• ", t.message]
+						})
+					}) : null]
+				}, row.key);
+			}
 			const task = tasks.get(row.key) ?? toPlanTask(row);
 			const displayStatus = getDisplayStatus(row, task.status);
 			const color = statusColor(displayStatus);
@@ -2836,17 +3242,30 @@ function statusColor(status) {
 		case "updated": return "yellow";
 		case "deleting":
 		case "deleted": return "red";
+		case "running":
+		case "ran": return "cyan";
+		case "skipped": return "gray";
 		case "fail": return "redBright";
 		default: return;
 	}
 }
+function taskIcon(action, status, spinnerChar) {
+	if (status === "running") return spinnerChar;
+	if (status === "fail") return "✗";
+	if (status === "skipped") return "•";
+	if (status === "ran") return action === "noop" ? "•" : "✓";
+	if (status === "deleted") return "✓";
+	if (action === "delete") return "-";
+	if (action === "noop") return "•";
+	return "λ";
+}
 function statusIcon(status, spinnerChar) {
 	if (isInProgress(status)) return spinnerChar;
 	if (status === "fail") return "✗";
 	return "✓";
 }
 function isInProgress(status) {
-	return status === "pending" || status === "creating" || status === "updating" || status === "deleting";
+	return status === "pending" || status === "creating" || status === "updating" || status === "deleting" || status === "running";
 }
 const spinnerFrames = [
 	"⠋",