@mysten-incubation/devstack 0.0.1 → 0.1.1

package/dist/substrate/runtime/supervisor/background-tasks.mjs

@@ -0,0 +1,144 @@
+import { SupervisorPostAcquireFailed } from "./errors.mjs";
+import { prettyErrorStructured } from "../observability/pretty-error.mjs";
+import "../observability/index.mjs";
+import { bestEffort, publish } from "./wiring.mjs";
+import { PostAcquireTaskFailed } from "../post-acquire-tasks.mjs";
+import { Cause, Effect, Exit, Fiber, Ref } from "effect";
+//#region src/substrate/runtime/supervisor/background-tasks.ts
+/** `snapshot.captureFailed` / `snapshot.captureSkipped` carry a REQUIRED
+*  `snapshotId`. When the originating command carried an id, surfaces
+*  correlate the outcome with it (the CLI's pending-capture map keys on
+*  it). When the command omitted an id there is nothing to correlate
+*  against — the CLI's bridge does NOT register a pending-capture entry
+*  for an id-less capture (`cli/wirings/up.ts` falls through to a
+*  legacy auto-ack and never keys this synthetic id) — so the minted
+*  `snap-<ts>` here only satisfies the event's required field. */
+const effectiveSnapshotId = (cmd) => cmd.snapshotId ?? `snap-${Date.now()}`;
+const runInjectedCommandHandler = (deps, cmd) => Effect.gen(function* () {
+	if (deps.commandHandler === void 0) return;
+	const publishFromHandler = (event) => publish(deps.ref, deps.hub, event);
+	const exit = yield* Effect.exit(deps.commandHandler(cmd, { publish: publishFromHandler }));
+	if (Exit.isSuccess(exit)) {
+		for (const event of exit.value) yield* publish(deps.ref, deps.hub, event);
+		return;
+	}
+	if (Cause.hasInterruptsOnly(exit.cause)) return;
+	if (cmd.tag === "snapshot.capture") yield* publish(deps.ref, deps.hub, {
+		tag: "snapshot.captureFailed",
+		snapshotId: effectiveSnapshotId(cmd),
+		...cmd.name === void 0 ? {} : { name: cmd.name },
+		summary: Cause.pretty(exit.cause).split("\n")[0] ?? "snapshot capture failed",
+		at: Date.now()
+	});
+	yield* publish(deps.ref, deps.hub, {
+		tag: "error.reported",
+		error: prettyErrorStructured(exit.cause, {
+			pluginKey: null,
+			severity: "error",
+			at: Date.now()
+		})
+	});
+	yield* deps.logger.log("supervisor", null, {
+		level: "error",
+		message: `command handler failed for ${cmd.tag}`
+	});
+}).pipe(Effect.withSpan("lifecycle.supervisor.injectedCommandHandler"));
+const startBackgroundSnapshotCapture = (deps, cmd) => Effect.gen(function* () {
+	const token = yield* Ref.updateAndGet(deps.snapshotCaptureSeq, (n) => n + 1);
+	if (!(yield* Ref.modify(deps.snapshotCaptureTask, (state) => state.tag === "idle" ? [true, {
+		tag: "starting",
+		token,
+		snapshotId: cmd.snapshotId ?? null
+	}] : [false, state]))) {
+		yield* publish(deps.ref, deps.hub, {
+			tag: "snapshot.captureSkipped",
+			reason: "already-running",
+			snapshotId: effectiveSnapshotId(cmd),
+			...cmd.name === void 0 ? {} : { name: cmd.name },
+			at: Date.now()
+		});
+		return;
+	}
+	yield* publish(deps.ref, deps.hub, {
+		tag: "snapshot.captureStarted",
+		...cmd.snapshotId === void 0 ? {} : { snapshotId: cmd.snapshotId },
+		...cmd.name === void 0 ? {} : { name: cmd.name },
+		at: Date.now()
+	});
+	const fiber = yield* runInjectedCommandHandler(deps, cmd).pipe(Effect.ensuring(Ref.update(deps.snapshotCaptureTask, (state) => state.tag !== "idle" && state.token === token ? { tag: "idle" } : state)), Effect.forkScoped);
+	yield* Ref.update(deps.snapshotCaptureTask, (state) => state.tag === "starting" && state.token === token ? {
+		tag: "running",
+		token,
+		snapshotId: cmd.snapshotId ?? null,
+		fiber
+	} : state);
+}).pipe(Effect.withSpan("lifecycle.supervisor.backgroundSnapshotCapture"));
+const requestBackgroundSnapshotInterrupt = (deps) => Effect.gen(function* () {
+	const fiber = yield* Ref.modify(deps.snapshotCaptureTask, (state) => state.tag === "running" ? [state.fiber, { tag: "idle" }] : [null, state]);
+	if (fiber !== null) yield* Fiber.interrupt(fiber);
+}).pipe(Effect.withSpan("lifecycle.supervisor.interruptSnapshotCapture"));
+const startBackgroundStackRestart = (deps, handleCommand) => Effect.gen(function* () {
+	const token = yield* Ref.updateAndGet(deps.stackRestartSeq, (n) => n + 1);
+	if (!(yield* Ref.modify(deps.stackRestartTask, (state) => state.tag === "idle" ? [true, {
+		tag: "starting",
+		token
+	}] : [false, state]))) {
+		yield* deps.logger.log("supervisor", null, {
+			level: "debug",
+			message: "stack restart skipped because one is already running"
+		});
+		return;
+	}
+	const fiber = yield* handleCommand(deps, { tag: "stack.restart" }).pipe(Effect.catch(() => Effect.void), Effect.ensuring(Ref.update(deps.stackRestartTask, (state) => state.tag !== "idle" && state.token === token ? { tag: "idle" } : state)), Effect.forkScoped);
+	yield* Ref.update(deps.stackRestartTask, (state) => state.tag === "starting" && state.token === token ? {
+		tag: "running",
+		token,
+		fiber
+	} : state);
+}).pipe(Effect.withSpan("lifecycle.supervisor.backgroundStackRestart"));
+const requestBackgroundStackRestartInterrupt = (deps) => Effect.gen(function* () {
+	const fiber = yield* Ref.modify(deps.stackRestartTask, (state) => state.tag === "running" ? [state.fiber, { tag: "idle" }] : [null, state]);
+	if (fiber !== null) yield* Fiber.interrupt(fiber);
+}).pipe(Effect.withSpan("lifecycle.supervisor.interruptStackRestart"));
+const publishHookFailure = (deps, cause, message, pluginKey = null) => Effect.gen(function* () {
+	yield* publish(deps.ref, deps.hub, {
+		tag: "error.reported",
+		error: prettyErrorStructured(cause, {
+			pluginKey,
+			severity: "error",
+			at: Date.now()
+		})
+	});
+	yield* deps.logger.log("supervisor", null, {
+		level: "error",
+		message
+	});
+});
+const findPostAcquireTaskFailure = (cause) => {
+	for (const reason of cause.reasons) {
+		if (!Cause.isFailReason(reason)) continue;
+		if (reason.error instanceof PostAcquireTaskFailed) return reason.error;
+	}
+	return null;
+};
+const runPostAcquireHook = (deps) => Effect.gen(function* () {
+	if (deps.postAcquireHook === void 0) return;
+	const exit = yield* Effect.exit(deps.postAcquireHook({
+		graph: deps.graph,
+		registry: deps.registry,
+		identity: deps.identity,
+		runtimeRoot: deps.runtimeRoot
+	}));
+	if (Exit.isSuccess(exit)) {
+		for (const event of exit.value) yield* publish(deps.ref, deps.hub, event);
+		return;
+	}
+	const taskFailure = findPostAcquireTaskFailure(exit.cause);
+	if (taskFailure !== null) yield* bestEffort(deps.registry.markFailed(taskFailure.pluginKey, taskFailure.cause));
+	yield* publishHookFailure(deps, exit.cause, taskFailure === null ? "post-acquire hook failed" : `post-acquire task failed: ${taskFailure.label}`, taskFailure?.pluginKey ?? null);
+	return yield* Effect.fail(new SupervisorPostAcquireFailed({ cause: exit.cause }));
+}).pipe(Effect.withSpan("lifecycle.supervisor.postAcquireHook"));
+//#endregion
+export { requestBackgroundSnapshotInterrupt, requestBackgroundStackRestartInterrupt, runInjectedCommandHandler, runPostAcquireHook, startBackgroundSnapshotCapture, startBackgroundStackRestart };
+
+//# sourceMappingURL=background-tasks.mjs.map

