dsh-sidenote 0.4.0 → 0.4.2

package/lib/index.js

@@ -1,3 +1,3991 @@
+import { createRequire } from "node:module";
+//#region node_modules/.pnpm/@deepseek-ai+cosmokit@1.8.3/node_modules/@deepseek-ai/cosmokit/lib/index.js
+/** Return true when a value is `null` or `undefined`. */
+function isNullable(value) {
+	return value === null || value === void 0;
+}
+/** Return true for non-array object values. */
+function isPlainObject(data) {
+	return data && typeof data === "object" && !Array.isArray(data);
+}
+/** Filter object entries and return a new object. */
+function filterKeys(object, filter) {
+	return Object.fromEntries(Object.entries(object).filter(([key, value]) => filter(key, value)));
+}
+/** Map object values while preserving the original key set. */
+function mapValues(object, transform) {
+	return Object.fromEntries(Object.entries(object).map(([key, value]) => [key, transform(value, key)]));
+}
+/** Pick selected keys from an object, optionally including `undefined` values. */
+function pick(source, keys, forced) {
+	if (!keys) return { ...source };
+	const result = {};
+	for (const key of keys) if (forced || source[key] !== void 0) result[key] = source[key];
+	return result;
+}
+/** Define a non-enumerable writable property and return the object. */
+function defineProperty(object, key, value) {
+	return Object.defineProperty(object, key, {
+		writable: true,
+		value,
+		enumerable: false
+	});
+}
+/** Test values using `instanceof` with a `toStringTag` fallback. */
+function is(type, value) {
+	if (arguments.length === 1) return (value) => is(type, value);
+	return type in globalThis && value instanceof globalThis[type] || Object.prototype.toString.call(value).slice(8, -1) === type;
+}
+function isArrayBufferLike(value) {
+	return is("ArrayBuffer", value) || is("SharedArrayBuffer", value);
+}
+function isArrayBufferSource(value) {
+	return isArrayBufferLike(value) || ArrayBuffer.isView(value);
+}
+/** Binary source detection and base64/hex conversion helpers. */
+var Binary;
+(function(Binary) {
+	Binary.is = isArrayBufferLike;
+	Binary.isSource = isArrayBufferSource;
+	function fromSource(source) {
+		if (ArrayBuffer.isView(source)) return source.buffer.slice(source.byteOffset, source.byteOffset + source.byteLength);
+		else return source;
+	}
+	Binary.fromSource = fromSource;
+	function toBase64(source) {
+		source = fromSource(source);
+		if (typeof Buffer !== "undefined") return Buffer.from(source).toString("base64");
+		let binary = "";
+		const bytes = new Uint8Array(source);
+		for (let i = 0; i < bytes.byteLength; i++) binary += String.fromCharCode(bytes[i]);
+		return btoa(binary);
+	}
+	Binary.toBase64 = toBase64;
+	function fromBase64(source) {
+		if (typeof Buffer !== "undefined") return fromSource(Buffer.from(source, "base64"));
+		return Uint8Array.from(atob(source), (c) => c.charCodeAt(0));
+	}
+	Binary.fromBase64 = fromBase64;
+	function toHex(source) {
+		source = fromSource(source);
+		if (typeof Buffer !== "undefined") return Buffer.from(source).toString("hex");
+		return Array.from(new Uint8Array(source), (byte) => byte.toString(16).padStart(2, "0")).join("");
+	}
+	Binary.toHex = toHex;
+	function fromHex(source) {
+		if (typeof Buffer !== "undefined") return fromSource(Buffer.from(source, "hex"));
+		const hex = source.length % 2 === 0 ? source : source.slice(0, source.length - 1);
+		const buffer = [];
+		for (let i = 0; i < hex.length; i += 2) buffer.push(parseInt(`${hex[i]}${hex[i + 1]}`, 16));
+		return Uint8Array.from(buffer).buffer;
+	}
+	Binary.fromHex = fromHex;
+})(Binary || (Binary = {}));
+Binary.fromBase64;
+Binary.toBase64;
+Binary.fromHex;
+Binary.toHex;
+/** Deep-clone common JavaScript values while preserving prototypes and cycles. */
+function clone(source, refs = /* @__PURE__ */ new Map()) {
+	if (!source || typeof source !== "object") return source;
+	if (is("Date", source)) return new Date(source.valueOf());
+	if (is("RegExp", source)) return new RegExp(source.source, source.flags);
+	if (isArrayBufferLike(source)) return source.slice(0);
+	if (ArrayBuffer.isView(source)) return source.buffer.slice(source.byteOffset, source.byteOffset + source.byteLength);
+	const cached = refs.get(source);
+	if (cached) return cached;
+	if (Array.isArray(source)) {
+		const result = [];
+		refs.set(source, result);
+		source.forEach((value, index) => {
+			result[index] = Reflect.apply(clone, null, [value, refs]);
+		});
+		return result;
+	}
+	const result = Object.create(Object.getPrototypeOf(source));
+	refs.set(source, result);
+	for (const key of Reflect.ownKeys(source)) {
+		const descriptor = { ...Reflect.getOwnPropertyDescriptor(source, key) };
+		if ("value" in descriptor) descriptor.value = Reflect.apply(clone, null, [descriptor.value, refs]);
+		Reflect.defineProperty(result, key, descriptor);
+	}
+	return result;
+}
+/** Deeply compare arrays, dates, regexps, buffers, and plain object fields. */
+function deepEqual(a, b, strict) {
+	if (a === b) return true;
+	if (!strict && isNullable(a) && isNullable(b)) return true;
+	if (typeof a !== typeof b) return false;
+	if (typeof a !== "object") return false;
+	if (!a || !b) return false;
+	function check(test, then) {
+		return test(a) ? test(b) ? then(a, b) : false : test(b) ? false : void 0;
+	}
+	return check(Array.isArray, (a, b) => a.length === b.length && a.every((item, index) => deepEqual(item, b[index]))) ?? check(is("Date"), (a, b) => a.valueOf() === b.valueOf()) ?? check(is("RegExp"), (a, b) => a.source === b.source && a.flags === b.flags) ?? check(isArrayBufferLike, (a, b) => {
+		if (a.byteLength !== b.byteLength) return false;
+		const viewA = new Uint8Array(a);
+		const viewB = new Uint8Array(b);
+		for (let i = 0; i < viewA.length; i++) if (viewA[i] !== viewB[i]) return false;
+		return true;
+	}) ?? Object.keys({
+		...a,
+		...b
+	}).every((key) => deepEqual(a[key], b[key], strict));
+}
+function tokenize(source, delimiters, delimiter) {
+	const output = [];
+	let state = 0;
+	for (let i = 0; i < source.length; i++) {
+		const code = source.charCodeAt(i);
+		if (code >= 65 && code <= 90) {
+			if (state === 1) {
+				const next = source.charCodeAt(i + 1);
+				if (next >= 97 && next <= 122) output.push(delimiter);
+				output.push(code + 32);
+			} else {
+				if (state !== 0) output.push(delimiter);
+				output.push(code + 32);
+			}
+			state = 1;
+		} else if (code >= 97 && code <= 122) {
+			output.push(code);
+			state = 2;
+		} else if (delimiters.includes(code)) {
+			if (state !== 0) output.push(delimiter);
+			state = 0;
+		} else output.push(code);
+	}
+	return String.fromCharCode(...output);
+}
+/** Convert text to dash-delimited parameter case. */
+function paramCase(source) {
+	return tokenize(source, [45, 95], 45);
+}
+/** Runtime alias for `paramCase`. */
+const hyphenate = paramCase;
+/** Time constants plus parsing and formatting helpers. */
+var Time;
+(function(Time) {
+	Time.millisecond = 1;
+	Time.second = 1e3;
+	Time.minute = Time.second * 60;
+	Time.hour = Time.minute * 60;
+	Time.day = Time.hour * 24;
+	Time.week = Time.day * 7;
+	let timezoneOffset = (/* @__PURE__ */ new Date()).getTimezoneOffset();
+	function setTimezoneOffset(offset) {
+		timezoneOffset = offset;
+	}
+	Time.setTimezoneOffset = setTimezoneOffset;
+	function getTimezoneOffset() {
+		return timezoneOffset;
+	}
+	Time.getTimezoneOffset = getTimezoneOffset;
+	function getDateNumber(date = /* @__PURE__ */ new Date(), offset) {
+		if (typeof date === "number") date = new Date(date);
+		if (offset === void 0) offset = timezoneOffset;
+		return Math.floor((date.valueOf() / Time.minute - offset) / 1440);
+	}
+	Time.getDateNumber = getDateNumber;
+	function fromDateNumber(value, offset) {
+		const date = new Date(value * Time.day);
+		if (offset === void 0) offset = timezoneOffset;
+		return new Date(+date + offset * Time.minute);
+	}
+	Time.fromDateNumber = fromDateNumber;
+	const numeric = /\d+(?:\.\d+)?/.source;
+	const timeRegExp = new RegExp(`^${[
+		"w(?:eek(?:s)?)?",
+		"d(?:ay(?:s)?)?",
+		"h(?:our(?:s)?)?",
+		"m(?:in(?:ute)?(?:s)?)?",
+		"s(?:ec(?:ond)?(?:s)?)?"
+	].map((unit) => `(${numeric}${unit})?`).join("")}$`);
+	function parseTime(source) {
+		const capture = timeRegExp.exec(source);
+		if (!capture) return 0;
+		return (parseFloat(capture[1]) * Time.week || 0) + (parseFloat(capture[2]) * Time.day || 0) + (parseFloat(capture[3]) * Time.hour || 0) + (parseFloat(capture[4]) * Time.minute || 0) + (parseFloat(capture[5]) * Time.second || 0);
+	}
+	Time.parseTime = parseTime;
+	function parseDate(date) {
+		const parsed = parseTime(date);
+		if (parsed) date = Date.now() + parsed;
+		else if (/^\d{1,2}(:\d{1,2}){1,2}$/.test(date)) date = `${(/* @__PURE__ */ new Date()).toLocaleDateString()}-${date}`;
+		else if (/^\d{1,2}-\d{1,2}-\d{1,2}(:\d{1,2}){1,2}$/.test(date)) date = `${(/* @__PURE__ */ new Date()).getFullYear()}-${date}`;
+		return date ? new Date(date) : /* @__PURE__ */ new Date();
+	}
+	Time.parseDate = parseDate;
+	function format(ms) {
+		const abs = Math.abs(ms);
+		if (abs >= Time.day - Time.hour / 2) return Math.round(ms / Time.day) + "d";
+		else if (abs >= Time.hour - Time.minute / 2) return Math.round(ms / Time.hour) + "h";
+		else if (abs >= Time.minute - Time.second / 2) return Math.round(ms / Time.minute) + "m";
+		else if (abs >= Time.second) return Math.round(ms / Time.second) + "s";
+		return ms + "ms";
+	}
+	Time.format = format;
+	function toDigits(source, length = 2) {
+		return source.toString().padStart(length, "0");
+	}
+	Time.toDigits = toDigits;
+	function template(template, time = /* @__PURE__ */ new Date()) {
+		return template.replace("yyyy", time.getFullYear().toString()).replace("yy", time.getFullYear().toString().slice(2)).replace("MM", toDigits(time.getMonth() + 1)).replace("dd", toDigits(time.getDate())).replace("hh", toDigits(time.getHours())).replace("mm", toDigits(time.getMinutes())).replace("ss", toDigits(time.getSeconds())).replace("SSS", toDigits(time.getMilliseconds(), 3));
+	}
+	Time.template = template;
+})(Time || (Time = {}));
+//#endregion
+//#region node_modules/.pnpm/@deepseek-ai+cordis@4.0.2/node_modules/@deepseek-ai/cordis/lib/index.js
+/** Ordered collection of disposable values with O(1) deletion by value. */
+var DisposableList = class {
+	sn = 0;
+	map = /* @__PURE__ */ new Map();
+	weak = /* @__PURE__ */ new WeakMap();
+	get length() {
+		return this.map.size;
+	}
+	push(value) {
+		const sn = ++this.sn;
+		this.map.set(sn, value);
+		this.weak.set(value, sn);
+		return () => this.map.delete(sn);
+	}
+	delete(value) {
+		const sn = this.weak.get(value);
+		if (!sn) return false;
+		return this.map.delete(sn);
+	}
+	clear() {
+		const values = [...this.map.values()];
+		this.map.clear();
+		return values.reverse();
+	}
+	[Symbol.iterator]() {
+		return this.map.values();
+	}
+	[Symbol.for("nodejs.util.inspect.custom")]() {
+		return [...this];
+	}
+};
+/** Shared symbols used to avoid public property-name collisions. */
+const symbols = {
+	shadow: Symbol.for("cordis.shadow"),
+	receiver: Symbol.for("cordis.receiver"),
+	original: Symbol.for("cordis.original"),
+	metadata: Symbol.for("cordis.metadata"),
+	initHooks: Symbol.for("cordis.initHooks"),
+	checkProto: Symbol.for("cordis.checkProto"),
+	effect: Symbol.for("cordis.effect"),
+	filter: Symbol.for("cordis.filter"),
+	isolate: Symbol.for("cordis.isolate"),
+	intercept: Symbol.for("cordis.intercept"),
+	init: Symbol.for("cordis.init"),
+	check: Symbol.for("cordis.check"),
+	config: Symbol.for("cordis.config"),
+	invoke: Symbol.for("cordis.invoke"),
+	extend: Symbol.for("cordis.extend"),
+	tracker: Symbol.for("cordis.tracker"),
+	resolveConfig: Symbol.for("cordis.resolveConfig")
+};
+const GeneratorFunction = function* () {}.constructor;
+const AsyncGeneratorFunction = async function* () {}.constructor;
+/** Return true when a plugin callback should be constructed with `new`. */
+function isConstructor(func) {
+	if (!func.prototype) return false;
+	if (func instanceof GeneratorFunction) return false;
+	if (AsyncGeneratorFunction !== Function && func instanceof AsyncGeneratorFunction) return false;
+	return true;
+}
+/** Merge two prototype chains while preserving descriptors from `proto1`. */
+function joinPrototype(proto1, proto2) {
+	if (proto1 === Object.prototype) return proto2;
+	const result = Object.create(joinPrototype(Object.getPrototypeOf(proto1), proto2));
+	for (const key of Reflect.ownKeys(proto1)) Object.defineProperty(result, key, Object.getOwnPropertyDescriptor(proto1, key));
+	return result;
+}
+/** Return true for non-null objects and functions. */
+function isObject(value) {
+	return value && (typeof value === "object" || typeof value === "function");
+}
+/** Find a property descriptor by walking an object's prototype chain. */
+function getPropertyDescriptor(target, prop) {
+	let proto = target;
+	while (proto) {
+		const desc = Reflect.getOwnPropertyDescriptor(proto, prop);
+		if (desc) return desc;
+		proto = Object.getPrototypeOf(proto);
+	}
+}
+/** Wrap services/functions so method calls see the caller's active context. */
+function getTraceable(ctx, value) {
+	if (!isObject(value)) return value;
+	if (Object.hasOwn(value, symbols.shadow)) return Object.getPrototypeOf(value);
+	const tracker = value[symbols.tracker];
+	if (!tracker) return value;
+	return createTraceable(ctx, value, tracker);
+}
+/** Return a proxy that overlays readonly or writable properties onto a target. */
+function withProps(target, props) {
+	if (!props) return target;
+	return new Proxy(target, {
+		get: (target, prop, receiver) => {
+			if (prop in props && prop !== "constructor") return Reflect.get(props, prop, receiver);
+			return Reflect.get(target, prop, receiver);
+		},
+		set: (target, prop, value, receiver) => {
+			if (prop in props && prop !== "constructor") return Reflect.set(props, prop, value, receiver);
+			return Reflect.set(target, prop, value, receiver);
+		}
+	});
+}
+function withProp(target, prop, value) {
+	return withProps(target, Object.defineProperty(Object.create(null), prop, {
+		value,
+		writable: false
+	}));
+}
+function createShadow(ctx, target, property, receiver) {
+	if (!property) return receiver;
+	const origin = Reflect.getOwnPropertyDescriptor(target, property)?.value;
+	if (!origin) return receiver;
+	return withProp(receiver, property, ctx.extend({ [symbols.shadow]: origin }));
+}
+function createShadowMethod(ctx, value, outer, shadow) {
+	return new Proxy(value, { apply: (target, thisArg, args) => {
+		if (thisArg === outer) thisArg = shadow;
+		return getTraceable(ctx, Reflect.apply(target, thisArg, args));
+	} });
+}
+function createTraceable(ctx, value, tracker) {
+	if (ctx[symbols.shadow] && !tracker.noShadow) ctx = Object.getPrototypeOf(ctx);
+	const proxy = new Proxy(value, {
+		get: (target, prop, receiver) => {
+			if (prop === symbols.original) return target;
+			if (prop === tracker.property) return ctx;
+			if (typeof prop === "symbol") return Reflect.get(target, prop, receiver);
+			if (tracker.associate && ctx.reflect.props[`${tracker.associate}.${prop}`]) return Reflect.get(ctx, `${tracker.associate}.${prop}`, withProp(ctx, symbols.receiver, receiver));
+			let shadow, innerValue;
+			const desc = getPropertyDescriptor(target, prop);
+			if (desc && "value" in desc) innerValue = desc.value;
+			else {
+				shadow = createShadow(ctx, target, tracker.property, receiver);
+				innerValue = Reflect.get(target, prop, shadow);
+			}
+			const innerTracker = innerValue?.[symbols.tracker];
+			if (innerTracker) return createTraceable(ctx, innerValue, innerTracker);
+			else if (!tracker.noShadow && typeof innerValue === "function") {
+				shadow ??= createShadow(ctx, target, tracker.property, receiver);
+				return createShadowMethod(ctx, innerValue, receiver, shadow);
+			} else return innerValue;
+		},
+		set: (target, prop, value, receiver) => {
+			if (prop === symbols.original) return false;
+			if (prop === tracker.property) return false;
+			if (typeof prop === "symbol") return Reflect.set(target, prop, value, receiver);
+			if (tracker.associate && ctx.reflect.props[`${tracker.associate}.${prop}`]) return Reflect.set(ctx, `${tracker.associate}.${prop}`, value, withProp(ctx, symbols.receiver, receiver));
+			const shadow = createShadow(ctx, target, tracker.property, receiver);
+			return Reflect.set(target, prop, value, shadow);
+		},
+		apply: (target, thisArg, args) => {
+			return applyTraceable(proxy, target, thisArg, args);
+		}
+	});
+	return proxy;
+}
+function applyTraceable(proxy, value, thisArg, args) {
+	if (!value[symbols.invoke]) return Reflect.apply(value, thisArg, args);
+	return value[symbols.invoke].apply(proxy, args);
+}
+/** Create a callable service object that dispatches through `symbols.invoke`. */
+function createCallable(name, proto, tracker) {
+	const self = function(...args) {
+		return applyTraceable(createTraceable(self["ctx"], self, tracker), self, this, args);
+	};
+	defineProperty(self, "name", name);
+	return Object.setPrototypeOf(self, proto);
+}
+function handleError(info, reason, getOuterStack) {
+	const innerLines = info.error.stack.split("\n");
+	if (typeof reason?.stack !== "string") {
+		const outerError = new Error(reason);
+		const lines = outerError.stack.split("\n");
+		lines.splice(1, Infinity, ...getOuterStack());
+		outerError.stack = lines.join("\n");
+		throw outerError;
+	}
+	const lines = reason.stack.split("\n");
+	let index = lines.indexOf(innerLines[2]);
+	if (index === -1) throw reason;
+	index -= info.offset;
+	while (index > 0) {
+		if (!lines[index - 1].endsWith(" (<anonymous>)")) break;
+		index -= 1;
+	}
+	lines.splice(index, Infinity, ...getOuterStack());
+	reason.stack = lines.join("\n");
+	throw reason;
+}
+/** Run a callback and splice outer call-site frames into thrown async errors. */
+function composeError(callback, getOuterStack = buildOuterStack()) {
+	const info = {
+		offset: 1,
+		error: /* @__PURE__ */ new Error()
+	};
+	try {
+		const result = callback(info);
+		if (isObject(result) && "then" in result) return result.then(void 0, (reason) => handleError(info, reason, getOuterStack));
+		else return result;
+	} catch (reason) {
+		handleError(info, reason, getOuterStack);
+	}
+}
+/** Capture a lazy stack-frame supplier for later error composition. */
+function buildOuterStack(offset = 0) {
+	const outerError = /* @__PURE__ */ new Error();
+	return () => outerError.stack.split("\n").slice(3 + offset);
+}
+/**
+* Return whether an event result should stop a bail-style dispatch.
+*
+* @param value — a listener's return value.
+* @returns `true` unless `value` is `null`, `false`, or `undefined`.
+*/
+function isBailed(value) {
+	return value !== null && value !== false && value !== void 0;
+}
+/**
+* Event bus installed as `ctx.events` and mixed into every context.
+*
+* The service supports concurrent, synchronous, serial, bail, and waterfall
+* dispatch and automatically disposes listeners with their owning fiber.
+*/
+var EventsService = class {
+	ctx;
+	_hooks = {};
+	constructor(ctx) {
+		this.ctx = ctx;
+		defineProperty(this, symbols.tracker, {
+			property: "ctx",
+			noShadow: true
+		});
+		this.on("internal/listener", function(name, listener, options) {
+			if (name === "internal/update" && !options.global) return (this.fiber._hooks["internal/update"] ??= new DisposableList())[options.prepend ? "unshift" : "push"](listener);
+		});
+		this.on("internal/update", function(config, noSave, next) {
+			const cbs = [...this._hooks["internal/update"] || []];
+			const _next = () => {
+				return (cbs.shift() ?? next).call(this, config, noSave, _next);
+			};
+			return _next();
+		}, {
+			global: true,
+			prepend: true
+		});
+	}
+	/**
+	* Resolve listeners for one dispatch and apply context filtering.
+	*
+	* @param type — the dispatch mode, reported on `internal/dispatch`.
+	* @param args — the raw dispatch arguments; consumed up to the event name.
+	* @returns the matching listener callbacks, bound to the dispatch `this`.
+	*/
+	dispatch(type, args) {
+		const thisArg = typeof args[0] === "object" || typeof args[0] === "function" ? args.shift() : null;
+		const name = args.shift();
+		if (!name.startsWith("internal/")) this.emit("internal/dispatch", type, name, args, thisArg);
+		const filter = thisArg?.[Context.filter];
+		return (this._hooks[name] || []).filter((hook) => hook.global || !filter || filter.call(thisArg, hook.ctx)).map((hook) => hook.callback.bind(thisArg));
+	}
+	/**
+	* Run listeners concurrently and wait for all of them.
+	*
+	* @param args — optional `this`, the event name, then listener arguments.
+	* @returns a promise resolving once every listener has settled.
+	*/
+	async parallel(...args) {
+		const errors = (await Promise.allSettled(this.dispatch("emit", args).map(async (cb) => cb(...args)))).filter((result) => result.status === "rejected");
+		if (errors.length) throw new AggregateError(errors.map((error) => error.reason));
+	}
+	/**
+	* Run listeners synchronously without waiting for returned promises.
+	*
+	* @param args — optional `this`, the event name, then listener arguments.
+	*/
+	emit(...args) {
+		this.dispatch("emit", args).map((cb) => cb(...args));
+	}
+	/**
+	* Run listeners in order, awaiting each, until one returns a bail value.
+	*
+	* @param args — optional `this`, the event name, then listener arguments.
+	* @returns the first bail value (see {@link isBailed}), if any.
+	*/
+	async serial(...args) {
+		for (const cb of this.dispatch("serial", args)) {
+			const result = await cb(...args);
+			if (isBailed(result)) return result;
+		}
+	}
+	/**
+	* Run listeners synchronously until one returns a bail value.
+	*
+	* @param args — optional `this`, the event name, then listener arguments.
+	* @returns the first bail value (see {@link isBailed}), if any.
+	*/
+	bail(...args) {
+		for (const cb of this.dispatch("bail", args)) {
+			const result = cb(...args);
+			if (isBailed(result)) return result;
+		}
+	}
+	/**
+	* Compose listeners around the final `next` callback.
+	*
+	* The last dispatch argument is treated as the innermost `next`. Listeners
+	* run outermost-first; a listener that does not call `next()` vetoes the
+	* rest of the chain, including the built-in behavior.
+	*
+	* @param args — optional `this`, the event name, listener arguments, then `next`.
+	* @returns the outermost listener's return value.
+	*/
+	waterfall(...args) {
+		const cbs = this.dispatch("waterfall", args);
+		const inner = args.pop();
+		const next = () => {
+			return (cbs.shift() ?? inner)(...args);
+		};
+		args.push(next);
+		return next();
+	}
+	/**
+	* Store a listener record as an effect on the current fiber.
+	*
+	* @param label — effect label shown in fiber diagnostics.
+	* @param hooks — the listener list for one event.
+	* @param callback — the listener to store.
+	* @param options — placement and filtering options.
+	* @returns a disposer that unregisters the listener.
+	*/
+	register(label, hooks, callback, options) {
+		const method = options.prepend ? "unshift" : "push";
+		return this.ctx.fiber.effect(() => {
+			hooks[method]({
+				ctx: this.ctx,
+				callback,
+				...options
+			});
+			return () => this.unregister(hooks, callback);
+		}, label);
+	}
+	/**
+	* Remove a stored listener record.
+	*
+	* @param hooks — the listener list for one event.
+	* @param callback — the listener to remove.
+	* @returns `true` if the listener was found and removed.
+	*/
+	unregister(hooks, callback) {
+		const index = hooks.findIndex((hook) => hook.callback === callback);
+		if (index >= 0) {
+			hooks.splice(index, 1);
+			return true;
+		}
+	}
+	/**
+	* Register an event listener owned by the current fiber.
+	*
+	* The listener is removed automatically when the fiber unloads. Throws
+	* `CordisError('INACTIVE_EFFECT')` if the fiber is already disposed.
+	*
+	* @param name — the event name to listen for.
+	* @param listener — called with the dispatch arguments.
+	* @param options — listener options; a boolean is shorthand for `prepend`.
+	* @returns a disposer removing the listener; `true` if it was still registered.
+	*/
+	on(name, listener, options) {
+		if (typeof options !== "object") options = { prepend: options };
+		this.ctx.fiber.assertActive();
+		listener = this.ctx.reflect.bind(listener);
+		const result = this.bail(this.ctx, "internal/listener", name, listener, options);
+		if (result) return result;
+		const hooks = this._hooks[name] ||= [];
+		const label = `ctx.on(${typeof name === "string" ? JSON.stringify(name) : name.toString()})`;
+		return this.register(label, hooks, listener, options);
+	}
+	/**
+	* Register an event listener that disposes itself after the first call.
+	*
+	* @param name — the event name to listen for.
+	* @param listener — called at most once with the dispatch arguments.
+	* @param options — listener options; a boolean is shorthand for `prepend`.
+	* @returns a disposer removing the listener; `true` if it was still registered.
+	*/
+	once(name, listener, options) {
+		const dispose = this.on(name, function(...args) {
+			dispose();
+			return listener.apply(this, args);
+		}, options);
+		return dispose;
+	}
+};
+/** Built-in placeholder formatters used by `Logger.format()`. */
+const defaultFormatters = {
+	s: (value) => String(value),
+	d: (value) => Math.trunc(Number(value)),
+	i: (value) => Math.trunc(Number(value)),
+	f: (value) => Number(value),
+	o: (value) => JSON.stringify(value),
+	O: (value) => JSON.stringify(value),
+	c: () => "",
+	C: (value, exporter, message) => {
+		return Logger.color(exporter, Logger.code(message.name, exporter.colors), value);
+	}
+};
+function isAggregateError(error) {
+	return error instanceof Error && Array.isArray(error["errors"]);
+}
+/** Logger facade for one named subsystem. */
+var Logger = class {
+	service;
+	static color(exporter, code, value, decoration = "") {
+		if (!exporter.colors) return "" + value;
+		return `\u001b[3${code < 8 ? code : "8;5;" + code}${exporter.colors >= 2 ? decoration : ""}m${value}\u001b[0m`;
+	}
+	static code(name, level) {
+		let hash = 0;
+		for (let i = 0; i < name.length; i++) {
+			hash = (hash << 3) - hash + name.charCodeAt(i) + 13;
+			hash |= 0;
+		}
+		const colors = !level ? [] : level >= 2 ? c256 : c16;
+		return colors[Math.abs(hash) % colors.length];
+	}
+	static format(exporter, message) {
+		const args = message.args.slice();
+		if (args[0] instanceof Error) {
+			args[0] = args[0].stack || args[0].message;
+			args.unshift("%s");
+		} else if (typeof args[0] !== "string") args.unshift("%o");
+		let format = args.shift();
+		format = format.replace(/%([a-zA-Z%])/g, (match, char) => {
+			if (match === "%%") return "%";
+			const formatter = exporter.formatters?.[char] ?? defaultFormatters[char];
+			if (typeof formatter === "function") return formatter(args.shift(), exporter, message);
+			return match;
+		});
+		const oFormatter = exporter.formatters?.o ?? defaultFormatters.o;
+		for (let arg of args) {
+			if (typeof arg === "object" && arg) arg = oFormatter(arg, exporter, message);
+			format += " " + arg;
+		}
+		const { maxLength = 10240 } = exporter;
+		return format.split(/\r?\n/g).map((line) => {
+			return line.slice(0, maxLength) + (line.length > maxLength ? "..." : "");
+		}).join("\n");
+	}
+	constructor(options, service) {
+		this.service = service;
+		Object.assign(this, options);
+		this.error = this._method("error", 0);
+		this.info = this._method("info", 1);
+		this.warn = this._method("warn", 2);
+		this.debug = this._method("debug", 3);
+	}
+	_method(type, level) {
+		return (...args) => {
+			if (args.length === 1 && args[0] instanceof Error) {
+				if (args[0].cause) this[type](args[0].cause);
+				else if (isAggregateError(args[0])) {
+					args[0].errors.forEach((error) => this[type](error));
+					return;
+				}
+			}
+			const sn = ++this.service._snMessage;
+			const ts = Date.now();
+			for (const exporter of this.service.exporters.values()) {
+				if ((exporter.levels?.[this.name] ?? exporter.levels?.default ?? this.level ?? 1) < level) continue;
+				const message = {
+					sn,
+					ts,
+					type,
+					level,
+					name: this.name,
+					...this.meta,
+					args
+				};
+				exporter.export(message);
+			}
+		};
+	}
+};
+/** ANSI 16-color palette indexes used for logger name coloring. */
+const c16 = [
+	6,
+	2,
+	3,
+	4,
+	5,
+	1
+];
+/** ANSI 256-color palette indexes used for logger name coloring. */
+const c256 = [
+	20,
+	21,
+	26,
+	27,
+	32,
+	33,
+	38,
+	39,
+	40,
+	41,
+	42,
+	43,
+	44,
+	45,
+	56,
+	57,
+	62,
+	63,
+	68,
+	69,
+	74,
+	75,
+	76,
+	77,
+	78,
+	79,
+	80,
+	81,
+	92,
+	93,
+	98,
+	99,
+	112,
+	113,
+	129,
+	134,
+	135,
+	148,
+	149,
+	160,
+	161,
+	162,
+	163,
+	164,
+	165,
+	166,
+	167,
+	168,
+	169,
+	170,
+	171,
+	172,
+	173,
+	178,
+	179,
+	184,
+	185,
+	196,
+	197,
+	198,
+	199,
+	200,
+	201,
+	202,
+	203,
+	204,
+	205,
+	206,
+	207,
+	208,
+	209,
+	214,
+	215,
+	220,
+	221
+];
+/**
+* Built-in logging service.
+*
+* Call `ctx.logger()` to create a named logger, or call `ctx.logger.info()`
+* directly to log with the current fiber-derived name.
+*/
+var LoggerService = class LoggerService {
+	bufferSize = 1e3;
+	buffer = [];
+	ctx;
+	_snMessage = 0;
+	_snExporter = 0;
+	exporters = /* @__PURE__ */ new Map();
+	constructor(ctx) {
+		const tracker = {
+			property: "ctx",
+			noShadow: true
+		};
+		const self = createCallable("logger", joinPrototype(Object.getPrototypeOf(this), Function.prototype), tracker);
+		Object.assign(self, this);
+		self.ctx = ctx;
+		defineProperty(self, symbols.tracker, tracker);
+		self.exporter({
+			colors: 3,
+			export: (message) => {
+				self.buffer.push(message);
+				if (self.buffer.length > self.bufferSize) self.buffer = self.buffer.slice(-self.bufferSize);
+			}
+		});
+		return self;
+	}
+	/**
+	* Register an exporter and dispose it with the current fiber.
+	*
+	* @param exporter — the sink that receives structured log messages.
+	* @returns a disposer that removes the exporter.
+	*/
+	exporter(exporter) {
+		return this.ctx.effect(() => {
+			this.exporters.set(++this._snExporter, exporter);
+			return () => this.exporters.delete(this._snExporter);
+		}, "ctx.logger.exporter()");
+	}
+	_resolveConfig() {
+		let intercept = this.ctx[symbols.intercept];
+		const configs = [];
+		while ("logger" in intercept) {
+			if (Object.hasOwn(intercept, "logger")) configs.unshift(intercept["logger"]);
+			intercept = Object.getPrototypeOf(intercept);
+		}
+		return Object.assign({}, ...configs);
+	}
+	[symbols.invoke](name) {
+		const config = this._resolveConfig();
+		const fiber = (this.ctx[symbols.shadow] ?? this.ctx).fiber;
+		name ??= config.name;
+		name ??= hyphenate(fiber.name);
+		return new Logger({
+			name,
+			level: config.level,
+			meta: { fiber: new WeakRef(fiber) }
+		}, this);
+	}
+	static {
+		for (const type of [
+			"error",
+			"info",
+			"warn",
+			"debug"
+		]) LoggerService.prototype[type] = function(...args) {
+			return this()[type](...args);
+		};
+	}
+};
+function enhanceError(error) {
+	const lines = error.stack.split("\n");
+	lines.splice(0, 2, `Error: ${error.message}`);
+	error.stack = lines.join("\n");
+	return error;
+}
+const RESERVED_WORDS = ["prototype", "then"];
+function isSpecialProperty(prop) {
+	return typeof prop === "symbol" || RESERVED_WORDS.includes(prop) || parseInt(prop).toString() === prop || prop.startsWith("_");
+}
+/**
+* Reflection and service-resolution layer installed as `ctx.reflect`.
+*
+* This service powers the context proxy, service registration, accessors, and
+* the mixins that expose core service methods directly on `ctx`.
+*/
+var ReflectService = class {
+	ctx;
+	/** Proxy traps implementing service resolution for every context object. */
+	static handler = {
+		get: (target, prop, ctx) => {
+			if (isSpecialProperty(prop)) return Reflect.get(target, prop, ctx);
+			if (Reflect.has(target, prop)) return getTraceable(ctx, Reflect.get(target, prop, ctx));
+			const error = /* @__PURE__ */ new Error(`cannot get property "${prop}" without inject`);
+			try {
+				const def = target.reflect.props[prop];
+				if (def?.type === "accessor") return def.get.call(ctx, ctx[symbols.receiver], error);
+				if (!ctx.fiber.runtime) return ctx.reflect.get(prop, false);
+				return ctx.events.waterfall("internal/get", ctx, prop, error, () => {
+					const key = target[symbols.isolate][prop];
+					let fiber = (ctx[symbols.shadow] ?? ctx).fiber;
+					while (true) {
+						const impl = fiber.store?.[prop];
+						if (impl) return getTraceable(ctx, impl.value);
+						if (prop in fiber.inject) {
+							error.message = `cannot get required service "${prop}" in inactive context`;
+							throw error;
+						}
+						if (!fiber.runtime) throw error;
+						if (fiber.parent[symbols.isolate][prop] !== key) throw error;
+						fiber = fiber.parent.fiber;
+					}
+				});
+			} catch (e) {
+				throw e === error ? enhanceError(e) : e;
+			}
+		},
+		set: (target, prop, value, ctx) => {
+			if (isSpecialProperty(prop)) return Reflect.set(target, prop, value, ctx);
+			const error = /* @__PURE__ */ new Error(`cannot set property "${prop}" without provide`);
+			const def = target.reflect.props[prop];
+			if (!def) {
+				if (!ctx.fiber.runtime) return Reflect.set(target, prop, value, ctx);
+				throw enhanceError(error);
+			}
+			try {
+				if (def.type === "accessor") {
+					if (!def.set) return false;
+					return def.set.call(ctx, value, ctx[symbols.receiver], error);
+				}
+				return ctx.events.waterfall("internal/set", ctx, prop, value, error, () => {
+					return ctx.reflect.set(prop, value, error);
+				});
+			} catch (e) {
+				throw e === error ? enhanceError(e) : e;
+			}
+		},
+		has: (target, prop) => {
+			if (isSpecialProperty(prop)) return Reflect.has(target, prop);
+			if (Reflect.has(target, prop)) return true;
+			return !!target.reflect.props[prop];
+		}
+	};
+	/** Service implementations, keyed by isolation label. */
+	store = Object.create(null);
+	/** Declared context properties (services and accessors), by name. */
+	props = Object.create(null);
+	constructor(ctx) {
+		this.ctx = ctx;
+		defineProperty(this, symbols.tracker, {
+			property: "ctx",
+			noShadow: true
+		});
+		this.mixin("reflect", [
+			"get",
+			"set",
+			"provide",
+			"accessor",
+			"mixin"
+		]);
+		this.mixin("fiber", ["runtime", "effect"]);
+		this.mixin("registry", ["inject", "plugin"]);
+		this.mixin("events", [
+			"on",
+			"once",
+			"parallel",
+			"emit",
+			"serial",
+			"bail",
+			"waterfall"
+		]);
+	}
+	/**
+	* Read a service from the store without the inject requirement.
+	*
+	* @param name — the service name.
+	* @param strict — when `true`, only return implementations whose providing
+	* fiber is currently active.
+	* @returns the service value, or `undefined` when not (yet) provided.
+	*/
+	get(name, strict = true) {
+		return getTraceable(this.ctx, this._getImpl(name, strict)?.value);
+	}
+	_getImpl(name, strict = true) {
+		const key = this.ctx[symbols.isolate][name];
+		const impl = key && this.store[key];
+		if (!impl) return;
+		if (strict && impl.fiber.state !== 2) return;
+		return impl;
+	}
+	/**
+	* Overwrite a provided service's value.
+	*
+	* @param name — the service name.
+	* @param value — the new service value.
+	* @param error — carrier for the caller stack in diagnostics.
+	* @returns `true` on success.
+	* @throws when `name` was never provided, or was provided by another fiber.
+	*/
+	set(name, value, error) {
+		const key = this.ctx[symbols.isolate][name];
+		const impl = this.store[key];
+		if (!impl) throw new Error(`cannot set property "${name}" without provide`);
+		if (impl.fiber !== this.ctx.fiber) throw new Error(`cannot set property "${name}" in multiple fibers`);
+		impl.value = value;
+		return true;
+	}
+	/**
+	* Register a service implementation owned by the current fiber.
+	*
+	* See the `ctx.provide()` overload above for the full contract.
+	*
+	* @param name — the service name.
+	* @param value — the service value.
+	* @param check — optional availability predicate for dependents.
+	* @returns a disposer that unregisters the service.
+	*/
+	provide(name, value, check) {
+		return this.ctx.fiber.effect(() => {
+			if (!this.props[name]) this.props[name] ??= { type: "service" };
+			else if (this.props[name].type !== "service") throw new Error(`property "${name}" is already declared as ${this.props[name].type}`);
+			this.props[name] = { type: "service" };
+			this.ctx.root[symbols.isolate][name] ??= Symbol(name);
+			const key = this.ctx[symbols.isolate][name];
+			const impl = {
+				name,
+				value,
+				fiber: this.ctx.fiber,
+				check
+			};
+			if (this.store[key]) throw new Error(`service "${name}" has been registered at <${this.store[key].fiber.name}>`);
+			this.store[key] = impl;
+			this.ctx.fiber.store[name] = impl;
+			if (this.ctx.fiber.state === 2) this.notify([name]);
+			return async () => {
+				delete this.store[key];
+				const fibers = this.notify([name]);
+				await Promise.allSettled(fibers.map((fiber) => fiber.await()));
+				delete this.ctx.fiber.store[name];
+			};
+		}, `ctx.provide(${JSON.stringify(name)})`);
+	}
+	/**
+	* Re-evaluate every fiber that requires one of the given services.
+	*
+	* @param names — the service names that changed.
+	* @param filter — restricts notification to matching isolation scopes.
+	* @returns the fibers whose dependency state was refreshed.
+	*/
+	notify(names, filter = (ctx, name) => ctx[symbols.isolate][name] === this.ctx[symbols.isolate][name]) {
+		const fibers = [];
+		for (const runtime of this.ctx.registry.values()) for (const fiber of runtime.fibers) {
+			let hasUpdate = false;
+			for (const name of names) {
+				if (!(name in fiber.inject)) continue;
+				if (!filter(fiber.ctx, name)) continue;
+				hasUpdate = true;
+				fiber._checkImpl(name);
+			}
+			if (!hasUpdate) continue;
+			fiber._refresh();
+			fibers.push(fiber);
+		}
+		for (const name of names) {
+			const self = Object.create(this.ctx);
+			self[symbols.filter] = (target) => filter(target, name);
+			this.ctx.events.emit(self, "internal/service", name, this._getImpl(name, false)?.value);
+		}
+		return fibers;
+	}
+	/**
+	* Define a computed context property backed by get/set hooks.
+	*
+	* @param name — the context property name.
+	* @param options — the `get` hook and optional `set` hook.
+	* @returns a disposer that removes the accessor.
+	*/
+	accessor(name, options) {
+		return this.ctx.fiber.effect(() => {
+			if (name in this.props) throw new Error(`property "${name}" is already declared as ${this.props[name].type}`);
+			this.props[name] = {
+				type: "accessor",
+				...options
+			};
+			return () => delete this.props[name];
+		}, `ctx.accessor(${JSON.stringify(name)})`);
+	}
+	/**
+	* Expose selected members of a service directly on `ctx`.
+	*
+	* See the `ctx.mixin()` overload above for the full contract.
+	*
+	* @param source — a context property name or a source object.
+	* @param mixins — keys to forward, or a source-key → ctx-key map.
+	* @returns a disposer that removes all created accessors.
+	*/
+	mixin(source, mixins) {
+		const self = this;
+		return this.ctx.fiber.effect(function* () {
+			const entries = Array.isArray(mixins) ? mixins.map((key) => [key, key]) : Object.entries(mixins);
+			const getTarget = (ctx, error) => {
+				return ctx[source];
+			};
+			for (const [key, value] of entries) yield self.accessor(value, {
+				get(receiver, error) {
+					const service = getTarget(this, error);
+					if (isNullable(service)) return service;
+					const mixin = receiver ? withProps(receiver, service) : service;
+					const value = Reflect.get(service, key, mixin);
+					if (typeof value !== "function") return value;
+					return value.bind(mixin ?? service);
+				},
+				set(value, receiver, error) {
+					const service = getTarget(this, error);
+					const mixin = receiver ? withProps(receiver, service) : service;
+					return Reflect.set(service, key, value, mixin);
+				}
+			});
+		}, `ctx.mixin(${JSON.stringify(source)})`);
+	}
+	/**
+	* Attach this context's tracing wrapper to a value.
+	*
+	* @param value — the value to wrap.
+	* @returns the traceable wrapper (or the value itself when not applicable).
+	*/
+	trace(value) {
+		return getTraceable(this.ctx, value);
+	}
+	/**
+	* Wrap a callback so calls trace `this` and arguments to this context.
+	*
+	* @param callback — the function to wrap.
+	* @returns a proxy delegating to `callback` with traced values.
+	*/
+	bind(callback) {
+		return new Proxy(callback, {
+			apply: (target, thisArg, args) => {
+				return Reflect.apply(target, this.trace(thisArg), args.map((arg) => this.trace(arg)));
+			},
+			construct: (target, args, newTarget) => {
+				return Reflect.construct(target, args.map((arg) => this.trace(arg)), newTarget);
+			}
+		});
+	}
+};
+const kValidationError$1 = Symbol.for("ValidationError");
+/** Error raised when plugin configuration fails standard-schema validation. */
+var ValidationError$1 = class extends TypeError {
+	name = "ValidationError";
+	/**
+	* Build the aggregated message from schema issues.
+	*
+	* @param issues — the standard-schema issues, one message line each.
+	*/
+	constructor(issues) {
+		super(`invalid config:\n` + issues.map((issue) => {
+			if (issue.path) return `  - ${issue.message} (at ${issue.path.join(".")})`;
+			else return `  - ${issue.message}`;
+		}).join("\n"));
+	}
+};
+Object.defineProperty(ValidationError$1.prototype, kValidationError$1, { value: true });
+/**
+* Validate and normalize config for a plugin runtime before it starts.
+*
+* @param runtime — the plugin runtime whose `Config` schema to apply.
+* @param config — the raw user config.
+* @returns the validated config, or `config` unchanged if the runtime has no schema.
+* @throws {ValidationError} when validation reports issues.
+*/
+function resolveConfig(runtime, config) {
+	if (!runtime.Config) return config;
+	const result = runtime.Config["~standard"].validate(config);
+	if ("then" in result) throw new TypeError("Async config validation is not supported");
+	if (result.issues) throw new ValidationError$1(result.issues);
+	else return result.value;
+}
+const effectInertia = /* @__PURE__ */ new WeakMap();
+function runDisposable(dispose) {
+	const result = dispose();
+	return effectInertia.get(dispose)?.() ?? result;
+}
+/** Notify plugin teardown without allowing one observer to break ownership cleanup. */
+function emitPluginDisposed(context, fiber) {
+	const args = ["internal/plugin", fiber];
+	let callbacks;
+	try {
+		callbacks = context.events.dispatch("emit", args);
+	} catch (error) {
+		context.logger.error(error);
+		return;
+	}
+	for (const callback of callbacks) try {
+		const returned = callback(...args);
+		Promise.resolve(returned).catch((error) => context.logger.error(error));
+	} catch (error) {
+		context.logger.error(error);
+	}
+}
+/** Framework error with a stable machine-readable code. */
+var CordisError = class CordisError extends Error {
+	code;
+	/**
+	* @param code — the stable error code; also the default message.
+	* @param message — optional human-readable override.
+	*/
+	constructor(code, message) {
+		super(message ?? CordisError.Code[code]);
+		this.code = code;
+	}
+};
+/** Cordis error code definitions. */
+(function(CordisError) {
+	CordisError.Code = { INACTIVE_EFFECT: "cannot create effect on inactive context" };
+})(CordisError || (CordisError = {}));
+const INACTIVE = "__INACTIVE__";
+/**
+* Runtime instance of one plugin application.
+*
+* A fiber tracks dependency state, validated config, lifecycle effects, and
+* cleanup for the plugin context returned by `ctx.plugin()`.
+*/
+var Fiber = class {
+	parent;
+	inject;
+	runtime;
+	/** Unique id within the registry; 0 for the root fiber, `null` once disposed. */
+	uid;
+	/** The context this fiber's plugin runs in (extends the parent context). */
+	ctx;
+	/** The validated plugin config (updated by `update()`). */
+	config;
+	/** The raw plugin config, re-resolved before each activation. */
+	_config;
+	/** Current lifecycle state; transitions emit `internal/status`. */
+	state = 0;
+	/** Dispose this fiber: unload the plugin, then settle once cleanup finished. */
+	dispose;
+	/** Snapshot of required service implementations while loaded; `undefined` otherwise. */
+	store;
+	/** The in-flight load/unload transition, if one is currently running. */
+	inertia;
+	_hooks = Object.create(null);
+	_disposables = new DisposableList();
+	context;
+	_error;
+	_runner;
+	_store = Object.create(null);
+	/**
+	* Create a fiber. Plugin authors normally obtain fibers from `ctx.plugin()`
+	* rather than constructing them directly.
+	*
+	* @param parent — the context the plugin was loaded from.
+	* @param config — raw config, validated against the runtime's schema.
+	* @param inject — resolved dependency map (service name → intercept config).
+	* @param runtime — the shared plugin runtime, or `null` for the root fiber.
+	* @param getOuterStack — captures the caller stack for effect diagnostics.
+	*/
+	constructor(parent, config, inject, runtime, getOuterStack) {
+		this.parent = parent;
+		this.inject = inject;
+		this.runtime = runtime;
+		this._config = config;
+		const collect = (dispose) => {
+			this._disposables.push(dispose);
+		};
+		if (runtime) {
+			this.uid = parent.registry.counter;
+			this.ctx = this.context = parent.extend({ fiber: this });
+			const injectEntries = Object.entries(this.inject);
+			if (injectEntries.length) {
+				this.ctx[Context.intercept] = Object.create(parent[Context.intercept]);
+				for (const [name, config] of injectEntries) {
+					if (isNullable(config)) continue;
+					this.ctx[Context.intercept][name] = config;
+				}
+			}
+			this._runner = {
+				epoch: INACTIVE,
+				getOuterStack,
+				execute: function() {
+					if (isConstructor(runtime.callback)) {
+						const instance = new runtime.callback(this.ctx, this.config);
+						for (const hook of instance?.[symbols.initHooks] ?? []) hook();
+						return instance?.[symbols.init]?.();
+					} else return runtime.callback(this.ctx, this.config);
+				},
+				collect
+			};
+			this.dispose = parent.fiber.effect(() => {
+				const remove = runtime.fibers.push(this);
+				return async () => {
+					this.uid = null;
+					emitPluginDisposed(this.context, this);
+					if (this.ctx.registry.has(runtime.callback)) {
+						remove();
+						if (!runtime.fibers.length) this.ctx.registry.delete(runtime.callback);
+					}
+					this._setEpoch(INACTIVE);
+					if (!this.inertia) this._updateState(() => {
+						this.inertia = this._unload();
+						return 5;
+					});
+					while (this.inertia) await this.inertia;
+				};
+			}, "ctx.plugin()");
+			try {
+				this.context.emit("internal/plugin", this);
+			} catch (error) {
+				Promise.resolve(this.dispose()).catch((reason) => this.ctx.logger.error(reason));
+				throw error;
+			}
+			if (this.uid !== null && parent.fiber.state !== 5) {
+				for (const name of Object.keys(this.inject)) this._checkImpl(name);
+				this._refresh();
+			}
+		} else {
+			this.uid = 0;
+			this.ctx = this.context = parent;
+			this.state = 2;
+			this.store = Object.create(null);
+			this._runner = {
+				epoch: "",
+				getOuterStack,
+				execute: () => {},
+				collect
+			};
+			this.dispose = () => this.restart();
+		}
+	}
+	/** The plugin's display name, inherited from the nearest named ancestor, else `'root'`. */
+	get name() {
+		let fiber = this;
+		do {
+			if (fiber.runtime?.name) return fiber.runtime.name;
+			fiber = fiber.parent.fiber;
+		} while (fiber !== fiber.parent.fiber);
+		return "root";
+	}
+	/**
+	* Throw if the fiber has already been disposed.
+	*
+	* @returns nothing when the fiber is still active.
+	* @throws {CordisError} `INACTIVE_EFFECT` when the fiber's uid has been cleared.
+	*/
+	assertActive() {
+		if (this.uid !== null) return;
+		throw new CordisError("INACTIVE_EFFECT");
+	}
+	_execute(runner) {
+		const oldEpoch = runner.epoch;
+		return composeError((info) => {
+			const safeCollect = (dispose) => {
+				if (typeof dispose === "function") runner.collect(dispose);
+				else if (!isNullable(dispose)) throw new TypeError("Invalid effect");
+			};
+			const effect = runner.execute.call(this);
+			if (typeof effect === "function") return runner.collect(effect);
+			else if (isNullable(effect)) {} else if (!isObject(effect)) throw new TypeError("Invalid effect");
+			else if ("then" in effect) return effect.then(safeCollect);
+			else if (Symbol.iterator in effect) {
+				info.error = /* @__PURE__ */ new Error();
+				const iter = effect[Symbol.iterator]();
+				while (true) {
+					const result = iter.next();
+					safeCollect(result.value);
+					if (result.done) return;
+				}
+			} else if (Symbol.asyncIterator in effect) {
+				const iter = effect[Symbol.asyncIterator]();
+				return (async () => {
+					await Promise.resolve();
+					info.error = /* @__PURE__ */ new Error();
+					while (true) {
+						if (runner.epoch !== oldEpoch) return;
+						const result = await iter.next();
+						safeCollect(result.value);
+						if (result.done) return;
+					}
+				})();
+			} else throw new TypeError("Invalid effect");
+		}, runner.getOuterStack);
+	}
+	effect(execute, label = "anonymous") {
+		this.assertActive();
+		if (this.state === 5) throw new CordisError("INACTIVE_EFFECT");
+		const disposables = [];
+		let disposing = false;
+		let disposalTask;
+		const dispose = () => {
+			if (disposing) return disposalTask;
+			disposing = true;
+			let task;
+			for (const disposable of disposables.splice(0).reverse()) if (task) task = task.then(() => runDisposable(disposable));
+			else {
+				const result = runDisposable(disposable);
+				if (isObject(result) && "then" in result) task = result;
+			}
+			return disposalTask = task;
+		};
+		const meta = {
+			label,
+			children: []
+		};
+		const runner = {
+			execute,
+			epoch: true,
+			collect: (dispose) => {
+				disposables.push(dispose);
+				this._disposables.delete(dispose);
+				if (dispose[symbols.effect]) meta.children.push(dispose[symbols.effect]);
+			},
+			getOuterStack: buildOuterStack()
+		};
+		let task;
+		let executing = true;
+		let resolveSetup;
+		let rejectSetup;
+		let setupBarrier;
+		let setupFailed = false;
+		let inFlight;
+		let removeWrapper = () => false;
+		const waitForSetup = () => {
+			setupBarrier ??= new Promise((resolve, reject) => {
+				resolveSetup = resolve;
+				rejectSetup = reject;
+			});
+			return setupBarrier;
+		};
+		const disposeAfter = (setup) => {
+			return Promise.resolve(setup).then(() => dispose(), async (reason) => {
+				await dispose();
+				throw reason;
+			});
+		};
+		const finalizeDisposal = (callback) => {
+			let result;
+			try {
+				result = callback();
+			} catch (error) {
+				removeWrapper();
+				throw error;
+			}
+			if (isObject(result) && "then" in result) {
+				const pending = Promise.resolve(result).finally(() => {
+					removeWrapper();
+					if (inFlight === pending) inFlight = void 0;
+				});
+				return inFlight = pending;
+			}
+			removeWrapper();
+			return result;
+		};
+		const wrapper = defineProperty(() => {
+			if (!runner.epoch) return setupFailed ? inFlight : void 0;
+			runner.epoch = false;
+			return finalizeDisposal(() => {
+				if (executing) return disposeAfter(waitForSetup());
+				return task ? disposeAfter(task) : dispose();
+			});
+		}, symbols.effect, meta);
+		effectInertia.set(wrapper, () => inFlight);
+		removeWrapper = this._disposables.push(wrapper);
+		try {
+			task = this._execute(runner);
+		} catch (reason) {
+			executing = false;
+			setupFailed = true;
+			runner.epoch = false;
+			let cleanup;
+			try {
+				cleanup = finalizeDisposal(dispose);
+			} finally {
+				rejectSetup?.(reason);
+			}
+			if (isObject(cleanup) && "then" in cleanup) cleanup.catch((error) => this.ctx.logger.error(error));
+			throw reason;
+		}
+		executing = false;
+		if (setupBarrier) Promise.resolve(task).then(resolveSetup, rejectSetup);
+		task?.catch(() => {
+			if (!runner.epoch) return dispose();
+			return finalizeDisposal(dispose);
+		}).catch((error) => this.ctx.logger.error(error));
+		const disposeAsync = () => {
+			if (!runner.epoch) return;
+			runner.epoch = false;
+			return finalizeDisposal(dispose);
+		};
+		wrapper.then = async (onFulfilled, onRejected) => {
+			return Promise.resolve(task).then(() => disposeAsync).then(onFulfilled, onRejected);
+		};
+		return wrapper;
+	}
+	/**
+	* Return metadata for currently registered effects.
+	*
+	* @returns one {@link EffectMeta} tree per labeled live effect.
+	*/
+	getEffects() {
+		return [...this._disposables].map((dispose) => dispose[symbols.effect]).filter(Boolean);
+	}
+	_getState() {
+		if (this.uid === null) return 4;
+		if (this._error) return 3;
+		if (this._runner.epoch !== INACTIVE) return 2;
+		return 0;
+	}
+	_updateState(callback) {
+		const oldState = this.state;
+		this.state = callback() ?? this._getState();
+		if (oldState === this.state) return;
+		this.context.emit("internal/status", this, oldState);
+		if (oldState !== 2 && this.state !== 2) return;
+		for (const key of Reflect.ownKeys(this.ctx.reflect.store)) {
+			const impl = this.ctx.reflect.store[key];
+			if (impl.fiber !== this) continue;
+			this.ctx.reflect.notify([impl.name]);
+		}
+	}
+	_checkImpl(name) {
+		const impl = this.ctx.reflect._getImpl(name, true);
+		if (!impl) return delete this._store[name];
+		try {
+			if (impl.check && !impl.check.call(getTraceable(this.ctx, impl.value))) return delete this._store[name];
+		} catch (error) {
+			impl.fiber.ctx.logger.error(error);
+			return delete this._store[name];
+		}
+		this._store[name] = impl;
+	}
+	_refresh() {
+		let epoch = false;
+		epoch = "";
+		for (const name of Object.keys(this.inject)) {
+			const impl = this._store[name];
+			if (!impl) {
+				epoch = INACTIVE;
+				break;
+			}
+			epoch += ":" + impl.fiber.uid;
+		}
+		this._setEpoch(epoch);
+	}
+	_setEpoch(epoch) {
+		const oldEpoch = this._runner.epoch;
+		if (epoch === oldEpoch) return;
+		this._runner.epoch = epoch;
+		if (this.inertia) return;
+		this._updateState(() => {
+			if (epoch !== INACTIVE && oldEpoch === INACTIVE) {
+				this.inertia = this._reload();
+				return 1;
+			} else {
+				this.inertia = this._unload();
+				return 5;
+			}
+		});
+	}
+	_resolveConfig(config) {
+		config = this.context.waterfall(this, "internal/config", config, () => config);
+		return this.runtime ? resolveConfig(this.runtime, config) : config;
+	}
+	async _reload() {
+		this.store = { ...this._store };
+		const oldEpoch = this._runner.epoch;
+		try {
+			await Promise.resolve();
+			if (this._runner.epoch === oldEpoch) {
+				this.config = this._resolveConfig(this._config);
+				await this._execute(this._runner);
+				this._error = void 0;
+			}
+		} catch (reason) {
+			this.ctx.logger.error(reason);
+			this._error = reason;
+			this._runner.epoch = INACTIVE;
+		}
+		this._updateState(() => {
+			if (this._runner.epoch === oldEpoch) this.inertia = void 0;
+			else {
+				this.inertia = this._unload();
+				return 5;
+			}
+		});
+	}
+	async _unload() {
+		await Promise.all(this._disposables.clear().map(async (dispose) => {
+			try {
+				await composeError(async (info) => {
+					await Promise.resolve();
+					info.error = /* @__PURE__ */ new Error();
+					await runDisposable(dispose);
+				}, this._runner.getOuterStack);
+			} catch (reason) {
+				this.ctx.logger.error(reason);
+			}
+		}));
+		this.store = void 0;
+		this._updateState(() => {
+			if (this._runner.epoch === INACTIVE) this.inertia = void 0;
+			else {
+				this.inertia = this._reload();
+				return 1;
+			}
+		});
+	}
+	/**
+	* Wait for current lifecycle work and rethrow startup errors.
+	*
+	* @returns this fiber, once it has settled into a stable state.
+	* @throws the config-validation or plugin-startup error, if any.
+	*/
+	async await() {
+		while (this.inertia) await this.inertia;
+		if (this._error) throw this._error;
+		return this;
+	}
+	/**
+	* Dispose and immediately reload this plugin with its current config.
+	*
+	* @returns a promise resolving once the reload settled.
+	* @throws {CordisError} `INACTIVE_EFFECT` when the fiber is already disposed.
+	*/
+	async restart() {
+		this.assertActive();
+		this._setEpoch(INACTIVE);
+		this._refresh();
+		await this.await();
+	}
+	/**
+	* Validate and apply new config, then restart the plugin.
+	*
+	* Runs the `internal/update` waterfall first, so update hooks (and HMR)
+	* can veto or replace the restart.
+	*
+	* @param config — the new raw config; validated before anything restarts.
+	* @param noSave — hint for persistence hooks not to write the change back.
+	* @returns the update waterfall result; the default restart returns a promise.
+	* @throws when validation, an update listener, or the restarted plugin fails.
+	*/
+	update(config, noSave = false) {
+		this.assertActive();
+		this._config = config;
+		if (this.state !== 2) {
+			this._error = void 0;
+			this._setEpoch(INACTIVE);
+			this._refresh();
+			return;
+		}
+		config = this._resolveConfig(config);
+		return this.context.waterfall(this, "internal/update", config, noSave, () => {
+			this.config = config;
+			this._error = void 0;
+			return this.restart();
+		});
+	}
+};
+function isApplicable(object) {
+	return object && typeof object === "object" && typeof object.apply === "function";
+}
+/**
+* Decorator for declaring service dependencies on classes or class methods.
+*
+* On classes it contributes to the plugin's static `inject` map. On methods it
+* delays the method call until the declared services are available.
+*/
+/**
+* @param name — the required service name.
+* @param config — optional intercept config applied for that service.
+* @returns the class or method decorator.
+*/
+function Inject(name, config) {
+	return function(value, decorator) {
+		if (decorator.kind === "class") {
+			if (!Object.hasOwn(value, "inject")) {
+				defineProperty(value, "inject", Object.create(Object.getPrototypeOf(value).inject ?? null));
+				defineProperty(value.inject, symbols.checkProto, true);
+			}
+			value.inject[name] = config;
+		} else if (decorator.kind === "method") {
+			const inject = (value[symbols.metadata] ??= {}).inject ??= Object.create(null);
+			inject[name] = config;
+			decorator.addInitializer(function() {
+				const property = this[symbols.tracker]?.property;
+				(this[symbols.initHooks] ??= []).push(() => {
+					this.ctx.inject(inject, (ctx) => {
+						return value.call(property ? withProps(this, { [property]: ctx }) : this);
+					});
+				});
+			});
+		} else throw new Error("@Inject() can only be used on class or class methods");
+	};
+}
+/** Utilities for normalizing plugin dependency declarations. */
+(function(Inject) {
+	/**
+	* Convert array/object/class-inherited inject metadata into a plain map.
+	*
+	* @param inject — the declaration to normalize; `null`/`undefined` add nothing.
+	* @param result — the map to fill (service name → intercept config or `null`).
+	* @returns `result`.
+	*/
+	function resolve(inject, result = Object.create(null)) {
+		if (!inject) return result;
+		if (Array.isArray(inject)) for (const name of inject) result[name] = null;
+		else if (Reflect.has(inject, symbols.checkProto)) {
+			Object.assign(result, resolve(Object.getPrototypeOf(inject)));
+			for (const name of Object.keys(inject)) result[name] = inject[name] ?? null;
+		} else for (const name of Object.keys(inject)) result[name] = inject[name] ?? null;
+		return result;
+	}
+	Inject.resolve = resolve;
+})(Inject || (Inject = {}));
+/**
+* Plugin registry installed as `ctx.registry` and mixed into every context.
+*
+* It normalizes plugin shapes, tracks plugin runtimes, starts fibers, and
+* exposes map-like inspection over active plugin callbacks.
+*/
+var RegistryService = class {
+	ctx;
+	_counter = 0;
+	_internal = /* @__PURE__ */ new Map();
+	constructor(ctx) {
+		this.ctx = ctx;
+		defineProperty(this, symbols.tracker, {
+			property: "ctx",
+			noShadow: true
+		});
+	}
+	/** Allocate the next fiber uid (increments on every read). */
+	get counter() {
+		return ++this._counter;
+	}
+	/** Number of registered plugin runtimes. */
+	get size() {
+		return this._internal.size;
+	}
+	/**
+	* Resolve a supported plugin shape to its executable callback.
+	*
+	* @param plugin — a function, class, or `{ apply }` object plugin.
+	* @returns the callback identifying the plugin, or `undefined` if invalid.
+	*/
+	resolve(plugin) {
+		try {
+			if (typeof plugin === "function") return plugin;
+			if (isApplicable(plugin)) return plugin.apply;
+		} catch {}
+	}
+	/**
+	* Look up the runtime record for a plugin.
+	*
+	* @param plugin — any supported plugin shape.
+	* @returns the runtime, or `undefined` when the plugin is not registered.
+	*/
+	get(plugin) {
+		const key = this.resolve(plugin);
+		return key && this._internal.get(key);
+	}
+	/**
+	* Check whether a plugin has a registered runtime.
+	*
+	* @param plugin — any supported plugin shape.
+	* @returns `true` when at least one fiber of the plugin exists.
+	*/
+	has(plugin) {
+		const key = this.resolve(plugin);
+		return !!key && this._internal.has(key);
+	}
+	/**
+	* Dispose every running fiber for a plugin and remove its runtime record.
+	*
+	* @param plugin — any supported plugin shape.
+	* @returns the removed runtime, or `undefined` when none was registered.
+	*/
+	delete(plugin) {
+		const key = this.resolve(plugin);
+		const runtime = key && this._internal.get(key);
+		if (!runtime) return;
+		this._internal.delete(key);
+		for (const fiber of runtime.fibers) fiber.dispose();
+		return runtime;
+	}
+	/** Iterate the registered plugin callbacks. */
+	keys() {
+		return this._internal.keys();
+	}
+	/** Iterate the registered plugin runtimes. */
+	values() {
+		return this._internal.values();
+	}
+	/** Iterate `[callback, runtime]` pairs. */
+	entries() {
+		return this._internal.entries();
+	}
+	/**
+	* Visit every registered runtime.
+	*
+	* @param callback — receives each runtime and its identifying callback.
+	*/
+	forEach(callback) {
+		return this._internal.forEach(callback);
+	}
+	/**
+	* Start a callback once the requested dependencies are available.
+	*
+	* @param inject — required services, as an array or a name → config map.
+	* @param callback — plugin body called with `(ctx, config)`.
+	* @returns the fiber; awaiting it settles once loading finished.
+	*/
+	inject(inject, callback) {
+		return this.plugin({
+			inject,
+			apply: callback,
+			name: callback.name
+		});
+	}
+	/**
+	* Start a plugin in the current context and return its fiber.
+	*
+	* Creates (or reuses) the plugin's runtime record, then starts a new fiber
+	* under the current context. Throws if `plugin` is not a supported shape or
+	* if the current fiber is already disposed.
+	*
+	* @param plugin — a function, class, or `{ apply }` object plugin.
+	* @param config — the plugin config, validated against its `Config` schema.
+	* @param getOuterStack — captures the caller stack for effect diagnostics.
+	* @returns the fiber; awaiting it settles once loading finished.
+	*/
+	plugin(plugin, config, getOuterStack = buildOuterStack()) {
+		const callback = this.resolve(plugin);
+		if (!callback) throw new Error("invalid plugin, expect function or object with an \"apply\" method, received " + typeof plugin);
+		this.ctx.fiber.assertActive();
+		let runtime = this._internal.get(callback);
+		if (!runtime) {
+			let name = plugin.name;
+			if (name === "apply") name = void 0;
+			runtime = {
+				name,
+				callback,
+				fibers: new DisposableList(),
+				Config: plugin.Config
+			};
+			this._internal.set(callback, runtime);
+		}
+		const fiber = new Fiber(this.ctx, config, Inject.resolve(plugin.inject), runtime, getOuterStack);
+		const wrapped = Object.create(fiber);
+		wrapped.then = (onFulfilled, onRejected) => {
+			return fiber.await().then(onFulfilled, onRejected);
+		};
+		return wrapped;
+	}
+};
+/**
+* Root and child dependency containers for Cordis plugins.
+*
+* A context is a proxy: normal property reads go through the service resolver,
+* while `extend()`, `isolate()`, and `intercept()` create scoped child
+* contexts without mutating their parent.
+*/
+var Context = class Context {
+	/** Symbol key under which a disposer exposes its {@link EffectMeta} diagnostics tree. */
+	static effect = symbols.effect;
+	/** Symbol key for a context's listener filter, consulted on every event dispatch. */
+	static filter = symbols.filter;
+	/** Symbol key of the isolation map (see the `Context[symbols.isolate]` property). */
+	static isolate = symbols.isolate;
+	/** Symbol key of the intercept map (see the `Context[symbols.intercept]` property). */
+	static intercept = symbols.intercept;
+	/**
+	* Returns true for Cordis context proxies and context prototypes.
+	*
+	* Works across realms and across multiple copies of cordis, because the
+	* brand is keyed by a global symbol rather than by `instanceof`.
+	*
+	* @param value — the value to test.
+	* @returns `true` if `value` is a Cordis context, narrowing its type.
+	*/
+	static is(value) {
+		return !!value?.[Context.is];
+	}
+	static {
+		Context.is[Symbol.toPrimitive] = () => Symbol.for("cordis.is");
+		Context.prototype[Context.is] = true;
+	}
+	/** Create the root context and install the built-in services. */
+	constructor() {
+		this[symbols.isolate] = Object.create(null);
+		this[symbols.intercept] = Object.create(null);
+		const self = new Proxy(this, ReflectService.handler);
+		this.root = self;
+		this.baseUrl = void 0;
+		this.fiber = new Fiber(self, {}, Object.create(null), null, () => []);
+		this.reflect = new ReflectService(self);
+		this.registry = new RegistryService(self);
+		this.events = new EventsService(self);
+		this.logger = new LoggerService(self);
+		this.fiber._disposables.clear();
+		return self;
+	}
+	[Symbol.for("nodejs.util.inspect.custom")]() {
+		return `Context <${this.fiber.name}>`;
+	}
+	/**
+	* Create a child context with extra metadata on top of the current scope.
+	*
+	* The child prototypally inherits every property of this context; own
+	* properties of `meta` shadow the inherited ones. The parent is not mutated.
+	*
+	* @param meta — own properties (including symbol keys) to define on the child.
+	* @returns a child context inheriting from this one.
+	*/
+	extend(meta = {}) {
+		const shadow = Reflect.getOwnPropertyDescriptor(this, symbols.shadow)?.value;
+		const self = Object.create(getTraceable(this, this));
+		for (const prop of Reflect.ownKeys(meta)) Object.defineProperty(self, prop, Reflect.getOwnPropertyDescriptor(meta, prop));
+		if (!shadow) return self;
+		return Object.assign(Object.create(self), { [symbols.shadow]: shadow });
+	}
+	/**
+	* Create a child context with an independent service scope for `name`.
+	*
+	* Below the returned context, reads and writes of the service `name`
+	* resolve against the new label instead of the parent's, so a different
+	* implementation can be provided without affecting the parent scope.
+	* Passing the same `label` to two `isolate()` calls joins their scopes.
+	*
+	* @param name — the service name to isolate.
+	* @param label — scope label to join; defaults to a fresh unique symbol.
+	* @returns a child context whose `name` service resolves in the new scope.
+	*/
+	isolate(name, label) {
+		const shadow = Object.create(this[symbols.isolate]);
+		shadow[name] = label ?? Symbol(name);
+		return this.extend({ [symbols.isolate]: shadow });
+	}
+	intercept(name, config) {
+		const intercept = Object.create(this[symbols.intercept]);
+		intercept[name] = config;
+		return this.extend({ [symbols.intercept]: intercept });
+	}
+};
+/**
+* Base class for services that expose a named API on `ctx`.
+*
+* Subclasses call `super(ctx, name)` from their constructor. The service is
+* registered immediately and is automatically removed with the owning fiber.
+*/
+var Service = class Service {
+	ctx;
+	/** Symbol key of an instance method run after construction (class plugins). */
+	static init = symbols.init;
+	/** Symbol key of the availability predicate passed to `ctx.provide()`. */
+	static check = symbols.check;
+	/** Symbol key of the phantom intercept-config type parameter. */
+	static config = symbols.config;
+	/** Symbol key of the call body making a service callable (e.g. `ctx.logger()`). */
+	static invoke = symbols.invoke;
+	/** Symbol key of the helper deriving an extended service instance. */
+	static extend = symbols.extend;
+	/** Symbol key of the tracker metadata used for context tracing. */
+	static tracker = symbols.tracker;
+	/** Symbol key of the intercept-config resolution helper below. */
+	static resolveConfig = symbols.resolveConfig;
+	/** The service name this instance is registered under. */
+	name;
+	/**
+	* Register this instance as `name` in the current context.
+	*
+	* Calls `ctx.reflect.provide(name, this, this[Service.check])`, so the
+	* service is unregistered automatically when the owning fiber unloads.
+	* Services with a `[Service.invoke]` body return a callable instance.
+	*
+	* @param ctx — the context to register in (stored as `this.ctx`).
+	* @param name — the service name; defaults to the static `provide` field.
+	*/
+	constructor(ctx, name) {
+		this.ctx = ctx;
+		name ??= this.constructor["provide"];
+		let self = this;
+		const tracker = {
+			associate: name,
+			property: "ctx"
+		};
+		if (self[symbols.invoke]) self = createCallable(name, joinPrototype(Object.getPrototypeOf(this), Function.prototype), tracker);
+		self.ctx = ctx;
+		self.name = name;
+		defineProperty(self, symbols.tracker, tracker);
+		self.ctx.reflect.provide(name, self, this[symbols.check]);
+		return self;
+	}
+	[symbols.filter](ctx) {
+		return ctx[symbols.isolate][this.name] === this.ctx[symbols.isolate][this.name];
+	}
+	[symbols.extend](props) {
+		let self;
+		if (this[Service.invoke]) self = createCallable(this.name, this, this[symbols.tracker]);
+		else self = Object.create(this);
+		return Object.assign(self, props);
+	}
+	/**
+	* Merge intercept config from ancestors with optional base and head values.
+	*
+	* Entries added closer to the root apply first; `base` is prepended and
+	* `head` appended. Uses `Config.merge` when the service declares one,
+	* otherwise a shallow `Object.assign`.
+	*
+	* @param base — lowest-precedence config merged before all intercepts.
+	* @param head — highest-precedence config merged after all intercepts.
+	* @returns the merged config.
+	*/
+	[symbols.resolveConfig](base, head) {
+		let intercept = this.ctx[Context.intercept];
+		const configs = [];
+		while (this.name in intercept) {
+			if (Object.hasOwn(intercept, this.name)) configs.unshift(intercept[this.name]);
+			intercept = Object.getPrototypeOf(intercept);
+		}
+		if (base) configs.unshift(base);
+		if (head) configs.push(head);
+		if (this["Config"]?.merge) return this["Config"].merge(...configs);
+		else return Object.assign({}, ...configs);
+	}
+	static [Symbol.hasInstance](instance) {
+		if (!instance) return false;
+		let constructor = instance.constructor;
+		while (constructor) {
+			constructor = constructor.prototype?.constructor;
+			if (constructor === this) return true;
+			constructor &&= Object.getPrototypeOf(constructor);
+		}
+		return false;
+	}
+};
+//#endregion
+//#region node_modules/.pnpm/@deepseek-ai+dsh-typert-protocol@0.1.5-rc.2_@deepseek-ai+cordis@4.0.2/node_modules/@deepseek-ai/dsh-typert-protocol/lib/index.js
+/** The one Remote failure class shared by owners, the Gateway, and consumers. */
+/**
+* One Remote call failure: a real Error carrying its stable code and typed
+* details. Owners throw it at the failure point; the Host Gateway encodes it
+* onto the wire unchanged; the Client face rebuilds an instance for the
+* `RemoteResult` error branch, so `throw result.error` keeps throw semantics.
+* Discrimination is always by `code`, never by instanceof.
+*/
+var RemoteError = class extends Error {
+	code;
+	details;
+	/** Structural marker: cross-realm/bundle identification never uses instanceof. */
+	isDSHRemoteError = true;
+	/**
+	* @param code - stable failure code declared in {@link RemoteErrorDetailsMap}.
+	* @param message - human diagnostic carried across the wire.
+	* @param details - structured payload typed by the code.
+	* @param options - standard Error options (`cause` survives in-process only).
+	*/
+	constructor(code, message, details, options) {
+		super(message, options);
+		this.code = code;
+		this.details = details;
+		this.name = "RemoteError";
+	}
+};
+/**
+* Remote decorators and explicit Gateway bindings backed by versioned
+* descriptors carried on decorated class prototypes. Strict reflection
+* remains a Typert compiler responsibility.
+* @module @deepseek-ai/dsh-typert-protocol
+*/
+const TYPERT_REMOTE_SEGMENT_PATTERN = /^[A-Za-z0-9_$.-]+$/;
+/**
+* Test one generated Remote name against the Connection endpoint grammar.
+* @param value - namespace, method, lookup, or Context segment.
+* @returns whether the value can cross the shared RPC carrier unchanged.
+*/
+function isTypertRemoteSegment(value) {
+	return value !== "." && value !== ".." && TYPERT_REMOTE_SEGMENT_PATTERN.test(value);
+}
+const REMOTE_METHOD_DESCRIPTOR = "@deepseek-ai/dsh-typert-protocol/remote-methods";
+/**
+* Bind one visible Service field to a Cordis key and Remote namespace.
+* @param service - owning Service instance, normally `this`.
+* @param serviceKey - exact Cordis service key.
+* @param options - optional distinct wire namespace.
+* @returns a frozen, inspectable binding with no compiler-injected metadata.
+*/
+function bindTypertRemote(service, serviceKey, options = {}) {
+	validateName("service key", serviceKey);
+	const namespace = options.namespace ?? serviceKey;
+	validateName("namespace", namespace);
+	return Object.freeze({
+		service,
+		serviceKey,
+		namespace
+	});
+}
+/** Cordis Service base that exposes its registered name through Typert Gateway. */
+var TypertRemoteService = class extends Service {
+	/** Visible binding consumed by the Gateway's source-mode discovery. */
+	typertRemote;
+	/**
+	* Register the Service and bind the same key to Typert Gateway.
+	* @param ctx - owning Cordis Context.
+	* @param serviceKey - exact Cordis service key and default wire namespace.
+	* @param options - optional distinct wire namespace.
+	*/
+	constructor(ctx, serviceKey, options = {}) {
+		super(ctx, serviceKey);
+		this.typertRemote = bindTypertRemote(this, this.name, options);
+	}
+};
+function Remote(methodExportOrOptions, context) {
+	if (typeof methodExportOrOptions === "string") {
+		validateName("Remote export name", methodExportOrOptions);
+		return remoteDecorator({ kind: "direct" }, void 0, methodExportOrOptions);
+	}
+	if (typeof methodExportOrOptions === "object") {
+		if (remoteOptionMode(methodExportOrOptions) !== "stream" || Reflect.ownKeys(methodExportOrOptions).length !== 1) throw new TypeError("typert-protocol: Remote options must contain exactly mode: \"stream\"");
+		return remoteDecorator({ kind: "direct" }, "stream");
+	}
+	if (context === void 0) throw new TypeError("typert-protocol: Remote decorator context is missing");
+	addMarkerInitializer(context, { kind: "direct" });
+}
+function remoteOptionMode(options) {
+	return Reflect.get(options, "mode");
+}
+function remoteDecorator(invocation, mode, exportName) {
+	return function(_method, context) {
+		addMarkerInitializer(context, invocation, mode, exportName);
+	};
+}
+function readRemoteMethodDescriptor(prototype) {
+	const property = Object.getOwnPropertyDescriptor(prototype, REMOTE_METHOD_DESCRIPTOR);
+	if (property === void 0) return void 0;
+	const descriptor = property.value;
+	if (descriptor === null || typeof descriptor !== "object") throw new TypeError("typert-protocol: Remote method descriptor must be an object");
+	const version = Reflect.get(descriptor, "version");
+	if (version !== 1) throw new TypeError(`typert-protocol: unsupported Remote method descriptor version ${String(version)}`);
+	const methods = Reflect.get(descriptor, "methods");
+	if (!Array.isArray(methods)) throw new TypeError("typert-protocol: Remote method descriptor methods must be an array");
+	return descriptor;
+}
+function addMarkerInitializer(context, invocation, mode, exportName) {
+	if (context.private || context.static || typeof context.name !== "string") throw new TypeError("typert-protocol: Remote decorators require a public instance method with a string name");
+	const method = context.name;
+	context.addInitializer(function() {
+		const prototype = Object.getPrototypeOf(this);
+		if (prototype === null) throw new TypeError(`typert-protocol: cannot mark Remote method "${method}" on an object without a prototype`);
+		mark(prototype, method, invocation, mode, exportName);
+	});
+}
+function mark(prototype, method, invocation, mode, exportName) {
+	const descriptor = readRemoteMethodDescriptor(prototype);
+	const marker = Object.freeze({
+		method,
+		...exportName === void 0 || exportName === method ? {} : { exportName },
+		...mode === void 0 ? {} : { mode },
+		invocation: Object.freeze(invocation)
+	});
+	const current = descriptor?.methods.find((candidate) => candidate.method === method);
+	if (current !== void 0) {
+		if (current.exportName === marker.exportName && current.mode === marker.mode && sameInvocation(current.invocation, invocation)) return;
+		throw new Error(`typert-protocol: Remote method "${method}" has conflicting invocation markers`);
+	}
+	Object.defineProperty(prototype, REMOTE_METHOD_DESCRIPTOR, {
+		configurable: true,
+		value: Object.freeze({
+			version: 1,
+			methods: Object.freeze([...descriptor?.methods ?? [], marker])
+		})
+	});
+}
+function sameInvocation(left, right) {
+	if (left.kind === "direct") return right.kind === "direct";
+	if (right.kind === "direct") return false;
+	return left.context === right.context;
+}
+function validateName(subject, value) {
+	if (!isTypertRemoteSegment(value)) throw new TypeError(`typert-protocol: ${subject} must contain only RPC endpoint segment characters`);
+}
+//#endregion
+//#region node_modules/.pnpm/@deepseek-ai+dsh-util-values@0.1.5-rc.2_@deepseek-ai+cordis@4.0.2/node_modules/@deepseek-ai/dsh-util-values/lib/index.js
+/**
+* Deep-freeze an object graph in place while leaving live AbortSignal objects mutable.
+* @param value - value to freeze.
+* @returns the same value after every reachable enumerable child is frozen.
+*/
+function deepFreeze(value) {
+	const seen = /* @__PURE__ */ new WeakSet();
+	const pending = [{
+		kind: "visit",
+		node: value
+	}];
+	while (pending.length > 0) {
+		const task = pending.pop();
+		/* v8 ignore next -- the loop condition guarantees one pending task. */
+		if (task === void 0) continue;
+		if (task.kind === "property") {
+			pending.push({
+				kind: "visit",
+				node: task.source[task.key]
+			});
+			continue;
+		}
+		const node = task.node;
+		if (node === null || typeof node !== "object") continue;
+		if (node instanceof AbortSignal) continue;
+		if (seen.has(node)) continue;
+		seen.add(node);
+		Object.freeze(node);
+		const keys = Object.keys(node);
+		for (let index = keys.length - 1; index >= 0; index--) {
+			const key = keys[index];
+			/* v8 ignore next -- the loop is bounded by the captured key count. */
+			if (key === void 0) continue;
+			pending.push({
+				kind: "property",
+				source: node,
+				key
+			});
+		}
+	}
+	return value;
+}
+//#endregion
+//#region node_modules/.pnpm/@deepseek-ai+dsh-util-crypto@0.1.5-rc.2_@deepseek-ai+cordis@4.0.2/node_modules/@deepseek-ai/dsh-util-crypto/lib/index.js
+/**
+* Random v4 UUID, minted from `crypto.getRandomValues`.
+* @returns the UUID string.
+*/
+function randomUUID() {
+	const bytes = globalThis.crypto.getRandomValues(/* @__PURE__ */ new Uint8Array(16));
+	const hex = Array.from(bytes, (byte, index) => {
+		return (index === 6 ? byte & 15 | 64 : index === 8 ? byte & 63 | 128 : byte).toString(16).padStart(2, "0");
+	}).join("");
+	return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+//#endregion
+//#region node_modules/.pnpm/@deepseek-ai+dsh-brand@0.1.5-rc.2_@deepseek-ai+cordis@4.0.2/node_modules/@deepseek-ai/dsh-brand/lib/index.js
+/**
+* Duplicate-install-safe nominal primitive helpers.
+*
+* A brand makes structurally identical strings or numbers non-interchangeable
+* at the type level: a `SessionId` cannot be passed where a `ToolCallId` is
+* expected, and an event sequence cannot be passed as a log offset. Comparison,
+* logging, and serialization retain the underlying primitive behavior.
+*
+* This package owns no concrete domain value and keeps no runtime identity or mutable
+* state, so independently installed copies produce interchangeable values.
+*
+* @module @deepseek-ai/dsh-brand
+*/
+/**
+* Apply a compile-time string brand without changing the value.
+* @param value - string admitted by the domain that owns the target brand.
+* @returns the same string with the requested compile-time brand.
+*/
+function brandString(value) {
+	return value;
+}
+//#endregion
+//#region node_modules/.pnpm/@deepseek-ai+schemastery@3.18.2/node_modules/@deepseek-ai/schemastery/lib/index.mjs
+const kSchema = Symbol.for("schemastery");
+const kValidationError = Symbol.for("ValidationError");
+globalThis.__schemastery_index__ ??= 0;
+globalThis.__schemastery_refs__ = void 0;
+var ValidationError = class extends TypeError {
+	options;
+	name = "ValidationError";
+	constructor(message, options) {
+		let prefix = "$";
+		for (const segment of options.path || []) if (typeof segment === "string") prefix += "." + segment;
+		else if (typeof segment === "number") prefix += "[" + segment + "]";
+		else if (typeof segment === "symbol") prefix += `[Symbol(${segment.toString()})]`;
+		if (prefix.startsWith(".")) prefix = prefix.slice(1);
+		super((prefix === "$" ? "" : `${prefix} `) + message);
+		this.options = options;
+	}
+	static is(error) {
+		return !!error?.[kValidationError];
+	}
+};
+Object.defineProperty(ValidationError.prototype, kValidationError, { value: true });
+const Schema = function(options) {
+	const schema = function(data, options = {}) {
+		return Schema.resolve(data, schema, options)[0];
+	};
+	if (options.refs) {
+		const refs = mapValues(options.refs, (options) => new Schema(options));
+		const getRef = (uid) => refs[uid];
+		for (const key in refs) {
+			const options = refs[key];
+			options.sKey = getRef(options.sKey);
+			options.inner = getRef(options.inner);
+			options.list = options.list && options.list.map(getRef);
+			options.dict = options.dict && mapValues(options.dict, getRef);
+		}
+		return refs[options.uid];
+	}
+	Object.assign(schema, options);
+	if (typeof schema.callback === "string") try {
+		schema.callback = new Function("return " + schema.callback)();
+	} catch {}
+	Object.defineProperty(schema, "uid", { value: globalThis.__schemastery_index__++ });
+	Object.setPrototypeOf(schema, Schema.prototype);
+	schema.meta ||= {};
+	schema.toString = schema.toString.bind(schema);
+	return schema;
+};
+Schema.prototype = Object.create(Function.prototype);
+Schema.prototype[kSchema] = true;
+Object.defineProperty(Schema.prototype, "~standard", { get() {
+	return {
+		version: 1,
+		vendor: "schemastery",
+		validate: (value) => {
+			try {
+				return { value: Schema.resolve(value, this, {})[0] };
+			} catch (error) {
+				if (ValidationError.is(error)) return { issues: [{
+					message: error.message,
+					path: error.options.path
+				}] };
+				throw error;
+			}
+		}
+	};
+} });
+Schema.ValidationError = ValidationError;
+Schema.prototype.toJSON = function toJSON() {
+	if (globalThis.__schemastery_refs__) {
+		globalThis.__schemastery_refs__[this.uid] ??= JSON.parse(JSON.stringify({ ...this }));
+		return this.uid;
+	}
+	globalThis.__schemastery_refs__ = { [this.uid]: { ...this } };
+	globalThis.__schemastery_refs__[this.uid] = JSON.parse(JSON.stringify({ ...this }));
+	const result = {
+		uid: this.uid,
+		refs: globalThis.__schemastery_refs__
+	};
+	globalThis.__schemastery_refs__ = void 0;
+	return result;
+};
+Schema.prototype.set = function set(key, value) {
+	this.dict[key] = value;
+	return this;
+};
+Schema.prototype.push = function push(value) {
+	this.list.push(value);
+	return this;
+};
+function mergeDesc(original, messages) {
+	const result = typeof original === "string" ? { "": original } : { ...original };
+	for (const locale in messages) {
+		const value = messages[locale];
+		if (value?.$description || value?.$desc) result[locale] = value.$description || value.$desc;
+		else if (typeof value === "string") result[locale] = value;
+	}
+	return result;
+}
+function getInner(value) {
+	return value?.$value ?? value?.$inner;
+}
+function extractKeys(data) {
+	return filterKeys(data ?? {}, (key) => !key.startsWith("$"));
+}
+Schema.prototype.i18n = function i18n(messages) {
+	const schema = Schema(this);
+	const desc = mergeDesc(schema.meta.description, messages);
+	if (Object.keys(desc).length) schema.meta.description = desc;
+	if (schema.dict) schema.dict = mapValues(schema.dict, (inner, key) => {
+		return inner.i18n(mapValues(messages, (data) => getInner(data)?.[key] ?? data?.[key]));
+	});
+	if (schema.list) schema.list = schema.list.map((inner, index) => {
+		return inner.i18n(mapValues(messages, (data = {}) => {
+			if (Array.isArray(getInner(data))) return getInner(data)[index];
+			if (Array.isArray(data)) return data[index];
+			return extractKeys(data);
+		}));
+	});
+	if (schema.inner) schema.inner = schema.inner.i18n(mapValues(messages, (data) => {
+		if (getInner(data)) return getInner(data);
+		return extractKeys(data);
+	}));
+	if (schema.sKey) schema.sKey = schema.sKey.i18n(mapValues(messages, (data) => data?.$key));
+	return schema;
+};
+Schema.prototype.extra = function extra(key, value) {
+	const schema = Schema(this);
+	schema.meta = {
+		...schema.meta,
+		[key]: value
+	};
+	return schema;
+};
+for (const key of [
+	"required",
+	"disabled",
+	"collapse",
+	"hidden",
+	"loose"
+]) Object.assign(Schema.prototype, { [key](value = true) {
+	const schema = Schema(this);
+	schema.meta = {
+		...schema.meta,
+		[key]: value
+	};
+	return schema;
+} });
+Schema.prototype.deprecated = function deprecated() {
+	const schema = Schema(this);
+	schema.meta.badges ||= [];
+	schema.meta.badges.push({
+		text: "deprecated",
+		type: "danger"
+	});
+	return schema;
+};
+Schema.prototype.experimental = function experimental() {
+	const schema = Schema(this);
+	schema.meta.badges ||= [];
+	schema.meta.badges.push({
+		text: "experimental",
+		type: "warning"
+	});
+	return schema;
+};
+Schema.prototype.pattern = function pattern(regexp) {
+	const schema = Schema(this);
+	const pattern = pick(regexp, ["source", "flags"]);
+	schema.meta = {
+		...schema.meta,
+		pattern
+	};
+	return schema;
+};
+Schema.prototype.simplify = function simplify(value) {
+	if (deepEqual(value, this.meta.default, this.type === "dict")) return null;
+	if (isNullable(value)) return value;
+	if (this.type === "object" || this.type === "dict") {
+		const result = {};
+		for (const key in value) {
+			const item = (this.type === "object" ? this.dict[key] : this.inner)?.simplify(value[key]);
+			if (this.type === "dict" || !isNullable(item)) result[key] = item;
+		}
+		if (deepEqual(result, this.meta.default, this.type === "dict")) return null;
+		return result;
+	} else if (this.type === "array" || this.type === "tuple") {
+		const result = [];
+		value.forEach((value, index) => {
+			const schema = this.type === "array" ? this.inner : this.list[index];
+			const item = schema ? schema.simplify(value) : value;
+			result.push(item);
+		});
+		return result;
+	} else if (this.type === "intersect") {
+		const result = {};
+		for (const item of this.list) Object.assign(result, item.simplify(value));
+		return result;
+	} else if (this.type === "union") for (const schema of this.list) try {
+		Schema.resolve(value, schema, {});
+		return schema.simplify(value);
+	} catch {}
+	return value;
+};
+Schema.prototype.toString = function toString(inline) {
+	return formatters[this.type]?.(this, inline) ?? `Schema<${this.type}>`;
+};
+Schema.prototype.role = function role(role, extra) {
+	const schema = Schema(this);
+	schema.meta = {
+		...schema.meta,
+		role,
+		extra
+	};
+	return schema;
+};
+for (const key of [
+	"default",
+	"link",
+	"comment",
+	"description",
+	"max",
+	"min",
+	"step"
+]) Object.assign(Schema.prototype, { [key](value) {
+	const schema = Schema(this);
+	schema.meta = {
+		...schema.meta,
+		[key]: value
+	};
+	return schema;
+} });
+const resolvers = {};
+Schema.extend = function extend(type, resolve) {
+	resolvers[type] = resolve;
+};
+Schema.resolve = function resolve(data, schema, options = {}, strict = false) {
+	if (!schema) return [data];
+	if (options.ignore?.(data, schema)) return [data];
+	if (isNullable(data) && schema.type !== "lazy") {
+		if (schema.meta.required) throw new ValidationError(`missing required value`, options);
+		let current = schema;
+		let fallback = schema.meta.default;
+		while (current?.type === "intersect" && isNullable(fallback)) {
+			current = current.list[0];
+			fallback = current?.meta.default;
+		}
+		if (isNullable(fallback)) return [data];
+		data = clone(fallback);
+	}
+	const callback = resolvers[schema.type];
+	if (!callback) throw new ValidationError(`unsupported type "${schema.type}"`, options);
+	try {
+		return callback(data, schema, options, strict);
+	} catch (error) {
+		if (!schema.meta.loose) throw error;
+		return [schema.meta.default];
+	}
+};
+Schema.from = function from(source) {
+	if (isNullable(source)) return Schema.any();
+	else if ([
+		"string",
+		"number",
+		"boolean"
+	].includes(typeof source)) return Schema.const(source).required();
+	else if (source[kSchema]) return source;
+	else if (typeof source === "function") switch (source) {
+		case String: return Schema.string().required();
+		case Number: return Schema.number().required();
+		case Boolean: return Schema.boolean().required();
+		case Function: return Schema.function().required();
+		default: return Schema.is(source).required();
+	}
+	else throw new TypeError(`cannot infer schema from ${source}`);
+};
+Schema.lazy = function lazy(builder) {
+	const toJSON = () => {
+		if (!schema.inner[kSchema]) {
+			schema.inner = schema.builder();
+			schema.inner.meta = {
+				...schema.meta,
+				...schema.inner.meta
+			};
+		}
+		return schema.inner.toJSON();
+	};
+	const schema = new Schema({
+		type: "lazy",
+		builder,
+		inner: { toJSON }
+	});
+	return schema;
+};
+Schema.natural = function natural() {
+	return Schema.number().step(1).min(0);
+};
+Schema.percent = function percent() {
+	return Schema.number().step(.01).min(0).max(1).role("slider");
+};
+Schema.date = function date() {
+	return Schema.union([Schema.is(Date), Schema.transform(Schema.string().role("datetime"), (value, options) => {
+		const date = new Date(value);
+		if (isNaN(+date)) throw new ValidationError(`invalid date "${value}"`, options);
+		return date;
+	}, true)]);
+};
+Schema.regExp = function regExp(flag = "") {
+	return Schema.union([Schema.is(RegExp), Schema.transform(Schema.string().role("regexp", { flag }), (value, options) => {
+		try {
+			return new RegExp(value, flag);
+		} catch (e) {
+			throw new ValidationError(e.message, options);
+		}
+	}, true)]);
+};
+Schema.arrayBuffer = function arrayBuffer(encoding) {
+	return Schema.union([
+		Schema.is(ArrayBuffer),
+		Schema.is(SharedArrayBuffer),
+		Schema.transform(Schema.any(), (value, options) => {
+			if (Binary.isSource(value)) return Binary.fromSource(value);
+			throw new ValidationError(`expected ArrayBufferSource but got ${value}`, options);
+		}, true),
+		...encoding ? [Schema.transform(Schema.string(), (value, options) => {
+			try {
+				return encoding === "base64" ? Binary.fromBase64(value) : Binary.fromHex(value);
+			} catch (e) {
+				throw new ValidationError(e.message, options);
+			}
+		}, true)] : []
+	]);
+};
+Schema.extend("lazy", (data, schema, options, strict) => {
+	if (!schema.inner[kSchema]) {
+		schema.inner = schema.builder();
+		schema.inner.meta = {
+			...schema.meta,
+			...schema.inner.meta
+		};
+	}
+	return Schema.resolve(data, schema.inner, options, strict);
+});
+Schema.extend("any", (data) => {
+	return [data];
+});
+Schema.extend("never", (data, _, options) => {
+	throw new ValidationError(`expected nullable but got ${data}`, options);
+});
+Schema.extend("const", (data, { value }, options) => {
+	if (deepEqual(data, value)) return [value];
+	throw new ValidationError(`expected ${value} but got ${data}`, options);
+});
+function checkWithinRange(data, meta, description, options, skipMin = false) {
+	const { max = Infinity, min = -Infinity } = meta;
+	if (data > max) throw new ValidationError(`expected ${description} <= ${max} but got ${data}`, options);
+	if (data < min && !skipMin) throw new ValidationError(`expected ${description} >= ${min} but got ${data}`, options);
+}
+Schema.extend("string", (data, { meta }, options) => {
+	if (typeof data !== "string") throw new ValidationError(`expected string but got ${data}`, options);
+	if (meta.pattern) {
+		const regexp = new RegExp(meta.pattern.source, meta.pattern.flags);
+		if (!regexp.test(data)) throw new ValidationError(`expect string to match regexp ${regexp}`, options);
+	}
+	checkWithinRange(data.length, meta, "string length", options);
+	return [data];
+});
+function decimalShift(data, digits) {
+	const str = data.toString();
+	if (str.includes("e")) return data * Math.pow(10, digits);
+	const index = str.indexOf(".");
+	if (index === -1) return data * Math.pow(10, digits);
+	const frac = str.slice(index + 1);
+	const integer = str.slice(0, index);
+	if (frac.length <= digits) return +(integer + frac.padEnd(digits, "0"));
+	return +(integer + frac.slice(0, digits) + "." + frac.slice(digits));
+}
+function isMultipleOf(data, min, step) {
+	step = Math.abs(step);
+	if (!/^\d+\.\d+$/.test(step.toString())) return (data - min) % step === 0;
+	const index = step.toString().indexOf(".");
+	const digits = step.toString().slice(index + 1).length;
+	return Math.abs(decimalShift(data, digits) - decimalShift(min, digits)) % decimalShift(step, digits) === 0;
+}
+Schema.extend("number", (data, { meta }, options) => {
+	if (typeof data !== "number") throw new ValidationError(`expected number but got ${data}`, options);
+	checkWithinRange(data, meta, "number", options);
+	const { step } = meta;
+	if (step && !isMultipleOf(data, meta.min ?? 0, step)) throw new ValidationError(`expected number multiple of ${step} but got ${data}`, options);
+	return [data];
+});
+Schema.extend("boolean", (data, _, options) => {
+	if (typeof data === "boolean") return [data];
+	throw new ValidationError(`expected boolean but got ${data}`, options);
+});
+Schema.extend("bitset", (data, { bits, meta }, options) => {
+	let value = 0, keys = [];
+	if (typeof data === "number") {
+		value = data;
+		for (const key in bits) if (data & bits[key]) keys.push(key);
+	} else if (Array.isArray(data)) {
+		keys = data;
+		for (const key of keys) {
+			if (typeof key !== "string") throw new ValidationError(`expected string but got ${key}`, options);
+			if (key in bits) value |= bits[key];
+		}
+	} else throw new ValidationError(`expected number or array but got ${data}`, options);
+	if (value === meta.default) return [value];
+	return [value, keys];
+});
+Schema.extend("function", (data, _, options) => {
+	if (typeof data === "function") return [data];
+	throw new ValidationError(`expected function but got ${data}`, options);
+});
+Schema.extend("is", (data, { constructor }, options) => {
+	if (typeof constructor === "function") {
+		if (data instanceof constructor) return [data];
+		throw new ValidationError(`expected ${constructor.name} but got ${data}`, options);
+	} else {
+		if (isNullable(data)) throw new ValidationError(`expected ${constructor} but got ${data}`, options);
+		let prototype = Object.getPrototypeOf(data);
+		while (prototype) {
+			if (prototype.constructor?.name === constructor) return [data];
+			prototype = Object.getPrototypeOf(prototype);
+		}
+		throw new ValidationError(`expected ${constructor} but got ${data}`, options);
+	}
+});
+function property(data, key, schema, options) {
+	try {
+		const [value, adapted] = Schema.resolve(data[key], schema, {
+			...options,
+			path: [...options.path || [], key]
+		});
+		if (adapted !== void 0) data[key] = adapted;
+		return value;
+	} catch (e) {
+		if (!options?.autofix) throw e;
+		delete data[key];
+		return schema.meta.default;
+	}
+}
+Schema.extend("array", (data, { inner, meta }, options) => {
+	if (!Array.isArray(data)) throw new ValidationError(`expected array but got ${data}`, options);
+	checkWithinRange(data.length, meta, "array length", options, !isNullable(inner.meta.default));
+	return [data.map((_, index) => property(data, index, inner, options))];
+});
+Schema.extend("dict", (data, { inner, sKey }, options, strict) => {
+	if (!isPlainObject(data)) throw new ValidationError(`expected object but got ${data}`, options);
+	const result = {};
+	for (const key in data) {
+		let rKey;
+		try {
+			rKey = Schema.resolve(key, sKey, options)[0];
+		} catch (error) {
+			if (strict) continue;
+			throw error;
+		}
+		result[rKey] = property(data, key, inner, options);
+		data[rKey] = data[key];
+		if (key !== rKey) delete data[key];
+	}
+	return [result];
+});
+Schema.extend("tuple", (data, { list }, options, strict) => {
+	if (!Array.isArray(data)) throw new ValidationError(`expected array but got ${data}`, options);
+	const result = list.map((inner, index) => property(data, index, inner, options));
+	if (strict) return [result];
+	result.push(...data.slice(list.length));
+	return [result];
+});
+function merge(result, data) {
+	for (const key in data) {
+		if (key in result) continue;
+		result[key] = data[key];
+	}
+}
+Schema.extend("object", (data, { dict }, options, strict) => {
+	if (!isPlainObject(data)) throw new ValidationError(`expected object but got ${data}`, options);
+	const result = {};
+	for (const key in dict) {
+		const value = property(data, key, dict[key], options);
+		if (!isNullable(value) || key in data) result[key] = value;
+	}
+	if (!strict) merge(result, data);
+	return [result];
+});
+Schema.extend("union", (data, { list, toString }, options, strict) => {
+	const messages = [];
+	for (const inner of list) try {
+		return Schema.resolve(data, inner, options, strict);
+	} catch (error) {
+		messages.push(error);
+	}
+	throw new ValidationError(`expected ${toString()} but got ${JSON.stringify(data)}`, options);
+});
+Schema.extend("intersect", (data, { list, toString }, options, strict) => {
+	if (!list.length) return [data];
+	let result;
+	for (const inner of list) {
+		const value = Schema.resolve(data, inner, options, true)[0];
+		if (isNullable(value)) continue;
+		if (isNullable(result)) result = value;
+		else if (typeof result !== typeof value) throw new ValidationError(`expected ${toString()} but got ${JSON.stringify(data)}`, options);
+		else if (typeof value === "object") merge(result ??= {}, value);
+		else if (result !== value) throw new ValidationError(`expected ${toString()} but got ${JSON.stringify(data)}`, options);
+	}
+	if (!strict && isPlainObject(data)) merge(result, data);
+	return [result];
+});
+Schema.extend("transform", (data, { inner, callback, preserve }, options) => {
+	const [result, adapted = data] = Schema.resolve(data, inner, options, true);
+	if (preserve) return [callback(result)];
+	else return [callback(result), callback(adapted)];
+});
+const formatters = {};
+function defineMethod(name, keys, format) {
+	formatters[name] = format;
+	Object.assign(Schema, { [name](...args) {
+		const schema = new Schema({ type: name });
+		keys.forEach((key, index) => {
+			switch (key) {
+				case "sKey":
+					schema.sKey = args[index] ?? Schema.string();
+					break;
+				case "inner":
+					schema.inner = Schema.from(args[index]);
+					break;
+				case "list":
+					schema.list = args[index].map(Schema.from);
+					break;
+				case "dict":
+					schema.dict = mapValues(args[index], Schema.from);
+					break;
+				case "bits":
+					schema.bits = {};
+					for (const key in args[index]) {
+						if (typeof args[index][key] !== "number") continue;
+						schema.bits[key] = args[index][key];
+					}
+					break;
+				case "callback": {
+					const callback = schema.callback = args[index];
+					callback["toJSON"] ||= () => callback.toString();
+					break;
+				}
+				case "constructor": {
+					const constructor = schema.constructor = args[index];
+					if (typeof constructor === "function") constructor["toJSON"] ||= () => constructor["name"];
+					break;
+				}
+				default: schema[key] = args[index];
+			}
+		});
+		if (name === "object" || name === "dict") schema.meta.default = {};
+		else if (name === "array" || name === "tuple") schema.meta.default = [];
+		else if (name === "bitset") schema.meta.default = 0;
+		return schema;
+	} });
+}
+defineMethod("is", ["constructor"], ({ constructor }) => {
+	if (typeof constructor === "function") return constructor.name;
+	else return constructor;
+});
+defineMethod("any", [], () => "any");
+defineMethod("never", [], () => "never");
+defineMethod("const", ["value"], ({ value }) => typeof value === "string" ? JSON.stringify(value) : value);
+defineMethod("string", [], () => "string");
+defineMethod("number", [], () => "number");
+defineMethod("boolean", [], () => "boolean");
+defineMethod("bitset", ["bits"], () => "bitset");
+defineMethod("function", [], () => "function");
+defineMethod("array", ["inner"], ({ inner }) => `${inner.toString(true)}[]`);
+defineMethod("dict", ["inner", "sKey"], ({ inner, sKey }) => `{ [key: ${sKey.toString()}]: ${inner.toString()} }`);
+defineMethod("tuple", ["list"], ({ list }) => `[${list.map((inner) => inner.toString()).join(", ")}]`);
+defineMethod("object", ["dict"], ({ dict }) => {
+	if (Object.keys(dict).length === 0) return "{}";
+	return `{ ${Object.entries(dict).map(([key, inner]) => {
+		return `${key}${inner.meta.required ? "" : "?"}: ${inner.toString()}`;
+	}).join(", ")} }`;
+});
+defineMethod("union", ["list"], ({ list }, inline) => {
+	const result = list.map(({ toString: format }) => format()).join(" | ");
+	return inline ? `(${result})` : result;
+});
+defineMethod("intersect", ["list"], ({ list }) => {
+	return `${list.map((inner) => inner.toString(true)).join(" & ")}`;
+});
+defineMethod("transform", [
+	"inner",
+	"callback",
+	"preserve"
+], ({ inner }, isInner) => inner.toString(isInner));
+//#endregion
+//#region node_modules/.pnpm/@deepseek-ai+dsh-timeout@0.1.5-rc.2_@deepseek-ai+cordis@4.0.2/node_modules/@deepseek-ai/dsh-timeout/lib/index.js
+/** Largest delay Node schedules without clamping it to one millisecond. */
+const MAX_TIMER_DELAY_MS = 2147483647;
+//#endregion
+//#region node_modules/.pnpm/@deepseek-ai+dsh-llm@0.1.5-rc.2_@deepseek-ai+cordis@4.0.2/node_modules/@deepseek-ai/dsh-llm/lib/index.js
+/**
+* Detach and deep-freeze a message whose identity already exists.
+* @param message - complete message, including its stable identity.
+* @returns an immutable snapshot that preserves the identity.
+*/
+function freezeMessage(message) {
+	return deepFreeze(structuredClone(message));
+}
+/**
+* Create one identified message and freeze it before publication.
+* @param input - complete role, content, and source for a new message.
+* @returns an immutable message with a fresh stable identity.
+*/
+function createMessage(input) {
+	return freezeMessage({
+		...input,
+		id: brandString(randomUUID())
+	});
+}
+/**
+* Create one identified user-role message and freeze it before publication.
+* @param input - complete content and source for a new user message.
+* @returns an immutable user message with a fresh stable identity.
+*/
+function createUserMessage(input) {
+	return createMessage({
+		...input,
+		role: "user"
+	});
+}
+/**
+* Harness error base with a stable machine-routable code and chained cause.
+* Package errors extend it so tool results and replay can retain failure class.
+* @module @deepseek-ai/dsh-llm/error
+*/
+/**
+* Base class for all harness errors. Carries a `code` (stable, programmatic —
+* e.g. `NO_ADAPTER`, `INVALID_ARGS`, `INVARIANT`) distinct from the
+* human-readable `message`, and supports `cause` chaining via the standard
+* `ErrorOptions`. `name` defaults to the subclass constructor name.
+*/
+var HarnessError = class extends Error {
+	/** Stable machine-routable failure class (e.g. `RATE_LIMIT`); route on this, never by parsing `message`. */
+	code;
+	constructor(message, code, options) {
+		super(message, options);
+		this.code = code;
+		this.name = new.target.name;
+	}
+};
+/**
+* Canonical provider-neutral code for a response that completed normally but
+* carried no content blocks at all. Providers occasionally emit a degenerate
+* completion (a terminal stop with zero output); adapters classify it as this
+* failure instead of yielding an empty assistant message, because an empty
+* message silently ends the turn with nothing for the user or the loop to act
+* on. The attempt produced nothing durable, so retry policy treats it as safe
+* to repeat.
+*/
+const EMPTY_RESPONSE_CODE = "EMPTY_RESPONSE";
+new RegExp(String.raw`(?:^|[^a-z0-9])context[\s_-](?:length|window)[\s_-]` + String.raw`(?:exceed(?:ed|s)?|overflow(?:ed)?|limit[\s_-]exceeded)(?:$|[^a-z0-9])`, "i");
+new RegExp(String.raw`\b(?:request|prompt|input|messages?)\s+(?:is\s+|are\s+)?` + String.raw`too\s+(?:large|long)\s+for\s+(?:(?:this|the)\s+)?` + String.raw`(?:model(?:'s)?\s+)?context(?:\s+window)?\b`, "i");
+new RegExp(String.raw`\b(?:input|prompt|request|messages?)\b.{0,40}` + String.raw`\b(?:exceed(?:s|ed)?|overflows?|is\s+larger\s+than)\b.{0,40}` + String.raw`\b(?:the\s+)?(?:model(?:'s)?\s+)?context(?:\s+(?:length|window))?\b`, "i");
+/**
+* Provider-owned request-retry policy configuration and resolution.
+*
+* Adapters expose one resolved policy per registered provider route; the
+* optional dsh-llm-retry plugin executes it on the agent's failed-step extension point.
+*
+* @module @deepseek-ai/dsh-llm/retry-policy
+*/
+const DEFAULT_MAX_RETRIES = 5;
+const DEFAULT_INITIAL_DELAY_MS = 500;
+const DEFAULT_MAX_DELAY_MS = 1e4;
+const DEFAULT_JITTER_RATIO = .1;
+const DEFAULT_RETRYABLE_CODES = Object.freeze([
+	EMPTY_RESPONSE_CODE,
+	"RATE_LIMIT",
+	"SERVER",
+	"TIMEOUT",
+	"TRANSPORT"
+]);
+const backoffSchema = Schema.object({
+	initialDelayMs: Schema.number().max(MAX_TIMER_DELAY_MS).default(DEFAULT_INITIAL_DELAY_MS),
+	maxDelayMs: Schema.number().max(MAX_TIMER_DELAY_MS).default(DEFAULT_MAX_DELAY_MS),
+	jitterRatio: Schema.number().min(0).max(1).default(DEFAULT_JITTER_RATIO)
+});
+const normalPolicySchema = Schema.object({
+	mode: Schema.const("normal").required(),
+	maxRetries: Schema.number().step(1).min(0).max(Number.MAX_SAFE_INTEGER).default(DEFAULT_MAX_RETRIES),
+	retryableCodes: Schema.array(Schema.string()).default([...DEFAULT_RETRYABLE_CODES]),
+	backoff: backoffSchema
+});
+const alwaysPolicySchema = Schema.object({
+	mode: Schema.const("always").required(),
+	backoff: backoffSchema
+});
+Schema.union([normalPolicySchema, alwaysPolicySchema]);
+const NORMAL_POLICY_KEYS = /* @__PURE__ */ new Set([
+	"mode",
+	"maxRetries",
+	"retryableCodes",
+	"backoff"
+]);
+const ALWAYS_POLICY_KEYS = /* @__PURE__ */ new Set([
+	"mode",
+	"maxRetries",
+	"retryableCodes",
+	"backoff"
+]);
+const BACKOFF_KEYS = /* @__PURE__ */ new Set([
+	"initialDelayMs",
+	"maxDelayMs",
+	"jitterRatio"
+]);
+function validateKeys(value, allowed, path) {
+	for (const key of Object.keys(value)) if (!allowed.has(key)) throw new Error(`${path}: unknown key "${key}"`);
+}
+function resolveBackoff(config, path) {
+	if (config !== void 0) validateKeys(config, BACKOFF_KEYS, path);
+	const initialDelayMs = config?.initialDelayMs ?? DEFAULT_INITIAL_DELAY_MS;
+	const maxDelayMs = config?.maxDelayMs ?? DEFAULT_MAX_DELAY_MS;
+	const jitterRatio = config?.jitterRatio ?? DEFAULT_JITTER_RATIO;
+	if (!Number.isFinite(initialDelayMs) || initialDelayMs <= 0 || initialDelayMs > 2147483647) throw new Error(`${path}.initialDelayMs must be a positive finite number no greater than ${MAX_TIMER_DELAY_MS}`);
+	if (!Number.isFinite(maxDelayMs) || maxDelayMs <= 0 || maxDelayMs > 2147483647) throw new Error(`${path}.maxDelayMs must be a positive finite number no greater than ${MAX_TIMER_DELAY_MS}`);
+	if (initialDelayMs > maxDelayMs) throw new Error(`${path}.initialDelayMs must be less than or equal to maxDelayMs`);
+	if (!Number.isFinite(jitterRatio) || jitterRatio < 0 || jitterRatio > 1) throw new Error(`${path}.jitterRatio must be between 0 and 1`);
+	return Object.freeze({
+		initialDelayMs,
+		maxDelayMs,
+		jitterRatio
+	});
+}
+/**
+* Validate, default, and detach one provider-owned retry policy.
+* @param config - optional provider configuration; omission selects normal defaults.
+* @param path - diagnostic path naming the provider config that owns the value.
+* @returns an immutable policy safe to capture in provider registration state.
+*/
+function resolveRetryPolicy(config, path) {
+	if (config === void 0) return Object.freeze({
+		mode: "normal",
+		maxRetries: DEFAULT_MAX_RETRIES,
+		retryableCodes: DEFAULT_RETRYABLE_CODES,
+		...resolveBackoff(void 0, `${path}.backoff`)
+	});
+	switch (config.mode) {
+		case "normal": {
+			validateKeys(config, NORMAL_POLICY_KEYS, path);
+			const maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
+			const retryableCodes = config.retryableCodes ?? [...DEFAULT_RETRYABLE_CODES];
+			if (!Number.isSafeInteger(maxRetries) || maxRetries < 0) throw new Error(`${path}.maxRetries must be a non-negative safe integer`);
+			if (retryableCodes.length === 0) throw new Error(`${path}.retryableCodes must not be empty`);
+			if (retryableCodes.some((code) => typeof code !== "string" || code.length === 0)) throw new Error(`${path}.retryableCodes must contain only non-empty strings`);
+			if (new Set(retryableCodes).size !== retryableCodes.length) throw new Error(`${path}.retryableCodes must not contain duplicates`);
+			return Object.freeze({
+				mode: "normal",
+				maxRetries,
+				retryableCodes: Object.freeze([...retryableCodes]),
+				...resolveBackoff(config.backoff, `${path}.backoff`)
+			});
+		}
+		case "always":
+			validateKeys(config, ALWAYS_POLICY_KEYS, path);
+			return Object.freeze({
+				mode: "always",
+				...resolveBackoff(config.backoff, `${path}.backoff`)
+			});
+		default: throw new Error(`${path}.mode must be "normal" or "always"`);
+	}
+}
+/**
+* Field-wise equality over {@link LlmCallConfig} — the comparison a caller
+* runs to decide whether a proposed configuration is a real change (worth a
+* logged header snapshot) or the held one restated.
+* @param a - one configuration.
+* @param b - the other.
+* @returns whether every field (including the `stop` list, element-wise) matches.
+*/
+function callConfigEquals(a, b) {
+	if (a.provider !== b.provider || a.model !== b.model || a.reasoningEffort !== b.reasoningEffort || a.temperature !== b.temperature || a.maxTokens !== b.maxTokens) return false;
+	if (a.stop === void 0 || b.stop === void 0) return a.stop === b.stop;
+	return a.stop.length === b.stop.length && a.stop.every((s, i) => s === b.stop?.[i]);
+}
+/**
+* Normalization for values thrown by a final LLM adapter boundary.
+*
+* @module @deepseek-ai/dsh-llm/adapter-failure
+*/
+/**
+* Detach serializable provider facts from a value thrown by an adapter.
+* @param value - arbitrary value thrown during adapter dispatch or iteration.
+* @returns immutable provider-neutral facts suitable for a terminal finish chunk.
+* @internal
+*/
+function normalizeLlmFailure(value) {
+	const error = value instanceof Error ? value : new HarnessError(thrownMessage(value), "UNKNOWN", { cause: value });
+	const carried = ownFailureSnapshot(error);
+	if (carried !== void 0 && carried.code === ownErrorCode(error)) return carried;
+	return Object.freeze({
+		message: errorMessage(error),
+		code: harnessErrorCode(error)
+	});
+}
+/** Render a non-Error throw without letting hostile coercion escape normalization. */
+function thrownMessage(value) {
+	try {
+		const message = String(value);
+		return message.length > 0 ? message : "LLM adapter failed";
+	} catch (_hostileThrownValue) {
+		return "LLM adapter failed";
+	}
+}
+/** Read a foreign error's own data-backed `code` without invoking accessors. */
+function ownErrorCode(error) {
+	try {
+		const descriptor = Object.getOwnPropertyDescriptor(error, "code");
+		return descriptor !== void 0 && "value" in descriptor ? descriptor.value : void 0;
+	} catch (_sdkPropertyTrap) {
+		return;
+	}
+}
+/** Snapshot an own data property without invoking an SDK-defined accessor. */
+function ownFailureSnapshot(error) {
+	try {
+		const descriptor = Object.getOwnPropertyDescriptor(error, "failure");
+		return descriptor !== void 0 && "value" in descriptor ? failureSnapshot(descriptor.value) : void 0;
+	} catch (_sdkPropertyTrap) {
+		return;
+	}
+}
+/** Validate and detach an arbitrary serializable failure payload. */
+function failureSnapshot(value) {
+	if (typeof value !== "object" || value === null) return void 0;
+	try {
+		const candidate = value;
+		const message = candidate.message;
+		const code = candidate.code;
+		const status = candidate.status;
+		const providerRetryAfterMs = candidate.providerRetryAfterMs;
+		const requestId = candidate.requestId;
+		if (typeof message !== "string" || message.length === 0 || typeof code !== "string" || code.length === 0 || status !== void 0 && (!Number.isInteger(status) || status < 100 || status > 599) || providerRetryAfterMs !== void 0 && (!Number.isFinite(providerRetryAfterMs) || providerRetryAfterMs <= 0) || requestId !== void 0 && (typeof requestId !== "string" || requestId.length === 0)) return void 0;
+		return Object.freeze({
+			message,
+			code,
+			...status === void 0 ? {} : { status },
+			...providerRetryAfterMs === void 0 ? {} : { providerRetryAfterMs },
+			...requestId === void 0 ? {} : { requestId }
+		});
+	} catch (_sdkFailureGetter) {
+		return;
+	}
+}
+/** Read an SDK error message without letting an accessor replace the primary failure. */
+function errorMessage(error) {
+	try {
+		const message = error.message;
+		if (typeof message === "string" && message.length > 0) return message;
+	} catch (_sdkMessageGetter) {}
+	return "LLM adapter failed";
+}
+/** Trust only Harness-owned codes; third-party SDK codes are not our taxonomy. */
+function harnessErrorCode(error) {
+	return error instanceof HarnessError ? error.code : "UNKNOWN";
+}
+function quoted(value) {
+	return JSON.stringify(value);
+}
+/**
+* Stable text shown to a model that cannot accept one durable image reference.
+* @param ref - durable normalized attachment omitted from the request.
+* @returns deterministic text-only placeholder.
+*/
+function textOnlyImageText(ref) {
+	return `[image omitted because this model accepts text only; attachment sha256:${String(ref.attachmentId).slice(7, 15)}]`;
+}
+/**
+* True when typed model content contains an image block, walking nested
+* tool-result content. This is the one recursive image walk shared by every
+* image policy (capability gating, text-only serialization, compaction
+* survey), so a consumer cannot silently diverge on nesting depth.
+* @param content - typed model content blocks.
+* @returns whether any nested block is an image.
+*/
+function contentHasImage(content) {
+	return content.some((block) => block.type === "image" || block.type === "tool-result" && contentHasImage(block.content));
+}
+/**
+* True when typed model content contains a file block, walking nested
+* tool-result content on the same recursion every file policy shares.
+* Reads current content on every call without retaining scan results.
+* @param content - typed model content blocks.
+* @returns whether any nested block is a file.
+*/
+function contentHasFile(content) {
+	for (const block of content) if (block.type === "file" || block.type === "tool-result" && contentHasFile(block.content)) return true;
+	return false;
+}
+/**
+* Stable model-facing handle for one durable file reference: the address of
+* the verbatim stored copy and the instruction to read it on demand. This is
+* the only representation a provider ever receives for a file.
+* @param ref - durable verbatim file reference.
+* @param readonlyPath - execution-world path of the stored copy, when resolvable.
+* @returns deterministic handle text naming the file, its size, and its address.
+*/
+function fileHandleText(ref, readonlyPath) {
+	const digest = String(ref.attachmentId).slice(7, 15);
+	const identity = `File ${quoted(ref.name)} (${ref.bytes} bytes, sha256:${digest})`;
+	if (readonlyPath === void 0) return `[${identity} was uploaded, but the current execution environment cannot access a readable path. Report that limitation if its contents are needed; do not claim to have read it.]`;
+	return `[${identity}: verbatim read-only copy saved at ${quoted(readonlyPath)}. Read that path with your file tools when its contents are needed; copy it to a writable location before modifying it. When delegating file work, include this saved path in the delegation prompt; only subagents sharing this execution environment can read it.]`;
+}
+/** Replace every file occurrence, including nested tool results, with handle text. */
+function replaceFilesWithHandles(blocks, resolvePath) {
+	let next;
+	for (const [index, block] of blocks.entries()) {
+		if (block.type === "file") {
+			next ??= blocks.slice(0, index);
+			next.push({
+				type: "text",
+				text: fileHandleText(block.attachment, resolvePath(block.attachment))
+			});
+			continue;
+		}
+		if (block.type === "tool-result") {
+			const content = replaceFilesWithHandles(block.content, resolvePath);
+			if (content !== block.content) {
+				next ??= blocks.slice(0, index);
+				next.push({
+					...block,
+					content
+				});
+				continue;
+			}
+		}
+		next?.push(block);
+	}
+	return next ?? blocks;
+}
+/**
+* Project durable file history into deterministic handle text for every model
+* route. Unlike images, no provider receives file blocks natively, so this
+* projection is unconditional in request assembly.
+* @param messages - complete request history.
+* @param resolvePath - resolve one reference's current execution-world read path.
+* @returns the original list without files, otherwise shallow message copies with handle text.
+*/
+function projectFilesToText(messages, resolvePath) {
+	if (!messages.some((message) => contentHasFile(message.content))) return messages;
+	return messages.map((message) => {
+		const content = replaceFilesWithHandles(message.content, resolvePath);
+		return content === message.content ? message : {
+			...message,
+			content
+		};
+	});
+}
+/** Replace every image occurrence, including nested tool results, for a text-only model. */
+function replaceImagesForTextModel(blocks) {
+	let next;
+	for (const [index, block] of blocks.entries()) {
+		if (block.type === "image") {
+			next ??= blocks.slice(0, index);
+			next.push({
+				type: "text",
+				text: textOnlyImageText(block.attachment)
+			});
+			continue;
+		}
+		if (block.type === "tool-result") {
+			const content = replaceImagesForTextModel(block.content);
+			if (content !== block.content) {
+				next ??= blocks.slice(0, index);
+				next.push({
+					...block,
+					content
+				});
+				continue;
+			}
+		}
+		next?.push(block);
+	}
+	return next ?? blocks;
+}
+/**
+* Project durable image history into deterministic text for an exact text-only model.
+* @param messages - complete request history.
+* @returns the original list without images, otherwise shallow message copies with stable placeholders.
+*/
+function projectImagesForTextModel(messages) {
+	if (!messages.some((message) => contentHasImage(message.content))) return messages;
+	return messages.map((message) => {
+		const content = replaceImagesForTextModel(message.content);
+		return content === message.content ? message : {
+			...message,
+			content
+		};
+	});
+}
+/**
+* Centralize the non-secret product identity every provider request sends as `User-Agent`, keeping
+* adapters from drifting. See
+* `.agents/notes/implemented/architecture/2026-06-21-mandatory-app-attribution-headers.md`.
+*
+* App-attribution vocabulary for provider requests.
+* @module @deepseek-ai/dsh-llm/attribution
+*/
+const { version } = createRequire(import.meta.url)("../package.json");
+/**
+* LLM service: adapter registry with a waterfall-interceptable streaming call
+* API. Exports the `LlmRuntime` default, the abstract `LlmAdapter` for
+* provider backends, and `BlockAssembler` for chunk assembly.
+*
+* @module @deepseek-ai/dsh-llm
+*/
+var __runInitializers = function(thisArg, initializers, value) {
+	var useValue = arguments.length > 2;
+	for (var i = 0; i < initializers.length; i++) value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+	return useValue ? value : void 0;
+};
+var __esDecorate = function(ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+	function accept(f) {
+		if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected");
+		return f;
+	}
+	var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+	var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+	var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+	var _, done = false;
+	for (var i = decorators.length - 1; i >= 0; i--) {
+		var context = {};
+		for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+		for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+		context.addInitializer = function(f) {
+			if (done) throw new TypeError("Cannot add initializers after decoration has completed");
+			extraInitializers.push(accept(f || null));
+		};
+		var result = (0, decorators[i])(kind === "accessor" ? {
+			get: descriptor.get,
+			set: descriptor.set
+		} : descriptor[key], context);
+		if (kind === "accessor") {
+			if (result === void 0) continue;
+			if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+			if (_ = accept(result.get)) descriptor.get = _;
+			if (_ = accept(result.set)) descriptor.set = _;
+			if (_ = accept(result.init)) initializers.unshift(_);
+		} else if (_ = accept(result)) if (kind === "field") initializers.unshift(_);
+		else descriptor[key] = _;
+	}
+	if (target) Object.defineProperty(target, contextIn.name, descriptor);
+	done = true;
+};
+/**
+* Typed error for LLM-related failures. Extends {@link HarnessError}, so the
+* `code` string (e.g. `AUTH`, `RATE_LIMIT`, `NO_ADAPTER`) is shared taxonomy.
+*/
+var LlmError = class extends HarnessError {
+	/** Serializable facts retained beside this live Error. */
+	failure;
+	/**
+	* @param message - non-empty human-readable failure summary.
+	* @param code - non-empty stable provider-neutral machine code.
+	* @param options - optional cause and validated serializable provider facts.
+	*/
+	constructor(message, code, options) {
+		if (typeof message !== "string" || message.length === 0) throw new Error("LlmError message must be a non-empty string");
+		if (typeof code !== "string" || code.length === 0) throw new Error("LlmError code must be a non-empty string");
+		if (options?.status !== void 0 && (!Number.isInteger(options.status) || options.status < 100 || options.status > 599)) throw new Error("LlmError status must be an integer from 100 through 599");
+		if (options?.providerRetryAfterMs !== void 0 && (!Number.isFinite(options.providerRetryAfterMs) || options.providerRetryAfterMs <= 0)) throw new Error("LlmError providerRetryAfterMs must be a positive finite number");
+		if (options?.requestId !== void 0 && (typeof options.requestId !== "string" || options.requestId.length === 0)) throw new Error("LlmError requestId must be a non-empty string");
+		super(message, code, options);
+		this.name = "LlmError";
+		this.failure = Object.freeze({
+			message,
+			code,
+			...options?.status === void 0 ? {} : { status: options.status },
+			...options?.providerRetryAfterMs === void 0 ? {} : { providerRetryAfterMs: options.providerRetryAfterMs },
+			...options?.requestId === void 0 ? {} : { requestId: options.requestId }
+		});
+	}
+};
+(() => {
+	let _classSuper = TypertRemoteService;
+	let _instanceExtraInitializers = [];
+	let _listProviders_decorators;
+	let _listConfigurableProviders_decorators;
+	let _remoteDiscoverModels_decorators;
+	return class LlmRuntime extends _classSuper {
+		static {
+			const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+			_listProviders_decorators = [Remote];
+			_listConfigurableProviders_decorators = [Remote];
+			_remoteDiscoverModels_decorators = [Remote("discoverModels")];
+			__esDecorate(this, null, _listProviders_decorators, {
+				kind: "method",
+				name: "listProviders",
+				static: false,
+				private: false,
+				access: {
+					has: (obj) => "listProviders" in obj,
+					get: (obj) => obj.listProviders
+				},
+				metadata: _metadata
+			}, null, _instanceExtraInitializers);
+			__esDecorate(this, null, _listConfigurableProviders_decorators, {
+				kind: "method",
+				name: "listConfigurableProviders",
+				static: false,
+				private: false,
+				access: {
+					has: (obj) => "listConfigurableProviders" in obj,
+					get: (obj) => obj.listConfigurableProviders
+				},
+				metadata: _metadata
+			}, null, _instanceExtraInitializers);
+			__esDecorate(this, null, _remoteDiscoverModels_decorators, {
+				kind: "method",
+				name: "remoteDiscoverModels",
+				static: false,
+				private: false,
+				access: {
+					has: (obj) => "remoteDiscoverModels" in obj,
+					get: (obj) => obj.remoteDiscoverModels
+				},
+				metadata: _metadata
+			}, null, _instanceExtraInitializers);
+			if (_metadata) Object.defineProperty(this, Symbol.metadata, {
+				enumerable: true,
+				configurable: true,
+				writable: true,
+				value: _metadata
+			});
+		}
+		adapters = (__runInitializers(this, _instanceExtraInitializers), /* @__PURE__ */ new Map());
+		directory = /* @__PURE__ */ new Map();
+		discoveries = /* @__PURE__ */ new Map();
+		constructor(ctx) {
+			super(ctx, "llm");
+		}
+		/** Notify topology observers without letting one broken listener veto the commit. */
+		emitAdaptersUpdated() {
+			let invariantFailure;
+			for (const listener of this.ctx.events.dispatch("emit", ["llm/adapters-updated"])) try {
+				const returned = listener();
+				if (returned != null && typeof returned.then === "function") Promise.resolve(returned).then(void 0, (error) => {
+					this.warnAdaptersListenerFailure(error);
+				});
+			} catch (error) {
+				if (error?.code === "INVARIANT") {
+					invariantFailure ??= error;
+					continue;
+				}
+				this.warnAdaptersListenerFailure(error);
+			}
+			if (invariantFailure !== void 0) throw invariantFailure;
+		}
+		/** Contained-listener diagnostic shared by the sync and async failure paths. */
+		warnAdaptersListenerFailure(error) {
+			this.ctx.logger.warn("llm: an llm/adapters-updated listener failed");
+			this.ctx.logger.warn(error);
+		}
+		/**
+		* Register an adapter for the given provider routes. Throws `LlmError` with code
+		* `DUPLICATE_ADAPTER` if any provider already has an adapter (all-or-nothing).
+		* Disposed with the fiber.
+		* @param providers - every provider route this adapter should serve.
+		* @param adapter - the adapter that streams calls for those providers.
+		* @returns the disposer, carrying {@link AdapterRegistrationHandle.replace}.
+		*/
+		registerAdapter(providers, adapter) {
+			const owned = /* @__PURE__ */ new Set();
+			let released = false;
+			const dispose = this.ctx.effect(function* () {
+				if (providers.length === 0) throw new LlmError("an adapter must register at least one provider", "INVALID_ADAPTER");
+				this.commitRoutes(owned, this.prepareRoutes(providers, adapter, owned));
+				yield () => {
+					released = true;
+					for (const provider of owned) this.adapters.delete(provider);
+					owned.clear();
+					this.emitAdaptersUpdated();
+				};
+			}.bind(this), "llm.registerAdapter()");
+			const handle = (() => void dispose());
+			handle.replace = (next) => {
+				if (released) throw new LlmError("a disposed adapter registration cannot replace its routes", "REGISTRATION_DISPOSED");
+				this.commitRoutes(owned, this.prepareRoutes(next, adapter, owned));
+			};
+			return handle;
+		}
+		/**
+		* Validate one candidate route set for `adapter`, treating routes this
+		* registration already holds as available. Nothing is mutated: a rejected
+		* candidate leaves the registry exactly as it was.
+		*/
+		prepareRoutes(providers, adapter, owned) {
+			const unique = /* @__PURE__ */ new Set();
+			const registrations = [];
+			for (const provider of providers) {
+				if (provider.length === 0) throw new LlmError("adapter provider names must be non-empty", "INVALID_ADAPTER");
+				if (unique.has(provider) || this.adapters.has(provider) && !owned.has(provider)) throw new LlmError(`an adapter for provider "${provider}" is already registered`, "DUPLICATE_ADAPTER");
+				const info = adapter.providerInfo(provider);
+				if (typeof info.id !== "string" || info.id !== provider || typeof info.name !== "string" || info.name.length === 0) throw new LlmError(`adapter metadata for provider "${provider}" must preserve its id and have a non-empty name`, "INVALID_ADAPTER");
+				unique.add(provider);
+				const retryPolicy = adapter.providerRetryPolicy(provider) ?? resolveRetryPolicy(void 0, `llm: provider "${provider}" retryPolicy`);
+				registrations.push({
+					adapter,
+					provider: {
+						id: info.id,
+						name: info.name
+					},
+					retryPolicy
+				});
+			}
+			return registrations;
+		}
+		/**
+		* Swap this registration's routes for the prepared ones in one synchronous
+		* section, so no observer can see the registry between the release and the
+		* re-registration. The route set's one mutation point is also where
+		* `llm/adapters-updated` is published, so a `replace` announces itself
+		* exactly like a first registration.
+		*/
+		commitRoutes(owned, registrations) {
+			for (const provider of owned) this.adapters.delete(provider);
+			owned.clear();
+			for (const registration of registrations) {
+				this.adapters.set(registration.provider.id, registration);
+				owned.add(registration.provider.id);
+			}
+			this.emitAdaptersUpdated();
+		}
+		/**
+		* Describe provider routes with a registered adapter.
+		* @returns detached provider metadata in registration order.
+		*/
+		listProviders() {
+			return [...this.adapters.values()].map(({ provider }) => ({ ...provider }));
+		}
+		/**
+		* Declare provider routes an adapter plugin can activate through
+		* configuration. Registration is all-or-nothing: an empty list, invalid
+		* entry, or a provider already declared by any registration throws
+		* `LlmError` without registering the rest. Disposed with the fiber.
+		* @param entries - every configurable provider this plugin owns.
+		* @returns a handle that withdraws all of them, and can atomically replace them.
+		*/
+		registerConfigurableProviders(entries) {
+			let held = [];
+			let disposed = false;
+			/**
+			* Validate a candidate set in full against everything this registration
+			* does not already hold, then publish it. Nothing is written until the
+			* whole set passes, so a refused candidate leaves the current entries in
+			* place — the property that makes `replace` a swap rather than a
+			* delete-then-add that can strand the directory empty.
+			*/
+			const commit = (candidates) => {
+				const detached = [];
+				const own = new Set(held.map((entry) => entry.provider));
+				for (const entry of candidates) {
+					if (entry.provider.length === 0 || entry.displayName.length === 0 || entry.settingsNs.length === 0) throw new LlmError("configurable providers need a non-empty provider, displayName, and settingsNs", "INVALID_DIRECTORY");
+					if (entry.settingsPath.some((segment) => segment.length === 0)) throw new LlmError(`configurable provider "${entry.provider}" has an empty settingsPath segment`, "INVALID_DIRECTORY");
+					if (this.directory.has(entry.provider) && !own.has(entry.provider) || detached.some((seen) => seen.provider === entry.provider)) throw new LlmError(`configurable provider "${entry.provider}" is already declared`, "DUPLICATE_DIRECTORY");
+					detached.push({
+						...entry,
+						settingsPath: [...entry.settingsPath]
+					});
+				}
+				for (const entry of held) this.directory.delete(entry.provider);
+				for (const entry of detached) this.directory.set(entry.provider, entry);
+				held = detached;
+				this.emitAdaptersUpdated();
+			};
+			const dispose = this.ctx.effect(function* () {
+				if (entries.length === 0) throw new LlmError("a configurable-provider registration must declare at least one provider", "INVALID_DIRECTORY");
+				commit(entries);
+				yield () => {
+					disposed = true;
+					for (const entry of held) this.directory.delete(entry.provider);
+					held = [];
+					this.emitAdaptersUpdated();
+				};
+			}.bind(this), "llm.registerConfigurableProviders()");
+			const handle = (() => void dispose());
+			handle.replace = (next) => {
+				if (disposed) throw new LlmError("this configurable-provider registration was disposed", "REGISTRATION_DISPOSED");
+				commit(next);
+			};
+			return handle;
+		}
+		/**
+		* List every declared configurable provider, registered or dormant.
+		* @returns detached directory entries in declaration order.
+		*/
+		listConfigurableProviders() {
+			return [...this.directory.values()].map((entry) => ({
+				...entry,
+				settingsPath: [...entry.settingsPath]
+			}));
+		}
+		/**
+		* Offer to interrogate provider endpoints on behalf of the settings
+		* namespace this plugin owns. The namespace is the key because that is what
+		* a configuration surface already holds from the configurable-provider
+		* directory, and because a provider being *added* has no route to name yet.
+		* Disposed with the fiber.
+		* @param settingsNs - the namespace whose profiles this discovery serves.
+		* @param discover - interrogates one endpoint and must honor the supplied signal.
+		* @returns the disposer that withdraws the offer.
+		*/
+		registerModelDiscovery(settingsNs, discover) {
+			const dispose = this.ctx.effect(function* () {
+				if (settingsNs.length === 0) throw new LlmError("model discovery needs a non-empty settings namespace", "INVALID_DISCOVERY");
+				if (this.discoveries.has(settingsNs)) throw new LlmError(`model discovery for "${settingsNs}" is already registered`, "DUPLICATE_DISCOVERY");
+				this.discoveries.set(settingsNs, discover);
+				yield () => {
+					this.discoveries.delete(settingsNs);
+				};
+			}.bind(this), "llm.registerModelDiscovery()");
+			return () => void dispose();
+		}
+		/**
+		* Interrogate one provider endpoint for the models it advertises. The
+		* request describes a draft, not a stored route, so nothing here reads or
+		* writes settings or credentials — the caller owns both, and the reply is
+		* candidate metadata a surface may offer for adoption.
+		* @param settingsNs - namespace whose registered discovery serves this draft.
+		* @param request - the endpoint, protocol, and one-shot credential to use.
+		* @param signal - caller cancellation.
+		* @returns the advertised models, deduplicated in endpoint order.
+		*/
+		async discoverModels(settingsNs, request, signal) {
+			const discover = this.discoveries.get(settingsNs);
+			if (discover === void 0) throw new LlmError(`no model discovery is registered for "${settingsNs}"`, "NO_DISCOVERY");
+			if ((request.provider ?? "").length === 0 && (request.baseURL ?? "").length === 0) throw new LlmError("model discovery needs a provider route or a baseURL", "INVALID_DISCOVERY");
+			const discovered = signal === void 0 ? await discover(request) : await discover(request, signal);
+			const seen = /* @__PURE__ */ new Set();
+			const models = [];
+			for (const model of discovered) {
+				if (typeof model.id !== "string" || model.id.length === 0 || seen.has(model.id)) continue;
+				seen.add(model.id);
+				models.push({
+					id: model.id,
+					...model.name === void 0 ? {} : { name: model.name },
+					...model.contextWindow === void 0 ? {} : { contextWindow: model.contextWindow },
+					...model.maxTokens === void 0 ? {} : { maxTokens: model.maxTokens }
+				});
+			}
+			return models;
+		}
+		/**
+		* Remote adapter for one draft provider interrogation.
+		* @param settingsNs - namespace whose registered discovery serves this draft.
+		* @param request - endpoint, protocol, and one-shot credential to use.
+		* @param signal - caller cancellation supplied by the Remote carrier.
+		* @returns advertised models in endpoint order.
+		* @throws RemoteError with `llm/model-discovery-rejected` when discovery refuses or fails.
+		*/
+		async remoteDiscoverModels(settingsNs, request, signal) {
+			try {
+				return await this.discoverModels(settingsNs, request, signal);
+			} catch (error) {
+				throw new RemoteError("llm/model-discovery-rejected", error instanceof Error ? error.message : String(error), {
+					settingsNs,
+					...request.baseURL === void 0 ? {} : { baseURL: request.baseURL }
+				}, { cause: error });
+			}
+		}
+		/**
+		* Resolve the retry policy captured when one provider route was registered.
+		* @param provider - registered provider route to inspect.
+		* @returns the provider-owned policy, with normal defaults already resolved.
+		*/
+		providerRetryPolicy(provider) {
+			return this.registration(provider).retryPolicy;
+		}
+		/**
+		* Resolve provider-side request-image pricing for one exact route, or
+		* `undefined` when the provider is unregistered or declares none. Unknown
+		* providers degrade to `undefined` rather than throwing because callers
+		* price durable history whose route may no longer be mounted.
+		* @param provider - provider route named by a request header.
+		* @param model - exact model id named by the same header.
+		* @returns the owning adapter's image pricing for the route, when declared.
+		*/
+		imageRequestPricing(provider, model) {
+			return this.adapters.get(provider)?.adapter.imageRequestPricing(provider, model);
+		}
+		/**
+		* Resolve the exact text one durable file occurrence contributes to every
+		* provider request in the current execution environment.
+		* @param ref - durable verbatim file reference from model history.
+		* @returns the same deterministic handle text used at adapter dispatch.
+		*/
+		fileRequestText(ref) {
+			return fileHandleText(ref, this.fileReadPath(ref));
+		}
+		/** Detach typed adapter-owned modality metadata. */
+		detachedModalities(modalities) {
+			return modalities === void 0 ? void 0 : [...modalities];
+		}
+		/**
+		* Discover models advertised by one registered provider. Catalog membership
+		* is advisory and never changes routing or request validation.
+		* @param provider - registered provider route to inspect.
+		* @returns detached model metadata in adapter-preferred order.
+		*/
+		async listModels(provider) {
+			const models = await this.registration(provider).adapter.listModels(provider);
+			const seen = /* @__PURE__ */ new Set();
+			return models.map((model) => {
+				if (typeof model.provider !== "string" || model.provider !== provider || typeof model.id !== "string" || model.id.length === 0 || typeof model.name !== "string" || model.name.length === 0 || model.description !== void 0 && typeof model.description !== "string" || seen.has(model.id)) throw new LlmError(`adapter returned invalid or duplicate model metadata for provider "${provider}"`, "INVALID_CATALOG");
+				seen.add(model.id);
+				const inputModalities = this.detachedModalities(model.inputModalities);
+				return {
+					provider: model.provider,
+					id: model.id,
+					name: model.name,
+					...model.description === void 0 ? {} : { description: model.description },
+					...inputModalities === void 0 ? {} : { inputModalities }
+				};
+			});
+		}
+		/**
+		* Resolve and validate all metadata from the adapter that owns one exact
+		* route. The result is detached from adapter-owned objects; catalog
+		* membership remains advisory and does not control request routing.
+		* @param provider - registered provider route to inspect.
+		* @param model - exact model id passed to the adapter.
+		* @param signal - optional cancellation for adapter-owned asynchronous lookup.
+		* @returns exact model identity plus available context and reasoning metadata.
+		*/
+		async resolveModelInfo(provider, model, signal) {
+			return this.resolveModelInfoFor(this.registration(provider), model, signal);
+		}
+		async resolveModelInfoFor(registration, model, signal) {
+			const resolved = await registration.adapter.resolveModel(registration.provider.id, model, signal);
+			return this.normalizeModelInfo(registration, model, resolved);
+		}
+		/** Validate and detach one adapter-returned exact model result. */
+		normalizeModelInfo(registration, model, resolved) {
+			const provider = registration.provider.id;
+			if (typeof resolved.provider !== "string" || resolved.provider !== provider || typeof resolved.id !== "string" || resolved.id !== model || typeof resolved.name !== "string" || resolved.name.length === 0 || resolved.description !== void 0 && typeof resolved.description !== "string") throw new LlmError(`adapter returned invalid exact model metadata for provider "${provider}" model "${model}"`, "INVALID_MODEL_INFO");
+			const context = resolved.context;
+			if (context !== void 0 && (!Number.isInteger(context.contextWindow) || context.contextWindow <= 0)) throw new LlmError(`adapter returned invalid context metadata for provider "${provider}" model "${model}"`, "INVALID_MODEL_CONTEXT");
+			const inputModalities = this.detachedModalities(resolved.inputModalities);
+			const systemPromptUpdate = resolved.systemPromptUpdate;
+			if (systemPromptUpdate !== void 0 && systemPromptUpdate !== "in-history") throw new LlmError(`adapter returned invalid system prompt update mode for provider "${provider}" model "${model}"`, "INVALID_MODEL_INFO");
+			const defaultMaxTokens = resolved.defaultMaxTokens;
+			if (defaultMaxTokens !== void 0 && (!Number.isSafeInteger(defaultMaxTokens) || defaultMaxTokens <= 0)) throw new LlmError(`adapter returned invalid default maxTokens for provider "${provider}" model "${model}"`, "INVALID_MODEL_MAX_TOKENS");
+			const info = {
+				provider,
+				id: model,
+				name: resolved.name,
+				...resolved.description === void 0 ? {} : { description: resolved.description },
+				...inputModalities === void 0 ? {} : { inputModalities },
+				...context === void 0 ? {} : { context: { contextWindow: context.contextWindow } },
+				...defaultMaxTokens === void 0 ? {} : { defaultMaxTokens },
+				...resolved.systemPromptUpdate === void 0 ? {} : { systemPromptUpdate: resolved.systemPromptUpdate }
+			};
+			const reasoning = resolved.reasoning;
+			if (reasoning === void 0) return info;
+			if (reasoning.efforts.length === 0) throw new LlmError(`adapter returned invalid reasoning metadata for provider "${provider}" model "${model}"`, "INVALID_MODEL_REASONING");
+			const seen = /* @__PURE__ */ new Set();
+			const efforts = reasoning.efforts.map((effort) => {
+				if (typeof effort.id !== "string" || effort.id.length === 0 || typeof effort.name !== "string" || effort.name.length === 0 || effort.description !== void 0 && typeof effort.description !== "string" || seen.has(effort.id)) throw new LlmError(`adapter returned invalid or duplicate reasoning effort metadata for provider "${provider}" model "${model}"`, "INVALID_MODEL_REASONING");
+				seen.add(effort.id);
+				return {
+					id: effort.id,
+					name: effort.name,
+					...effort.description === void 0 ? {} : { description: effort.description }
+				};
+			});
+			if (reasoning.defaultEffort !== void 0 && !seen.has(reasoning.defaultEffort)) throw new LlmError(`adapter returned an unknown default reasoning effort for provider "${provider}" model "${model}"`, "INVALID_MODEL_REASONING");
+			return {
+				...info,
+				reasoning: {
+					efforts,
+					...reasoning.defaultEffort === void 0 ? {} : { defaultEffort: reasoning.defaultEffort }
+				}
+			};
+		}
+		/**
+		* Validate a conversation call config against its exact model capability and
+		* materialize adapter-configured defaults. Unsupported explicit efforts
+		* reject before provider I/O; no clamping or aliasing is performed. This
+		* standalone query does not bind a later dispatch; use {@link prepareCall}
+		* when logging and streaming must share one adapter registration.
+		* @param config - provider/model route and optional request controls.
+		* @param signal - optional cancellation for adapter-owned capability lookup.
+		* @returns a detached config only when a default must be materialized.
+		*/
+		async resolveCallConfig(config, signal) {
+			return (await this.resolveCallFor(this.registration(config.provider), config, signal)).config;
+		}
+		async resolveCallFor(registration, config, signal) {
+			const info = await this.resolveModelInfoFor(registration, config.model, signal);
+			return this.resolveCallWithInfo(config, info);
+		}
+		/** Validate request controls against one already-bound exact model result. */
+		resolveCallWithInfo(config, info) {
+			const defaulted = config.maxTokens === void 0 && info.defaultMaxTokens !== void 0 ? {
+				...config,
+				maxTokens: info.defaultMaxTokens
+			} : config;
+			const reasoning = info.reasoning;
+			const requested = defaulted.reasoningEffort;
+			let resolvedConfig = defaulted;
+			if (reasoning === void 0) {
+				if (requested !== void 0) throw new LlmError(`provider "${config.provider}" model "${config.model}" does not support reasoning effort "${requested}"`, "UNSUPPORTED_REASONING_EFFORT");
+			} else {
+				const effective = requested ?? reasoning.defaultEffort;
+				if (effective !== void 0) {
+					if (!reasoning.efforts.some((effort) => effort.id === effective)) throw new LlmError(`provider "${config.provider}" model "${config.model}" does not support reasoning effort "${effective}"`, "UNSUPPORTED_REASONING_EFFORT");
+					if (requested !== effective) resolvedConfig = {
+						...defaulted,
+						reasoningEffort: effective
+					};
+				}
+			}
+			return {
+				config: resolvedConfig,
+				...info.context === void 0 ? {} : { context: info.context },
+				modelInfo: info
+			};
+		}
+		/**
+		* Resolve one call under its current adapter registration. The returned
+		* one-shot handle keeps that registration across header logging and dispatch,
+		* so HMR cannot combine one adapter's capability result with another adapter.
+		* @param config - provider/model route and optional request controls.
+		* @param signal - optional cancellation for adapter-owned capability lookup.
+		* @returns a prepared config and its registration-bound stream entry point.
+		*/
+		async prepareCall(config, signal) {
+			const registration = this.registration(config.provider);
+			const adapterCall = await registration.adapter.prepareCall(config.provider, config.model, signal);
+			const modelInfo = this.normalizeModelInfo(registration, config.model, adapterCall.model);
+			const resolved = this.resolveCallWithInfo(config, modelInfo);
+			const resolvedConfig = deepFreeze(structuredClone(resolved.config));
+			const context = resolved.context === void 0 ? void 0 : deepFreeze(structuredClone(resolved.context));
+			const adapterDefaults = deepFreeze({
+				...config.reasoningEffort === void 0 && resolvedConfig.reasoningEffort !== void 0 ? { reasoningEffort: true } : {},
+				...config.maxTokens === void 0 && resolvedConfig.maxTokens !== void 0 ? { maxTokens: true } : {}
+			});
+			let dispatched = false;
+			return Object.freeze({
+				config: resolvedConfig,
+				retryPolicy: registration.retryPolicy,
+				adapterDefaults,
+				...context === void 0 ? {} : { context },
+				...modelInfo.inputModalities === void 0 ? {} : { inputModalities: Object.freeze([...modelInfo.inputModalities]) },
+				...modelInfo.systemPromptUpdate === void 0 ? {} : { systemPromptUpdate: modelInfo.systemPromptUpdate },
+				stream: (options) => {
+					if (dispatched) throw new LlmError("a prepared LLM call can only be dispatched once", "INVALID_PREPARED_CALL");
+					if (!callConfigEquals(options, resolvedConfig)) throw new LlmError("prepared LLM call config changed before adapter dispatch", "INVALID_PREPARED_CALL");
+					dispatched = true;
+					return this.streamWithRegistration(options, {
+						registration,
+						config: resolvedConfig,
+						modelInfo,
+						dispatch: (options) => adapterCall.stream(options)
+					});
+				}
+			});
+		}
+		registration(provider) {
+			const registration = this.adapters.get(provider);
+			if (!registration) throw new LlmError(`no adapter registered for provider "${provider}"`, "NO_ADAPTER");
+			return registration;
+		}
+		/** Remove replay state whose historical route is owned by another adapter. */
+		forAdapter(options, adapter) {
+			const messages = options.messages.map((message) => {
+				const source = message.source;
+				if (message.role !== "assistant" || source.kind !== "model" || source.replayState === void 0) return message;
+				if (this.adapters.get(source.provider)?.adapter === adapter) return message;
+				return freezeMessage({
+					...message,
+					source: {
+						kind: "model",
+						provider: source.provider,
+						model: source.model
+					}
+				});
+			});
+			if (messages.every((message, index) => message === options.messages[index])) return options;
+			const filtered = {
+				...options,
+				messages
+			};
+			return Object.isFrozen(options) ? deepFreeze(filtered) : filtered;
+		}
+		/**
+		* Resolve the current execution-world read path of one durable file
+		* reference through the mounted attachment and filesystem providers.
+		*/
+		fileReadPath(ref) {
+			let hostPath;
+			try {
+				hostPath = this.ctx.get("attachments")?.fileHostPath(ref);
+			} catch {
+				return;
+			}
+			if (hostPath === void 0) return void 0;
+			return this.ctx.get("fs")?.processPathFromHostPath(hostPath);
+		}
+		/**
+		* Final adapter boundary. Adapter selection, dispatch, iterator construction,
+		* and iteration failures become one terminal failure chunk. Middleware and
+		* downstream consumer failures remain thrown plugin or consumer errors.
+		*/
+		async *adapterStream(options, prepared) {
+			let iterator;
+			try {
+				const registration = prepared?.registration ?? this.registration(options.provider);
+				const adapter = registration.adapter;
+				let modelInfo;
+				let resolvedConfig;
+				let dispatch;
+				if (prepared === void 0) {
+					const adapterCall = await adapter.prepareCall(options.provider, options.model, options.signal);
+					modelInfo = this.normalizeModelInfo(registration, options.model, adapterCall.model);
+					resolvedConfig = this.resolveCallWithInfo(options, modelInfo).config;
+					dispatch = (options) => adapterCall.stream(options);
+				} else {
+					modelInfo = prepared.modelInfo;
+					resolvedConfig = prepared.config;
+					dispatch = prepared.dispatch;
+				}
+				if (prepared !== void 0 && !callConfigEquals(options, resolvedConfig)) throw new LlmError("prepared LLM call config changed before adapter dispatch", "INVALID_PREPARED_CALL");
+				const resolvedOptions = callConfigEquals(options, resolvedConfig) ? options : Object.isFrozen(options) ? deepFreeze({
+					...options,
+					...resolvedConfig
+				}) : {
+					...options,
+					...resolvedConfig
+				};
+				let projectedMessages = resolvedOptions.messages;
+				if (projectedMessages.some((message) => contentHasFile(message.content))) projectedMessages = projectFilesToText(projectedMessages, (ref) => this.fileReadPath(ref));
+				if (modelInfo.inputModalities !== void 0 && !modelInfo.inputModalities.includes("image") && projectedMessages.some((message) => contentHasImage(message.content))) projectedMessages = projectImagesForTextModel(projectedMessages);
+				const projectedOptions = projectedMessages === resolvedOptions.messages ? resolvedOptions : Object.isFrozen(resolvedOptions) ? deepFreeze({
+					...resolvedOptions,
+					messages: projectedMessages
+				}) : {
+					...resolvedOptions,
+					messages: projectedMessages
+				};
+				iterator = dispatch(this.forAdapter(projectedOptions, adapter))[Symbol.asyncIterator]();
+			} catch (error) {
+				yield adapterFailureChunk(error, options.signal);
+				return;
+			}
+			let completed = false;
+			try {
+				while (true) {
+					let item;
+					try {
+						const next = await iterator.next();
+						item = next.done ? { done: true } : {
+							done: false,
+							value: next.value
+						};
+					} catch (error) {
+						completed = true;
+						yield adapterFailureChunk(error, options.signal);
+						return;
+					}
+					if (item.done) {
+						completed = true;
+						return;
+					}
+					yield item.value;
+				}
+			} finally {
+				if (!completed) {
+					const close = iterator.return?.bind(iterator);
+					if (close) await close();
+				}
+			}
+		}
+		/**
+		* Stream one model call as raw chunks (token-level deltas). Replay state is
+		* retained only when the same adapter instance owns its historical provider
+		* and the target provider. Final adapter selection remains fixed through
+		* asynchronous exact-model resolution and dispatch. Adapter selection,
+		* dispatch, and iteration failures become terminal `error` or `aborted`
+		* finish chunks; middleware, nested-call, cleanup, and consumer failures
+		* remain thrown.
+		* @param options - the full request; `options.provider` selects the adapter.
+		* @returns the chunk stream, possibly wrapped by `llm/stream` listeners.
+		*/
+		stream(options) {
+			return this.streamWithRegistration(options);
+		}
+		streamWithRegistration(options, prepared) {
+			return this.ctx.waterfall(this, "llm/stream", options, () => this.adapterStream(options, prepared));
+		}
+	};
+})();
+/** Convert one adapter throw into the stream protocol's terminal outcome. */
+function adapterFailureChunk(error, signal) {
+	const failure = normalizeLlmFailure(error);
+	return {
+		type: "finish",
+		reason: signal?.aborted || failure.code === "ABORTED" ? {
+			kind: "aborted",
+			failure
+		} : {
+			kind: "error",
+			failure
+		}
+	};
+}
+//#endregion
 //#region src/trust-fence.ts
 function header(headers, name) {
 	const value = headers[name];
@@ -53,16 +4041,6 @@ function isTrustedApiRequest(request, trustedHosts) {
 }
 //#endregion
 //#region src/index.ts
-let createUserMessageCached;
-async function loadCreateUserMessage() {
-	if (createUserMessageCached !== void 0) return createUserMessageCached;
-	try {
-		createUserMessageCached = (await import("./lib-DHFe7-hr.js")).createUserMessage;
-	} catch {
-		createUserMessageCached = null;
-	}
-	return createUserMessageCached;
-}
 /** Plugin identity for cordis.yml rows. */
 const name = "dsh-sidenote";
 const MAX_BODY_BYTES = 65536;
@@ -131,14 +4109,6 @@ function makeReflowHandler(ctx) {
 			});
 			return;
 		}
-		const createUserMessage = await loadCreateUserMessage();
-		if (createUserMessage === null) {
-			writeJson(res, 200, {
-				ok: false,
-				error: "dsh-llm-unavailable"
-			});
-			return;
-		}
 		for (const item of valid) {
 			const sideTitle = typeof item.sideTitle === "string" ? item.sideTitle : "";
 			const summary = (sideTitle === "" ? "侧边聊天的结论回流" : `来自「${sideTitle}」的结论回流`).slice(0, 120);