package/dist/substrate/runtime/supervisor/background-tasks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-tasks.mjs","names":[],"sources":["../../../../src/substrate/runtime/supervisor/background-tasks.ts"],"sourcesContent":["// Background tasks: injected command handler runner, snapshot capture,\n// stack restart, and post-acquire hook.\n//\n// Each background task is forked into the supervisor's parent scope so\n// it rides the supervisor's lifetime rather than the command-loop\n// fiber. Interrupt requests use a Ref-typed handle (`idle`/`starting`/\n// `running`) so a sibling command can interrupt a running task without\n// racing the fork.\n\nimport { Cause, Effect, Exit, Fiber, Ref, Scope } from 'effect';\n\nimport type { PluginKey } from '../../brand.ts';\nimport type { EngineCommand, EngineEvent } from '../../events.ts';\nimport { prettyErrorStructured } from '../observability/index.ts';\nimport { PostAcquireTaskFailed } from '../post-acquire-tasks.ts';\nimport { SupervisorPostAcquireFailed } from './errors.ts';\nimport type { SnapshotCaptureTaskState, StackRestartTaskState, SupervisorState } from './state.ts';\nimport { bestEffort, publish } from './wiring.ts';\n\n// Forward reference: the stack-restart background task runs through\n// the same `handleCommand` dispatch path that the command loop uses;\n// imports cycle if we hoist it directly, so we accept a runner from the\n// caller.\ntype HandleCommandRunner = (\n\tdeps: SupervisorState,\n\tcmd: EngineCommand,\n) => Effect.Effect<void, SupervisorPostAcquireFailed, Scope.Scope>;\n\n/** `snapshot.captureFailed` / `snapshot.captureSkipped` carry a REQUIRED\n *  `snapshotId`. When the originating command carried an id, surfaces\n *  correlate the outcome with it (the CLI's pending-capture map keys on\n *  it). When the command omitted an id there is nothing to correlate\n *  against — the CLI's bridge does NOT register a pending-capture entry\n *  for an id-less capture (`cli/wirings/up.ts` falls through to a\n *  legacy auto-ack and never keys this synthetic id) — so the minted\n *  `snap-<ts>` here only satisfies the event's required field. */\nconst effectiveSnapshotId = (\n\tcmd: Extract<EngineCommand, { readonly tag: 'snapshot.capture' }>,\n): string => cmd.snapshotId ?? `snap-${Date.now()}`;\n\nexport const runInjectedCommandHandler = (\n\tdeps: SupervisorState,\n\tcmd: EngineCommand,\n): Effect.Effect<void, never, never> =>\n\tEffect.gen(function* () {\n\t\tif (deps.commandHandler === undefined) return;\n\t\tconst publishFromHandler = (event: EngineEvent): Effect.Effect<void, never, never> =>\n\t\t\tpublish(deps.ref, deps.hub, event);\n\t\tconst exit = yield* Effect.exit(\n\t\t\tdeps.commandHandler(cmd, {\n\t\t\t\tpublish: publishFromHandler,\n\t\t\t}),\n\t\t);\n\t\tif (Exit.isSuccess(exit)) {\n\t\t\tfor (const event of exit.value) {\n\t\t\t\tyield* publish(deps.ref, deps.hub, event);\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\t\tif (Cause.hasInterruptsOnly(exit.cause)) return;\n\t\tif (cmd.tag === 'snapshot.capture') {\n\t\t\tyield* publish(deps.ref, deps.hub, {\n\t\t\t\ttag: 'snapshot.captureFailed',\n\t\t\t\tsnapshotId: effectiveSnapshotId(cmd),\n\t\t\t\t...(cmd.name === undefined ? {} : { name: cmd.name }),\n\t\t\t\tsummary: Cause.pretty(exit.cause).split('\\n')[0] ?? 'snapshot capture failed',\n\t\t\t\tat: Date.now(),\n\t\t\t});\n\t\t}\n\t\tyield* publish(deps.ref, deps.hub, {\n\t\t\ttag: 'error.reported',\n\t\t\terror: prettyErrorStructured(exit.cause, {\n\t\t\t\tpluginKey: null,\n\t\t\t\tseverity: 'error',\n\t\t\t\tat: Date.now(),\n\t\t\t}),\n\t\t});\n\t\tyield* deps.logger.log('supervisor', null, {\n\t\t\tlevel: 'error',\n\t\t\tmessage: `command handler failed for ${cmd.tag}`,\n\t\t});\n\t}).pipe(Effect.withSpan('lifecycle.supervisor.injectedCommandHandler'));\n\nexport const startBackgroundSnapshotCapture = (\n\tdeps: SupervisorState,\n\tcmd: Extract<EngineCommand, { readonly tag: 'snapshot.capture' }>,\n): Effect.Effect<void, never, Scope.Scope> =>\n\tEffect.gen(function* () {\n\t\tconst token = yield* Ref.updateAndGet(deps.snapshotCaptureSeq, (n) => n + 1);\n\t\tconst started = yield* Ref.modify(deps.snapshotCaptureTask, (state) =>\n\t\t\tstate.tag === 'idle'\n\t\t\t\t? [\n\t\t\t\t\t\ttrue,\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttag: 'starting' as const,\n\t\t\t\t\t\t\ttoken,\n\t\t\t\t\t\t\tsnapshotId: cmd.snapshotId ?? null,\n\t\t\t\t\t\t} satisfies SnapshotCaptureTaskState,\n\t\t\t\t\t]\n\t\t\t\t: [false, state],\n\t\t);\n\n\t\tif (!started) {\n\t\t\tyield* publish(deps.ref, deps.hub, {\n\t\t\t\ttag: 'snapshot.captureSkipped',\n\t\t\t\treason: 'already-running',\n\t\t\t\tsnapshotId: effectiveSnapshotId(cmd),\n\t\t\t\t...(cmd.name === undefined ? {} : { name: cmd.name }),\n\t\t\t\tat: Date.now(),\n\t\t\t});\n\t\t\treturn;\n\t\t}\n\n\t\tyield* publish(deps.ref, deps.hub, {\n\t\t\ttag: 'snapshot.captureStarted',\n\t\t\t...(cmd.snapshotId === undefined ? {} : { snapshotId: cmd.snapshotId }),\n\t\t\t...(cmd.name === undefined ? {} : { name: cmd.name }),\n\t\t\tat: Date.now(),\n\t\t});\n\n\t\tconst fiber = yield* runInjectedCommandHandler(deps, cmd).pipe(\n\t\t\tEffect.ensuring(\n\t\t\t\tRef.update(deps.snapshotCaptureTask, (state) =>\n\t\t\t\t\tstate.tag !== 'idle' && state.token === token\n\t\t\t\t\t\t? ({ tag: 'idle' } satisfies SnapshotCaptureTaskState)\n\t\t\t\t\t\t: state,\n\t\t\t\t),\n\t\t\t),\n\t\t\tEffect.forkScoped,\n\t\t);\n\n\t\tyield* Ref.update(deps.snapshotCaptureTask, (state) =>\n\t\t\tstate.tag === 'starting' && state.token === token\n\t\t\t\t? ({\n\t\t\t\t\t\ttag: 'running',\n\t\t\t\t\t\ttoken,\n\t\t\t\t\t\tsnapshotId: cmd.snapshotId ?? null,\n\t\t\t\t\t\tfiber,\n\t\t\t\t\t} satisfies SnapshotCaptureTaskState)\n\t\t\t\t: state,\n\t\t);\n\t}).pipe(Effect.withSpan('lifecycle.supervisor.backgroundSnapshotCapture'));\n\nexport const requestBackgroundSnapshotInterrupt = (\n\tdeps: Pick<SupervisorState, 'snapshotCaptureTask'>,\n): Effect.Effect<void, never, never> =>\n\tEffect.gen(function* () {\n\t\tconst fiber = yield* Ref.modify(deps.snapshotCaptureTask, (state) =>\n\t\t\tstate.tag === 'running'\n\t\t\t\t? [state.fiber, { tag: 'idle' } as SnapshotCaptureTaskState]\n\t\t\t\t: [null, state],\n\t\t);\n\t\t// Await the interrupt so a follow-up snapshot capture cannot begin\n\t\t// while the previous fiber is still inside `pauseAndCommit` /\n\t\t// `saveImages`. Mirrors `requestBackgroundStackRestartInterrupt`.\n\t\tif (fiber !== null) {\n\t\t\tyield* Fiber.interrupt(fiber);\n\t\t}\n\t}).pipe(Effect.withSpan('lifecycle.supervisor.interruptSnapshotCapture'));\n\nexport const startBackgroundStackRestart = (\n\tdeps: SupervisorState,\n\thandleCommand: HandleCommandRunner,\n): Effect.Effect<void, never, Scope.Scope> =>\n\tEffect.gen(function* () {\n\t\tconst token = yield* Ref.updateAndGet(deps.stackRestartSeq, (n) => n + 1);\n\t\tconst started = yield* Ref.modify(deps.stackRestartTask, (state) =>\n\t\t\tstate.tag === 'idle' ? [true, { tag: 'starting' as const, token }] : [false, state],\n\t\t);\n\n\t\tif (!started) {\n\t\t\tyield* deps.logger.log('supervisor', null, {\n\t\t\t\tlevel: 'debug',\n\t\t\t\tmessage: 'stack restart skipped because one is already running',\n\t\t\t});\n\t\t\treturn;\n\t\t}\n\n\t\tconst fiber = yield* handleCommand(deps, { tag: 'stack.restart' }).pipe(\n\t\t\tEffect.catch(() => Effect.void),\n\t\t\tEffect.ensuring(\n\t\t\t\tRef.update(deps.stackRestartTask, (state) =>\n\t\t\t\t\tstate.tag !== 'idle' && state.token === token\n\t\t\t\t\t\t? ({ tag: 'idle' } satisfies StackRestartTaskState)\n\t\t\t\t\t\t: state,\n\t\t\t\t),\n\t\t\t),\n\t\t\tEffect.forkScoped,\n\t\t);\n\n\t\tyield* Ref.update(deps.stackRestartTask, (state) =>\n\t\t\tstate.tag === 'starting' && state.token === token\n\t\t\t\t? ({ tag: 'running', token, fiber } satisfies StackRestartTaskState)\n\t\t\t\t: state,\n\t\t);\n\t}).pipe(Effect.withSpan('lifecycle.supervisor.backgroundStackRestart'));\n\nexport const requestBackgroundStackRestartInterrupt = (\n\tdeps: Pick<SupervisorState, 'stackRestartTask'>,\n): Effect.Effect<void, never, never> =>\n\tEffect.gen(function* () {\n\t\tconst fiber = yield* Ref.modify(deps.stackRestartTask, (state) =>\n\t\t\tstate.tag === 'running'\n\t\t\t\t? [state.fiber, { tag: 'idle' } as StackRestartTaskState]\n\t\t\t\t: [null, state],\n\t\t);\n\t\tif (fiber !== null) {\n\t\t\tyield* Fiber.interrupt(fiber);\n\t\t}\n\t}).pipe(Effect.withSpan('lifecycle.supervisor.interruptStackRestart'));\n\n// -----------------------------------------------------------------------------\n// Post-acquire hook\n// -----------------------------------------------------------------------------\n\nconst publishHookFailure = (\n\tdeps: SupervisorState,\n\tcause: Cause.Cause<unknown>,\n\tmessage: string,\n\tpluginKey: PluginKey | null = null,\n): Effect.Effect<void, never, never> =>\n\tEffect.gen(function* () {\n\t\tyield* publish(deps.ref, deps.hub, {\n\t\t\ttag: 'error.reported',\n\t\t\terror: prettyErrorStructured(cause, {\n\t\t\t\tpluginKey,\n\t\t\t\tseverity: 'error',\n\t\t\t\tat: Date.now(),\n\t\t\t}),\n\t\t});\n\t\tyield* deps.logger.log('supervisor', null, {\n\t\t\tlevel: 'error',\n\t\t\tmessage,\n\t\t});\n\t});\n\nconst findPostAcquireTaskFailure = (cause: Cause.Cause<unknown>): PostAcquireTaskFailed | null => {\n\tfor (const reason of cause.reasons) {\n\t\tif (!Cause.isFailReason(reason)) continue;\n\t\tif (reason.error instanceof PostAcquireTaskFailed) return reason.error;\n\t}\n\treturn null;\n};\n\nexport const runPostAcquireHook = (\n\tdeps: SupervisorState,\n): Effect.Effect<void, SupervisorPostAcquireFailed, never> =>\n\tEffect.gen(function* () {\n\t\tif (deps.postAcquireHook === undefined) return;\n\t\tconst exit = yield* Effect.exit(\n\t\t\tdeps.postAcquireHook({\n\t\t\t\tgraph: deps.graph,\n\t\t\t\tregistry: deps.registry,\n\t\t\t\tidentity: deps.identity,\n\t\t\t\truntimeRoot: deps.runtimeRoot,\n\t\t\t}),\n\t\t);\n\t\tif (Exit.isSuccess(exit)) {\n\t\t\tfor (const event of exit.value) {\n\t\t\t\tyield* publish(deps.ref, deps.hub, event);\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\t\tconst taskFailure = findPostAcquireTaskFailure(exit.cause);\n\t\tif (taskFailure !== null) {\n\t\t\tyield* bestEffort(deps.registry.markFailed(taskFailure.pluginKey, taskFailure.cause));\n\t\t}\n\t\tyield* publishHookFailure(\n\t\t\tdeps,\n\t\t\texit.cause,\n\t\t\ttaskFailure === null\n\t\t\t\t? 'post-acquire hook failed'\n\t\t\t\t: `post-acquire task failed: ${taskFailure.label}`,\n\t\t\ttaskFailure?.pluginKey ?? null,\n\t\t);\n\t\treturn yield* Effect.fail(new SupervisorPostAcquireFailed({ cause: exit.cause }));\n\t}).pipe(Effect.withSpan('lifecycle.supervisor.postAcquireHook'));\n"],"mappings":"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"}

package/dist/substrate/runtime/supervisor/command-loop.mjs

@@ -0,0 +1,68 @@
+import "./errors.mjs";
+import { planFullDrain } from "../lifecycle/selective-restart.mjs";
+import "../lifecycle/index.mjs";
+import { runInjectedCommandHandler, runPostAcquireHook, startBackgroundSnapshotCapture, startBackgroundStackRestart } from "./background-tasks.mjs";
+import { doSelectiveRestart } from "./teardown.mjs";
+import { handleHardKillRequested, handleShutdownRequested } from "./shutdown.mjs";
+import { allReadyOrTerminal } from "./state.mjs";
+import { Deferred, Effect, Queue, Ref } from "effect";
+//#region src/substrate/runtime/supervisor/command-loop.ts
+const maybeRunPostAcquire = (deps, options) => options.failOnPostAcquireHook === true ? runPostAcquireHook(deps) : runPostAcquireHook(deps).pipe(Effect.catch(() => Effect.void));
+const handleCommand = (deps, cmd, options = {}) => Effect.gen(function* () {
+	const { graph, registry, pluginContext, sinks, logger, identity, runtimeRoot } = deps;
+	const parentScope = yield* Effect.scope;
+	switch (cmd.tag) {
+		case "shutdown.requested":
+		case "stack.stop":
+			yield* handleShutdownRequested(deps);
+			return;
+		case "shutdown.hardKillRequested":
+			yield* handleHardKillRequested(deps, cmd);
+			return;
+		case "stack.restart": {
+			const plan = planFullDrain(graph);
+			if ((yield* doSelectiveRestart(graph, registry, deps.ref, deps.hub, new Set(plan.slice), pluginContext, sinks, logger, identity, runtimeRoot, parentScope).pipe(Effect.as(true), Effect.catch(() => Effect.succeed(false)))) && (yield* allReadyOrTerminal(graph, registry))) yield* maybeRunPostAcquire(deps, options);
+			return;
+		}
+		case "selective-restart.requested":
+			if ((yield* doSelectiveRestart(graph, registry, deps.ref, deps.hub, new Set([cmd.pluginKey]), pluginContext, sinks, logger, identity, runtimeRoot, parentScope).pipe(Effect.as(true), Effect.catch(() => Effect.succeed(false)))) && (yield* allReadyOrTerminal(graph, registry))) yield* maybeRunPostAcquire(deps, options);
+			return;
+		case "apply.requested":
+			if (cmd.pluginKey !== void 0) {
+				if ((yield* doSelectiveRestart(graph, registry, deps.ref, deps.hub, new Set([cmd.pluginKey]), pluginContext, sinks, logger, identity, runtimeRoot, parentScope).pipe(Effect.as(true), Effect.catch(() => Effect.succeed(false)))) && (yield* allReadyOrTerminal(graph, registry))) yield* maybeRunPostAcquire(deps, options);
+				return;
+			}
+			if (yield* allReadyOrTerminal(graph, registry)) yield* maybeRunPostAcquire(deps, options);
+			return;
+		case "codegen.requested":
+			if (yield* allReadyOrTerminal(graph, registry)) yield* maybeRunPostAcquire(deps, options);
+			return;
+		case "snapshot.capture":
+			yield* startBackgroundSnapshotCapture(deps, cmd);
+			return;
+		case "snapshot.restore":
+		case "snapshot.list":
+		case "snapshot.delete":
+		case "wipe.requested":
+		case "prune.requested":
+			yield* runInjectedCommandHandler(deps, cmd);
+			return;
+		case "advance-clock.requested":
+		case "stack.start": return;
+	}
+}).pipe(Effect.withSpan("lifecycle.supervisor.handleCommand"));
+const commandLoop = (deps) => Effect.gen(function* () {
+	while (true) {
+		const next = yield* Queue.take(deps.queuedCommands);
+		if (next.kind === "submitted") {
+			const exit = yield* Effect.exit(handleCommand(deps, next.submission.command, { failOnPostAcquireHook: true }));
+			yield* Deferred.succeed(next.submission.completion, exit).pipe(Effect.ignore);
+		} else if (next.command.tag === "stack.restart") yield* startBackgroundStackRestart(deps, handleCommand);
+		else yield* handleCommand(deps, next.command).pipe(Effect.catch(() => Effect.void));
+		if (yield* Ref.get(deps.shutdownLatch)) return;
+	}
+}).pipe(Effect.withSpan("lifecycle.supervisor.commandLoop"));
+//#endregion
+export { commandLoop };
+
+//# sourceMappingURL=command-loop.mjs.map

package/dist/substrate/runtime/supervisor/command-loop.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-loop.mjs","names":[],"sources":["../../../../src/substrate/runtime/supervisor/command-loop.ts"],"sourcesContent":["// Supervisor command-loop.\n//\n// One consumer of the `queuedCommands` channel. Each iteration:\n//   1. Take the next queued command (fire-and-forget OR submitted).\n//   2. Dispatch via `handleCommand`. Submitted commands carry a\n//      `completion` deferred so the publisher can await the exit.\n//   3. Re-check the shutdown latch — exit the loop when set.\n//\n// `handleCommand` switches by tag and delegates to the per-concern\n// modules (shutdown, teardown, selective-restart, background-tasks).\n\nimport { Deferred, Effect, Queue, Ref, Scope } from 'effect';\n\nimport type { EngineCommand } from '../../events.ts';\nimport {\n\trunInjectedCommandHandler,\n\trunPostAcquireHook,\n\tstartBackgroundSnapshotCapture,\n\tstartBackgroundStackRestart,\n} from './background-tasks.ts';\nimport { SupervisorPostAcquireFailed } from './errors.ts';\nimport { handleHardKillRequested, handleShutdownRequested } from './shutdown.ts';\nimport { allReadyOrTerminal, type SupervisorState } from './state.ts';\nimport { doSelectiveRestart } from './teardown.ts';\nimport { planFullDrain } from '../lifecycle/index.ts';\n\nconst maybeRunPostAcquire = (\n\tdeps: SupervisorState,\n\toptions: { readonly failOnPostAcquireHook?: boolean },\n): Effect.Effect<void, SupervisorPostAcquireFailed, never> =>\n\toptions.failOnPostAcquireHook === true\n\t\t? runPostAcquireHook(deps)\n\t\t: runPostAcquireHook(deps).pipe(Effect.catch(() => Effect.void));\n\nexport const handleCommand = (\n\tdeps: SupervisorState,\n\tcmd: EngineCommand,\n\toptions: { readonly failOnPostAcquireHook?: boolean } = {},\n): Effect.Effect<void, SupervisorPostAcquireFailed, Scope.Scope> =>\n\tEffect.gen(function* () {\n\t\tconst { graph, registry, pluginContext, sinks, logger, identity, runtimeRoot } = deps;\n\t\tconst parentScope = yield* Effect.scope;\n\t\tswitch (cmd.tag) {\n\t\t\tcase 'shutdown.requested':\n\t\t\tcase 'stack.stop': {\n\t\t\t\tyield* handleShutdownRequested(deps);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase 'shutdown.hardKillRequested': {\n\t\t\t\tyield* handleHardKillRequested(deps, cmd);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase 'stack.restart': {\n\t\t\t\tconst plan = planFullDrain(graph);\n\t\t\t\tconst restarted = yield* doSelectiveRestart(\n\t\t\t\t\tgraph,\n\t\t\t\t\tregistry,\n\t\t\t\t\tdeps.ref,\n\t\t\t\t\tdeps.hub,\n\t\t\t\t\tnew Set(plan.slice),\n\t\t\t\t\tpluginContext,\n\t\t\t\t\tsinks,\n\t\t\t\t\tlogger,\n\t\t\t\t\tidentity,\n\t\t\t\t\truntimeRoot,\n\t\t\t\t\tparentScope,\n\t\t\t\t).pipe(\n\t\t\t\t\tEffect.as(true),\n\t\t\t\t\tEffect.catch(() => Effect.succeed(false)),\n\t\t\t\t);\n\t\t\t\tif (restarted && (yield* allReadyOrTerminal(graph, registry))) {\n\t\t\t\t\tyield* maybeRunPostAcquire(deps, options);\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase 'selective-restart.requested': {\n\t\t\t\tconst restarted = yield* doSelectiveRestart(\n\t\t\t\t\tgraph,\n\t\t\t\t\tregistry,\n\t\t\t\t\tdeps.ref,\n\t\t\t\t\tdeps.hub,\n\t\t\t\t\tnew Set([cmd.pluginKey]),\n\t\t\t\t\tpluginContext,\n\t\t\t\t\tsinks,\n\t\t\t\t\tlogger,\n\t\t\t\t\tidentity,\n\t\t\t\t\truntimeRoot,\n\t\t\t\t\tparentScope,\n\t\t\t\t).pipe(\n\t\t\t\t\tEffect.as(true),\n\t\t\t\t\tEffect.catch(() => Effect.succeed(false)),\n\t\t\t\t);\n\t\t\t\tif (restarted && (yield* allReadyOrTerminal(graph, registry))) {\n\t\t\t\t\tyield* maybeRunPostAcquire(deps, options);\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase 'apply.requested': {\n\t\t\t\t// Re-acquire after watch invalidation. Caller may target a\n\t\t\t\t// specific plugin; otherwise no-op (the watcher already fed\n\t\t\t\t// `selective-restart.requested` for the affected keys).\n\t\t\t\tif (cmd.pluginKey !== undefined) {\n\t\t\t\t\tconst restarted = yield* doSelectiveRestart(\n\t\t\t\t\t\tgraph,\n\t\t\t\t\t\tregistry,\n\t\t\t\t\t\tdeps.ref,\n\t\t\t\t\t\tdeps.hub,\n\t\t\t\t\t\tnew Set([cmd.pluginKey]),\n\t\t\t\t\t\tpluginContext,\n\t\t\t\t\t\tsinks,\n\t\t\t\t\t\tlogger,\n\t\t\t\t\t\tidentity,\n\t\t\t\t\t\truntimeRoot,\n\t\t\t\t\t\tparentScope,\n\t\t\t\t\t).pipe(\n\t\t\t\t\t\tEffect.as(true),\n\t\t\t\t\t\tEffect.catch(() => Effect.succeed(false)),\n\t\t\t\t\t);\n\t\t\t\t\tif (restarted && (yield* allReadyOrTerminal(graph, registry))) {\n\t\t\t\t\t\tyield* maybeRunPostAcquire(deps, options);\n\t\t\t\t\t}\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (yield* allReadyOrTerminal(graph, registry)) {\n\t\t\t\t\tyield* maybeRunPostAcquire(deps, options);\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase 'codegen.requested': {\n\t\t\t\tif (yield* allReadyOrTerminal(graph, registry)) {\n\t\t\t\t\tyield* maybeRunPostAcquire(deps, options);\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\t\t\t// Snapshot/wipe/prune are owned by injected L3 handlers. The\n\t\t\t// supervisor keeps one consumer of the command queue and only\n\t\t\t// publishes the handler's typed events / errors.\n\t\t\tcase 'snapshot.capture':\n\t\t\t\tyield* startBackgroundSnapshotCapture(deps, cmd);\n\t\t\t\treturn;\n\t\t\tcase 'snapshot.restore':\n\t\t\tcase 'snapshot.list':\n\t\t\tcase 'snapshot.delete':\n\t\t\tcase 'wipe.requested':\n\t\t\tcase 'prune.requested':\n\t\t\t\tyield* runInjectedCommandHandler(deps, cmd);\n\t\t\t\treturn;\n\t\t\tcase 'advance-clock.requested':\n\t\t\tcase 'stack.start':\n\t\t\t\treturn;\n\t\t}\n\t}).pipe(Effect.withSpan('lifecycle.supervisor.handleCommand'));\n\nexport const commandLoop = (deps: SupervisorState): Effect.Effect<void, never, Scope.Scope> =>\n\tEffect.gen(function* () {\n\t\twhile (true) {\n\t\t\tconst next = yield* Queue.take(deps.queuedCommands);\n\t\t\tif (next.kind === 'submitted') {\n\t\t\t\tconst exit = yield* Effect.exit(\n\t\t\t\t\thandleCommand(deps, next.submission.command, { failOnPostAcquireHook: true }),\n\t\t\t\t);\n\t\t\t\tyield* Deferred.succeed(next.submission.completion, exit).pipe(Effect.ignore);\n\t\t\t} else if (next.command.tag === 'stack.restart') {\n\t\t\t\tyield* startBackgroundStackRestart(deps, handleCommand);\n\t\t\t} else {\n\t\t\t\tyield* handleCommand(deps, next.command).pipe(Effect.catch(() => Effect.void));\n\t\t\t}\n\t\t\tconst drained = yield* Ref.get(deps.shutdownLatch);\n\t\t\tif (drained) return;\n\t\t}\n\t}).pipe(Effect.withSpan('lifecycle.supervisor.commandLoop'));\n"],"mappings":";;;;;;;;;AA0BA,MAAM,uBACL,MACA,YAEA,QAAQ,0BAA0B,OAC/B,mBAAmB,KAAK,GACxB,mBAAmB,KAAK,CAAC,KAAK,OAAO,YAAY,OAAO,KAAK,CAAC;AAElE,MAAa,iBACZ,MACA,KACA,UAAwD,EAAE,KAE1D,OAAO,IAAI,aAAa;CACvB,MAAM,EAAE,OAAO,UAAU,eAAe,OAAO,QAAQ,UAAU,gBAAgB;CACjF,MAAM,cAAc,OAAO,OAAO;AAClC,SAAQ,IAAI,KAAZ;EACC,KAAK;EACL,KAAK;AACJ,UAAO,wBAAwB,KAAK;AACpC;EAED,KAAK;AACJ,UAAO,wBAAwB,MAAM,IAAI;AACzC;EAED,KAAK,iBAAiB;GACrB,MAAM,OAAO,cAAc,MAAM;AAiBjC,QAAI,OAhBqB,mBACxB,OACA,UACA,KAAK,KACL,KAAK,KACL,IAAI,IAAI,KAAK,MAAM,EACnB,eACA,OACA,QACA,UACA,aACA,YACA,CAAC,KACD,OAAO,GAAG,KAAK,EACf,OAAO,YAAY,OAAO,QAAQ,MAAM,CAAC,CACzC,MACiB,OAAO,mBAAmB,OAAO,SAAS,EAC3D,QAAO,oBAAoB,MAAM,QAAQ;AAE1C;;EAED,KAAK;AAiBJ,QAAI,OAhBqB,mBACxB,OACA,UACA,KAAK,KACL,KAAK,KACL,IAAI,IAAI,CAAC,IAAI,UAAU,CAAC,EACxB,eACA,OACA,QACA,UACA,aACA,YACA,CAAC,KACD,OAAO,GAAG,KAAK,EACf,OAAO,YAAY,OAAO,QAAQ,MAAM,CAAC,CACzC,MACiB,OAAO,mBAAmB,OAAO,SAAS,EAC3D,QAAO,oBAAoB,MAAM,QAAQ;AAE1C;EAED,KAAK;AAIJ,OAAI,IAAI,cAAc,KAAA,GAAW;AAiBhC,SAAI,OAhBqB,mBACxB,OACA,UACA,KAAK,KACL,KAAK,KACL,IAAI,IAAI,CAAC,IAAI,UAAU,CAAC,EACxB,eACA,OACA,QACA,UACA,aACA,YACA,CAAC,KACD,OAAO,GAAG,KAAK,EACf,OAAO,YAAY,OAAO,QAAQ,MAAM,CAAC,CACzC,MACiB,OAAO,mBAAmB,OAAO,SAAS,EAC3D,QAAO,oBAAoB,MAAM,QAAQ;AAE1C;;AAED,OAAI,OAAO,mBAAmB,OAAO,SAAS,CAC7C,QAAO,oBAAoB,MAAM,QAAQ;AAE1C;EAED,KAAK;AACJ,OAAI,OAAO,mBAAmB,OAAO,SAAS,CAC7C,QAAO,oBAAoB,MAAM,QAAQ;AAE1C;EAKD,KAAK;AACJ,UAAO,+BAA+B,MAAM,IAAI;AAChD;EACD,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;AACJ,UAAO,0BAA0B,MAAM,IAAI;AAC3C;EACD,KAAK;EACL,KAAK,cACJ;;EAED,CAAC,KAAK,OAAO,SAAS,qCAAqC,CAAC;AAE/D,MAAa,eAAe,SAC3B,OAAO,IAAI,aAAa;AACvB,QAAO,MAAM;EACZ,MAAM,OAAO,OAAO,MAAM,KAAK,KAAK,eAAe;AACnD,MAAI,KAAK,SAAS,aAAa;GAC9B,MAAM,OAAO,OAAO,OAAO,KAC1B,cAAc,MAAM,KAAK,WAAW,SAAS,EAAE,uBAAuB,MAAM,CAAC,CAC7E;AACD,UAAO,SAAS,QAAQ,KAAK,WAAW,YAAY,KAAK,CAAC,KAAK,OAAO,OAAO;aACnE,KAAK,QAAQ,QAAQ,gBAC/B,QAAO,4BAA4B,MAAM,cAAc;MAEvD,QAAO,cAAc,MAAM,KAAK,QAAQ,CAAC,KAAK,OAAO,YAAY,OAAO,KAAK,CAAC;AAG/E,MAAI,OADmB,IAAI,IAAI,KAAK,cAAc,CACrC;;EAEb,CAAC,KAAK,OAAO,SAAS,mCAAmC,CAAC"}

package/dist/substrate/runtime/supervisor/dispatch-contributions.mjs

@@ -0,0 +1,151 @@
+import { withPluginSpan } from "../observability/spans.mjs";
+import "../capability-sinks/index.mjs";
+import { CapabilityFactoryFailed } from "./errors.mjs";
+import "../observability/index.mjs";
+import { StrategyRegistryService } from "../strategy-registry/service.mjs";
+import { OptionalService, noopStrategyRegistry, publish } from "./wiring.mjs";
+import { Cause, Effect, Scope } from "effect";
+//#region src/substrate/runtime/supervisor/dispatch-contributions.ts
+const strategyRegistryAccess = OptionalService(StrategyRegistryService);
+/**
+* Render the underlying cause of a `ContributionSinkFailed` to a single
+* human string for the operator-facing warning log.
+*
+* `ContributionSinkFailed.cause` is `unknown` — the failing sink may
+* reject with an Effect `Cause`, a tagged domain error (e.g.
+* `RouterBootFailed`, which carries the spec-mismatch `detail`), a plain
+* `Error`, or an arbitrary value. The original wrapper only logged its
+* own generic `err.message` ("capability sink 'routable' failed") and
+* DROPPED this cause, so an operator saw a healthy-looking stack with
+* dead RPC/wallet routing and no way to learn why. This recovers the
+* real detail across all of those shapes:
+*   - `Cause` → `Cause.pretty` (full failure tree).
+*   - `Error` → `.stack ?? .message` (keeps the tag + detail; a
+*     `TaggedError`'s `toString()` includes `_tag` and its fields).
+*   - anything else → `JSON.stringify`, falling back to `String` when
+*     the value is not serializable (cyclic / BigInt).
+*/
+const formatCause = (cause) => {
+	if (Cause.isCause(cause)) return Cause.pretty(cause);
+	if (cause instanceof Error) return cause.stack ?? cause.message;
+	if (typeof cause === "string") return cause;
+	try {
+		return JSON.stringify(cause) ?? String(cause);
+	} catch {
+		return String(cause);
+	}
+};
+/**
+* Best-effort discriminator for the wrapped cause — the failing sink
+* error's `_tag` (e.g. `RouterBootFailed`) when present. Feeds the
+* additive optional `causeType` on the `dispatchFailed` event so a
+* renderer/log consumer can route on the failure category without
+* parsing the message. Returns `undefined` for untagged causes so the
+* field is simply omitted.
+*/
+const causeTagOf = (cause) => {
+	if (typeof cause === "object" && cause !== null && "_tag" in cause && typeof cause._tag === "string") return cause._tag;
+};
+/**
+* Resolve a plugin's `capabilities` field to a concrete decl tuple.
+*
+* Two accepted shapes (see `Plugin.capabilities` for the
+* authoring-side contract):
+*
+*   (a) Static — a plain `ReadonlyArray<CapabilityDecl>`. Returned
+*       as-is.
+*
+*   (b) Dynamic — a `CapabilitiesFactory<…>` function. Invoked with
+*       the resolved plugin value + the acquire context built from
+*       the supervisor's identity + runtime root. The function is
+*       called once per acquire (post-success); the returned tuple
+*       flows into `dispatchContributions` like a static one.
+*
+* The dynamic seam exists so plugins' snapshot subtrees, codegen
+* bindings, routable URLs, strategy contributions, etc. can stamp
+* the REAL chain id / package id / network alias produced by their
+* acquire body, instead of the factory-time placeholder strings the
+* static form forces.
+*
+* The substrate stays generic: this resolver doesn't know any
+* service name; the discrimination is purely structural
+* (`typeof === 'function'`).
+*/
+const resolveCapabilities = (pluginKey, field, resolved, acquireContext) => {
+	if (field === void 0) return Effect.succeed([]);
+	if (typeof field === "function") return Effect.try({
+		try: () => field(resolved, acquireContext),
+		catch: (cause) => new CapabilityFactoryFailed({
+			pluginKey,
+			message: `capability factory failed for ${pluginKey}`,
+			cause
+		})
+	});
+	return Effect.succeed(field);
+};
+/**
+* Walk a plugin's `capabilities` tuple + `errorContributions` after a
+* successful acquire, route every contribution through the
+* substrate-owned `CapabilitySinksService`. The plugin's scope is
+* provided so each sink's `addFinalizer` lands on the plugin's scope —
+* registrations reap on selective-restart / shutdown.
+*
+* The supervisor stays kind-blind: it builds the contribution union
+* (`{source: 'capability'|'error', ...}`) and the dispatch happens
+* inside the service. Unknown kinds are downgraded to no-ops here so
+* the substrate-open-by-default contract holds — plugin authors can
+* emit a custom-kind decl that is observed only by the orchestrators
+* that registered the matching sink.
+*
+* Sink failures (`ContributionSinkFailed`) are routed through a
+* separate `engine.orchestrator.dispatchFailed` event so the plugin
+* remains ready and the orchestrator's broken sink is the visible
+* fault (backlog #39).
+*/
+const dispatchContributions = (pluginKey, capabilities, errorContributions, pluginRole, identity, pluginContext, pluginScope, sinks, ref, hub) => Effect.gen(function* () {
+	const strategyRegistry = strategyRegistryAccess.read(pluginContext, noopStrategyRegistry);
+	const harvestCtx = {
+		pluginKey,
+		identity,
+		publish: (event) => publish(ref, hub, event),
+		registerStrategy: (decl) => strategyRegistry.register(decl.capabilityKey, decl.strategy, {
+			autoMounted: decl.autoMounted,
+			...decl.priority === void 0 ? {} : { priority: decl.priority }
+		})
+	};
+	const items = [...capabilities.map((decl) => ({
+		source: "capability",
+		decl
+	})), ...errorContributions.map((contribution) => ({
+		source: "error",
+		contribution
+	}))];
+	for (const item of items) {
+		const dispatch = sinks.dispatch(item, harvestCtx).pipe(Effect.catchTags({
+			UnknownContributionKind: () => Effect.void,
+			ContributionSinkFailed: (err) => Effect.gen(function* () {
+				const causeType = causeTagOf(err.cause);
+				yield* publish(ref, hub, {
+					tag: "engine.orchestrator.dispatchFailed",
+					pluginKey,
+					kind: err.kind,
+					message: err.message,
+					...causeType === void 0 ? {} : { causeType },
+					at: Date.now()
+				});
+				yield* Effect.logWarning(`capability sink '${err.kind}' failed for plugin '${pluginKey}': ${formatCause(err.cause)}`);
+			})
+		}));
+		yield* Scope.provide(dispatch, pluginScope);
+	}
+}).pipe(withPluginSpan("lifecycle.supervisor.dispatchContributions", {
+	app: identity.app,
+	stack: identity.stack,
+	network: identity.chain,
+	pluginKey,
+	role: pluginRole
+}));
+//#endregion
+export { dispatchContributions, resolveCapabilities };
+
+//# sourceMappingURL=dispatch-contributions.mjs.map

package/dist/substrate/runtime/supervisor/dispatch-contributions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-contributions.mjs","names":[],"sources":["../../../../src/substrate/runtime/supervisor/dispatch-contributions.ts"],"sourcesContent":["// Supervisor capability-dispatch path.\n//\n// Walks a plugin's `capabilities` tuple + `errorContributions` after a\n// successful acquire and routes each item through the substrate-owned\n// `CapabilitySinksService`.\n//\n// Bug-fix history (backlog #39): the original implementation only\n// caught `UnknownContributionKind` from `sinks.dispatch()`. The error\n// channel also yields `ContributionSinkFailed` (a registered sink\n// rejected while handling a known kind — router/codegen collisions,\n// upstream IO faults). The wrapping `Effect.exit` at the acquire-node\n// callsite then projected the failure through `registry.markFailed`,\n// attributing the orchestrator's bug to the plugin.\n//\n// Fix: catch BOTH tags here and route them DIFFERENTLY.\n//   - `UnknownContributionKind` → no-op (substrate-open-by-default;\n//     the plugin emitted a contribution shape no sink claims).\n//   - `ContributionSinkFailed` → publish the typed\n//     `engine.orchestrator.dispatchFailed` event + log a warning; the\n//     plugin stays ready.\n\nimport { Cause, Context, Effect, Queue, Scope, SubscriptionRef } from 'effect';\n\nimport type { CapabilityDecl } from '../../../contracts/capability-decl.ts';\nimport type { StrategyContributorDecl } from '../../../contracts/strategy-contributor.ts';\nimport type { PluginKey } from '../../brand.ts';\nimport type { EngineEvent } from '../../events.ts';\nimport type { Identity } from '../../identity.ts';\nimport type { PluginRole } from '../../lifecycle.ts';\nimport type { AcquireContext, PluginErrorContribution } from '../../plugin.ts';\nimport type { SubscribableState } from '../../projection.ts';\nimport {\n\ttype AnyContribution,\n\ttype CapabilitySinksShape,\n\ttype HarvestContext,\n} from '../capability-sinks/index.ts';\nimport { withPluginSpan } from '../observability/index.ts';\nimport { StrategyRegistryService } from '../strategy-registry/service.ts';\nimport { CapabilityFactoryFailed } from './errors.ts';\nimport { noopStrategyRegistry, OptionalService, publish } from './wiring.ts';\n\nconst strategyRegistryAccess = OptionalService(StrategyRegistryService);\n\n/**\n * Render the underlying cause of a `ContributionSinkFailed` to a single\n * human string for the operator-facing warning log.\n *\n * `ContributionSinkFailed.cause` is `unknown` — the failing sink may\n * reject with an Effect `Cause`, a tagged domain error (e.g.\n * `RouterBootFailed`, which carries the spec-mismatch `detail`), a plain\n * `Error`, or an arbitrary value. The original wrapper only logged its\n * own generic `err.message` (\"capability sink 'routable' failed\") and\n * DROPPED this cause, so an operator saw a healthy-looking stack with\n * dead RPC/wallet routing and no way to learn why. This recovers the\n * real detail across all of those shapes:\n *   - `Cause` → `Cause.pretty` (full failure tree).\n *   - `Error` → `.stack ?? .message` (keeps the tag + detail; a\n *     `TaggedError`'s `toString()` includes `_tag` and its fields).\n *   - anything else → `JSON.stringify`, falling back to `String` when\n *     the value is not serializable (cyclic / BigInt).\n */\nconst formatCause = (cause: unknown): string => {\n\tif (Cause.isCause(cause)) return Cause.pretty(cause);\n\tif (cause instanceof Error) return cause.stack ?? cause.message;\n\tif (typeof cause === 'string') return cause;\n\ttry {\n\t\treturn JSON.stringify(cause) ?? String(cause);\n\t} catch {\n\t\treturn String(cause);\n\t}\n};\n\n/**\n * Best-effort discriminator for the wrapped cause — the failing sink\n * error's `_tag` (e.g. `RouterBootFailed`) when present. Feeds the\n * additive optional `causeType` on the `dispatchFailed` event so a\n * renderer/log consumer can route on the failure category without\n * parsing the message. Returns `undefined` for untagged causes so the\n * field is simply omitted.\n */\nconst causeTagOf = (cause: unknown): string | undefined => {\n\tif (\n\t\ttypeof cause === 'object' &&\n\t\tcause !== null &&\n\t\t'_tag' in cause &&\n\t\ttypeof (cause as { _tag: unknown })._tag === 'string'\n\t) {\n\t\treturn (cause as { _tag: string })._tag;\n\t}\n\treturn undefined;\n};\n\n/**\n * Resolve a plugin's `capabilities` field to a concrete decl tuple.\n *\n * Two accepted shapes (see `Plugin.capabilities` for the\n * authoring-side contract):\n *\n *   (a) Static — a plain `ReadonlyArray<CapabilityDecl>`. Returned\n *       as-is.\n *\n *   (b) Dynamic — a `CapabilitiesFactory<…>` function. Invoked with\n *       the resolved plugin value + the acquire context built from\n *       the supervisor's identity + runtime root. The function is\n *       called once per acquire (post-success); the returned tuple\n *       flows into `dispatchContributions` like a static one.\n *\n * The dynamic seam exists so plugins' snapshot subtrees, codegen\n * bindings, routable URLs, strategy contributions, etc. can stamp\n * the REAL chain id / package id / network alias produced by their\n * acquire body, instead of the factory-time placeholder strings the\n * static form forces.\n *\n * The substrate stays generic: this resolver doesn't know any\n * service name; the discrimination is purely structural\n * (`typeof === 'function'`).\n */\nexport const resolveCapabilities = (\n\tpluginKey: PluginKey,\n\tfield:\n\t\t| ReadonlyArray<CapabilityDecl>\n\t\t| ((resolved: unknown, ctx: AcquireContext) => ReadonlyArray<CapabilityDecl>)\n\t\t| undefined,\n\tresolved: unknown,\n\tacquireContext: AcquireContext,\n): Effect.Effect<ReadonlyArray<CapabilityDecl>, CapabilityFactoryFailed> => {\n\tif (field === undefined) return Effect.succeed([]);\n\tif (typeof field === 'function') {\n\t\treturn Effect.try({\n\t\t\ttry: () => field(resolved, acquireContext),\n\t\t\tcatch: (cause) =>\n\t\t\t\tnew CapabilityFactoryFailed({\n\t\t\t\t\tpluginKey,\n\t\t\t\t\tmessage: `capability factory failed for ${pluginKey}`,\n\t\t\t\t\tcause,\n\t\t\t\t}),\n\t\t});\n\t}\n\treturn Effect.succeed(field);\n};\n\n/**\n * Walk a plugin's `capabilities` tuple + `errorContributions` after a\n * successful acquire, route every contribution through the\n * substrate-owned `CapabilitySinksService`. The plugin's scope is\n * provided so each sink's `addFinalizer` lands on the plugin's scope —\n * registrations reap on selective-restart / shutdown.\n *\n * The supervisor stays kind-blind: it builds the contribution union\n * (`{source: 'capability'|'error', ...}`) and the dispatch happens\n * inside the service. Unknown kinds are downgraded to no-ops here so\n * the substrate-open-by-default contract holds — plugin authors can\n * emit a custom-kind decl that is observed only by the orchestrators\n * that registered the matching sink.\n *\n * Sink failures (`ContributionSinkFailed`) are routed through a\n * separate `engine.orchestrator.dispatchFailed` event so the plugin\n * remains ready and the orchestrator's broken sink is the visible\n * fault (backlog #39).\n */\nexport const dispatchContributions = (\n\tpluginKey: PluginKey,\n\tcapabilities: ReadonlyArray<CapabilityDecl>,\n\terrorContributions: ReadonlyArray<PluginErrorContribution>,\n\tpluginRole: PluginRole,\n\tidentity: Identity,\n\tpluginContext: Context.Context<never>,\n\tpluginScope: Scope.Scope,\n\tsinks: CapabilitySinksShape,\n\tref: SubscriptionRef.SubscriptionRef<SubscribableState>,\n\thub: Queue.Enqueue<EngineEvent>,\n): Effect.Effect<void, never, never> =>\n\tEffect.gen(function* () {\n\t\tconst strategyRegistry = strategyRegistryAccess.read(pluginContext, noopStrategyRegistry);\n\t\tconst harvestCtx: HarvestContext = {\n\t\t\tpluginKey,\n\t\t\tidentity,\n\t\t\tpublish: (event) => publish(ref, hub, event),\n\t\t\tregisterStrategy: (decl: StrategyContributorDecl<string, unknown>) =>\n\t\t\t\tstrategyRegistry.register(decl.capabilityKey, decl.strategy, {\n\t\t\t\t\tautoMounted: decl.autoMounted,\n\t\t\t\t\t...(decl.priority === undefined ? {} : { priority: decl.priority }),\n\t\t\t\t}),\n\t\t};\n\n\t\tconst items: ReadonlyArray<AnyContribution> = [\n\t\t\t...capabilities.map<AnyContribution>((decl) => ({\n\t\t\t\tsource: 'capability',\n\t\t\t\tdecl,\n\t\t\t})),\n\t\t\t...errorContributions.map<AnyContribution>((contribution) => ({\n\t\t\t\tsource: 'error',\n\t\t\t\tcontribution,\n\t\t\t})),\n\t\t];\n\n\t\tfor (const item of items) {\n\t\t\tconst dispatch = sinks.dispatch(item, harvestCtx).pipe(\n\t\t\t\tEffect.catchTags({\n\t\t\t\t\tUnknownContributionKind: () => Effect.void,\n\t\t\t\t\tContributionSinkFailed: (err) =>\n\t\t\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\t\t\t// Orchestrator-fault path: surface the typed event so\n\t\t\t\t\t\t\t// renderers + log consumers see WHICH sink failed\n\t\t\t\t\t\t\t// without misattributing to the plugin. The plugin's\n\t\t\t\t\t\t\t// lifecycle state is untouched; the markFailed path\n\t\t\t\t\t\t\t// in `acquireNode` is NOT taken for this branch.\n\t\t\t\t\t\t\t//\n\t\t\t\t\t\t\t// The underlying cause MUST travel with the warning:\n\t\t\t\t\t\t\t// a non-fatal sink (e.g. `routable`) leaves the plugin\n\t\t\t\t\t\t\t// `ready`, so without the cause an operator sees a\n\t\t\t\t\t\t\t// healthy-looking stack with dead RPC/wallet routing\n\t\t\t\t\t\t\t// and no diagnosis. `err.cause` holds the real domain\n\t\t\t\t\t\t\t// error (e.g. `RouterBootFailed` + its spec-mismatch\n\t\t\t\t\t\t\t// `detail`); we stringify it for the log and lift its\n\t\t\t\t\t\t\t// `_tag` onto the event's additive `causeType`.\n\t\t\t\t\t\t\tconst causeType = causeTagOf(err.cause);\n\t\t\t\t\t\t\tyield* publish(ref, hub, {\n\t\t\t\t\t\t\t\ttag: 'engine.orchestrator.dispatchFailed',\n\t\t\t\t\t\t\t\tpluginKey,\n\t\t\t\t\t\t\t\tkind: err.kind,\n\t\t\t\t\t\t\t\tmessage: err.message,\n\t\t\t\t\t\t\t\t...(causeType === undefined ? {} : { causeType }),\n\t\t\t\t\t\t\t\tat: Date.now(),\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tyield* Effect.logWarning(\n\t\t\t\t\t\t\t\t`capability sink '${err.kind}' failed for plugin '${pluginKey}': ${formatCause(err.cause)}`,\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t}),\n\t\t\t\t}),\n\t\t\t);\n\t\t\tyield* Scope.provide(dispatch, pluginScope);\n\t\t}\n\t}).pipe(\n\t\twithPluginSpan('lifecycle.supervisor.dispatchContributions', {\n\t\t\tapp: identity.app,\n\t\t\tstack: identity.stack,\n\t\t\tnetwork: identity.chain,\n\t\t\tpluginKey,\n\t\t\trole: pluginRole,\n\t\t}),\n\t);\n"],"mappings":";;;;;;;;AAyCA,MAAM,yBAAyB,gBAAgB,wBAAwB;;;;;;;;;;;;;;;;;;;AAoBvE,MAAM,eAAe,UAA2B;AAC/C,KAAI,MAAM,QAAQ,MAAM,CAAE,QAAO,MAAM,OAAO,MAAM;AACpD,KAAI,iBAAiB,MAAO,QAAO,MAAM,SAAS,MAAM;AACxD,KAAI,OAAO,UAAU,SAAU,QAAO;AACtC,KAAI;AACH,SAAO,KAAK,UAAU,MAAM,IAAI,OAAO,MAAM;SACtC;AACP,SAAO,OAAO,MAAM;;;;;;;;;;;AAYtB,MAAM,cAAc,UAAuC;AAC1D,KACC,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,OAAQ,MAA4B,SAAS,SAE7C,QAAQ,MAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BrC,MAAa,uBACZ,WACA,OAIA,UACA,mBAC2E;AAC3E,KAAI,UAAU,KAAA,EAAW,QAAO,OAAO,QAAQ,EAAE,CAAC;AAClD,KAAI,OAAO,UAAU,WACpB,QAAO,OAAO,IAAI;EACjB,WAAW,MAAM,UAAU,eAAe;EAC1C,QAAQ,UACP,IAAI,wBAAwB;GAC3B;GACA,SAAS,iCAAiC;GAC1C;GACA,CAAC;EACH,CAAC;AAEH,QAAO,OAAO,QAAQ,MAAM;;;;;;;;;;;;;;;;;;;;;AAsB7B,MAAa,yBACZ,WACA,cACA,oBACA,YACA,UACA,eACA,aACA,OACA,KACA,QAEA,OAAO,IAAI,aAAa;CACvB,MAAM,mBAAmB,uBAAuB,KAAK,eAAe,qBAAqB;CACzF,MAAM,aAA6B;EAClC;EACA;EACA,UAAU,UAAU,QAAQ,KAAK,KAAK,MAAM;EAC5C,mBAAmB,SAClB,iBAAiB,SAAS,KAAK,eAAe,KAAK,UAAU;GAC5D,aAAa,KAAK;GAClB,GAAI,KAAK,aAAa,KAAA,IAAY,EAAE,GAAG,EAAE,UAAU,KAAK,UAAU;GAClE,CAAC;EACH;CAED,MAAM,QAAwC,CAC7C,GAAG,aAAa,KAAsB,UAAU;EAC/C,QAAQ;EACR;EACA,EAAE,EACH,GAAG,mBAAmB,KAAsB,kBAAkB;EAC7D,QAAQ;EACR;EACA,EAAE,CACH;AAED,MAAK,MAAM,QAAQ,OAAO;EACzB,MAAM,WAAW,MAAM,SAAS,MAAM,WAAW,CAAC,KACjD,OAAO,UAAU;GAChB,+BAA+B,OAAO;GACtC,yBAAyB,QACxB,OAAO,IAAI,aAAa;IAevB,MAAM,YAAY,WAAW,IAAI,MAAM;AACvC,WAAO,QAAQ,KAAK,KAAK;KACxB,KAAK;KACL;KACA,MAAM,IAAI;KACV,SAAS,IAAI;KACb,GAAI,cAAc,KAAA,IAAY,EAAE,GAAG,EAAE,WAAW;KAChD,IAAI,KAAK,KAAK;KACd,CAAC;AACF,WAAO,OAAO,WACb,oBAAoB,IAAI,KAAK,uBAAuB,UAAU,KAAK,YAAY,IAAI,MAAM,GACzF;KACA;GACH,CAAC,CACF;AACD,SAAO,MAAM,QAAQ,UAAU,YAAY;;EAE3C,CAAC,KACF,eAAe,8CAA8C;CAC5D,KAAK,SAAS;CACd,OAAO,SAAS;CAChB,SAAS,SAAS;CAClB;CACA,MAAM;CACN,CAAC,CACF"}

package/dist/substrate/runtime/supervisor/errors.d.mts

@@ -0,0 +1 @@
+import { Cause } from "effect";

package/dist/substrate/runtime/supervisor/errors.mjs

@@ -0,0 +1,9 @@
+import { Data } from "effect";
+//#region src/substrate/runtime/supervisor/errors.ts
+var SupervisorBootError = class extends Data.TaggedError("SupervisorBootError") {};
+var SupervisorPostAcquireFailed = class extends Data.TaggedError("SupervisorPostAcquireFailed") {};
+var CapabilityFactoryFailed = class extends Data.TaggedError("CapabilityFactoryFailed") {};
+//#endregion
+export { CapabilityFactoryFailed, SupervisorBootError, SupervisorPostAcquireFailed };
+
+//# sourceMappingURL=errors.mjs.map

package/dist/substrate/runtime/supervisor/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.mjs","names":[],"sources":["../../../../src/substrate/runtime/supervisor/errors.ts"],"sourcesContent":["// Supervisor-owned typed errors.\n//\n// Split out of the monolith. These shapes are part of the public\n// supervisor surface (re-exported from `./index.ts`).\n\nimport { Cause, Data } from 'effect';\n\nimport type { PluginKey } from '../../brand.ts';\nimport type { DepGraphError } from '../lifecycle/index.ts';\nimport type {\n\tPluginAcquireFailed,\n\tRestartTargetMissing,\n\tUnknownDependency,\n} from '../lifecycle/index.ts';\n\nexport class SupervisorBootError extends Data.TaggedError('SupervisorBootError')<{\n\treadonly cause: DepGraphError;\n}> {}\n\nexport class SupervisorPostAcquireFailed extends Data.TaggedError('SupervisorPostAcquireFailed')<{\n\treadonly cause: Cause.Cause<unknown>;\n}> {}\n\nexport class CapabilityFactoryFailed extends Data.TaggedError('CapabilityFactoryFailed')<{\n\treadonly pluginKey: PluginKey;\n\treadonly message: string;\n\treadonly cause: unknown;\n}> {}\n\nexport type SupervisorError =\n\t| SupervisorBootError\n\t| SupervisorPostAcquireFailed\n\t| CapabilityFactoryFailed\n\t| PluginAcquireFailed\n\t| RestartTargetMissing\n\t| UnknownDependency;\n"],"mappings":";;AAeA,IAAa,sBAAb,cAAyC,KAAK,YAAY,sBAAsB,CAE7E;AAEH,IAAa,8BAAb,cAAiD,KAAK,YAAY,8BAA8B,CAE7F;AAEH,IAAa,0BAAb,cAA6C,KAAK,YAAY,0BAA0B,CAIrF"}

package/dist/substrate/runtime/supervisor/index.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/substrate/runtime/supervisor/index.mjs

@@ -0,0 +1,3 @@
+import "./errors.mjs";
+import "./start-supervisor.mjs";
+export {};

package/dist/substrate/runtime/supervisor/shutdown.mjs

@@ -0,0 +1,51 @@
+import { planFullDrain } from "../lifecycle/selective-restart.mjs";
+import "../lifecycle/index.mjs";
+import { publish, setCyclePhase } from "./wiring.mjs";
+import { requestBackgroundSnapshotInterrupt, requestBackgroundStackRestartInterrupt } from "./background-tasks.mjs";
+import { teardownKeys } from "./teardown.mjs";
+import { Deferred, Effect, Ref } from "effect";
+//#region src/substrate/runtime/supervisor/shutdown.ts
+const handleShutdownRequested = (deps) => Effect.gen(function* () {
+	const { graph, registry, ref, shutdownLatch, logger } = deps;
+	yield* Effect.uninterruptible(Effect.gen(function* () {
+		yield* requestBackgroundSnapshotInterrupt(deps);
+		yield* setCyclePhase(ref, "shutting-down");
+		yield* Ref.set(shutdownLatch, true);
+		yield* logger.log("supervisor", null, {
+			level: "info",
+			message: "shutdown requested"
+		});
+		yield* requestBackgroundStackRestartInterrupt(deps);
+		yield* teardownKeys(graph, registry, planFullDrain(graph).teardownOrder);
+		yield* Effect.yieldNow;
+		yield* Deferred.succeed(deps.shutdownComplete, void 0).pipe(Effect.ignore);
+	}));
+});
+const handleHardKillRequested = (deps, cmd) => Effect.gen(function* () {
+	const { ref, hub, shutdownLatch, logger } = deps;
+	yield* requestBackgroundSnapshotInterrupt(deps);
+	yield* publish(ref, hub, {
+		tag: "shutdown.escalated",
+		signal: cmd.signal,
+		exitCode: cmd.exitCode,
+		at: cmd.at
+	});
+	yield* setCyclePhase(ref, "shutting-down");
+	yield* Ref.set(shutdownLatch, true);
+	yield* requestBackgroundStackRestartInterrupt(deps);
+	yield* Effect.uninterruptible(Effect.gen(function* () {
+		yield* Deferred.succeed(deps.shutdownComplete, void 0).pipe(Effect.ignore);
+		yield* logger.log("supervisor", null, {
+			level: "fatal",
+			message: `shutdown escalated by ${cmd.signal}`,
+			fields: {
+				signal: cmd.signal,
+				exitCode: cmd.exitCode
+			}
+		});
+	}));
+});
+//#endregion
+export { handleHardKillRequested, handleShutdownRequested };
+
+//# sourceMappingURL=shutdown.mjs.map

package/dist/substrate/runtime/supervisor/shutdown.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.mjs","names":[],"sources":["../../../../src/substrate/runtime/supervisor/shutdown.ts"],"sourcesContent":["// Shutdown branches.\n//\n// Two paths handled here:\n//\n//   - `shutdown.requested` / `stack.stop` — graceful drain. Teardown +\n//     the deferred resolution live in one `Effect.uninterruptible`\n//     block (Bug #13 fix, regression test in\n//     `test/substrate/runtime/supervisor-hard-shutdown.test.ts`).\n//\n//   - `shutdown.hardKillRequested` — escalated shutdown. The graceful\n//     teardown is owned by the supervisor's scope-close finalizer\n//     (which is already uninterruptible); this branch atomically\n//     signals `shutdownComplete` + emits the fatal log so a third SIGINT\n//     can't slip an Effect-level interrupt between the two writes.\n//     `process.exit` from `signals.ts` IS still a hard kill — that\n//     escape hatch is intentional double-Ctrl-C semantics.\n\nimport { Deferred, Effect, Ref } from 'effect';\n\nimport type { EngineCommand } from '../../events.ts';\nimport { planFullDrain } from '../lifecycle/index.ts';\nimport {\n\trequestBackgroundSnapshotInterrupt,\n\trequestBackgroundStackRestartInterrupt,\n} from './background-tasks.ts';\nimport type { SupervisorState } from './state.ts';\nimport { publish, setCyclePhase } from './wiring.ts';\nimport { teardownKeys } from './teardown.ts';\n\nexport const handleShutdownRequested = (deps: SupervisorState): Effect.Effect<void, never, never> =>\n\tEffect.gen(function* () {\n\t\tconst { graph, registry, ref, shutdownLatch, logger } = deps;\n\t\t// Uninterruptible covers the Effect-level interrupt a second\n\t\t// SIGINT would inject anywhere between the awaited snapshot/restart\n\t\t// interrupts, the latch set, and the shutdownComplete signal —\n\t\t// scope close racing the in-loop teardown leaks Docker containers,\n\t\t// and a second SIGINT landing during the awaited snapshot-interrupt\n\t\t// must not interrupt the command loop before teardown runs. The\n\t\t// latch set + deferred resolution live in the same block so callers\n\t\t// blocked on `awaitShutdown` only release AFTER teardown has run.\n\t\t// The signal handler's `process.exit` (signals.ts:75-102) is\n\t\t// still a hard kill — that's intentional; double-Ctrl-C is\n\t\t// the operator asking for abort.\n\t\tyield* Effect.uninterruptible(\n\t\t\tEffect.gen(function* () {\n\t\t\t\tyield* requestBackgroundSnapshotInterrupt(deps);\n\t\t\t\tyield* setCyclePhase(ref, 'shutting-down');\n\t\t\t\tyield* Ref.set(shutdownLatch, true);\n\t\t\t\tyield* logger.log('supervisor', null, {\n\t\t\t\t\tlevel: 'info',\n\t\t\t\t\tmessage: 'shutdown requested',\n\t\t\t\t});\n\t\t\t\tyield* requestBackgroundStackRestartInterrupt(deps);\n\t\t\t\tconst plan = planFullDrain(graph);\n\t\t\t\tyield* teardownKeys(graph, registry, plan.teardownOrder);\n\t\t\t\tyield* Effect.yieldNow;\n\t\t\t\tyield* Deferred.succeed(deps.shutdownComplete, void 0).pipe(Effect.ignore);\n\t\t\t}),\n\t\t);\n\t});\n\nexport const handleHardKillRequested = (\n\tdeps: SupervisorState,\n\tcmd: Extract<EngineCommand, { readonly tag: 'shutdown.hardKillRequested' }>,\n): Effect.Effect<void, never, never> =>\n\tEffect.gen(function* () {\n\t\tconst { ref, hub, shutdownLatch, logger } = deps;\n\t\tyield* requestBackgroundSnapshotInterrupt(deps);\n\t\tyield* publish(ref, hub, {\n\t\t\ttag: 'shutdown.escalated',\n\t\t\tsignal: cmd.signal,\n\t\t\texitCode: cmd.exitCode,\n\t\t\tat: cmd.at,\n\t\t});\n\t\tyield* setCyclePhase(ref, 'shutting-down');\n\t\tyield* Ref.set(shutdownLatch, true);\n\t\tyield* requestBackgroundStackRestartInterrupt(deps);\n\t\t// Hard-kill path: graceful teardown is owned by the\n\t\t// scope-close finalizer (start-supervisor.ts addFinalizer) which\n\t\t// already runs uninterruptibly. We only need to atomically signal\n\t\t// `shutdownComplete` + emit the fatal log so a third SIGINT\n\t\t// can't slip an Effect-level interrupt between the two.\n\t\t// `process.exit` from signals.ts:75-102 IS still the hard\n\t\t// kill — that escape hatch is intentional.\n\t\tyield* Effect.uninterruptible(\n\t\t\tEffect.gen(function* () {\n\t\t\t\tyield* Deferred.succeed(deps.shutdownComplete, void 0).pipe(Effect.ignore);\n\t\t\t\tyield* logger.log('supervisor', null, {\n\t\t\t\t\tlevel: 'fatal',\n\t\t\t\t\tmessage: `shutdown escalated by ${cmd.signal}`,\n\t\t\t\t\tfields: { signal: cmd.signal, exitCode: cmd.exitCode },\n\t\t\t\t});\n\t\t\t}),\n\t\t);\n\t});\n"],"mappings":";;;;;;;AA6BA,MAAa,2BAA2B,SACvC,OAAO,IAAI,aAAa;CACvB,MAAM,EAAE,OAAO,UAAU,KAAK,eAAe,WAAW;AAYxD,QAAO,OAAO,gBACb,OAAO,IAAI,aAAa;AACvB,SAAO,mCAAmC,KAAK;AAC/C,SAAO,cAAc,KAAK,gBAAgB;AAC1C,SAAO,IAAI,IAAI,eAAe,KAAK;AACnC,SAAO,OAAO,IAAI,cAAc,MAAM;GACrC,OAAO;GACP,SAAS;GACT,CAAC;AACF,SAAO,uCAAuC,KAAK;AAEnD,SAAO,aAAa,OAAO,UADd,cAAc,MACc,CAAC,cAAc;AACxD,SAAO,OAAO;AACd,SAAO,SAAS,QAAQ,KAAK,kBAAkB,KAAK,EAAE,CAAC,KAAK,OAAO,OAAO;GACzE,CACF;EACA;AAEH,MAAa,2BACZ,MACA,QAEA,OAAO,IAAI,aAAa;CACvB,MAAM,EAAE,KAAK,KAAK,eAAe,WAAW;AAC5C,QAAO,mCAAmC,KAAK;AAC/C,QAAO,QAAQ,KAAK,KAAK;EACxB,KAAK;EACL,QAAQ,IAAI;EACZ,UAAU,IAAI;EACd,IAAI,IAAI;EACR,CAAC;AACF,QAAO,cAAc,KAAK,gBAAgB;AAC1C,QAAO,IAAI,IAAI,eAAe,KAAK;AACnC,QAAO,uCAAuC,KAAK;AAQnD,QAAO,OAAO,gBACb,OAAO,IAAI,aAAa;AACvB,SAAO,SAAS,QAAQ,KAAK,kBAAkB,KAAK,EAAE,CAAC,KAAK,OAAO,OAAO;AAC1E,SAAO,OAAO,IAAI,cAAc,MAAM;GACrC,OAAO;GACP,SAAS,yBAAyB,IAAI;GACtC,QAAQ;IAAE,QAAQ,IAAI;IAAQ,UAAU,IAAI;IAAU;GACtD,CAAC;GACD,CACF;EACA"}

package/dist/substrate/runtime/supervisor/start-supervisor.d.mts

@@ -0,0 +1 @@
+import { Context, Effect, Queue, Scope, SubscriptionRef } from "effect";