@smthrs/plugin 0.0.0-stage → 1.0.0-rc.4

package/dist/esm/Resolve.js

@@ -0,0 +1,367 @@
+/**
+ * Bounded plugin resolution: admit, filter, validate, order, and snapshot.
+ *
+ * The resulting catalog owns every record it exposes. Dispatch never reads a
+ * caller-owned map, plugin record, hook object, config value, or cache identity.
+ *
+ * @since 1.0.0-rc.0
+ */
+import * as ImmutableMap from "@smthrs/canonical/ReadonlyMap";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Config from "./Config.js";
+import { engineHooks, handlerOf, orderOf } from "./Hooks.js";
+import * as Boundary from "./internal/Boundary.js";
+import { mergePluginLayers } from "./internal/mergePluginLayers.js";
+import { snapshotCacheEnvironment } from "./internal/snapshotCacheEnvironment.js";
+import { PluginError } from "./PluginError.js";
+/**
+ * Maximum nested preset-array depth accepted at startup.
+ *
+ * @category limits
+ * @since 1.0.0-rc.0
+ */
+export const maximumPluginDepth = 64;
+/**
+ * Maximum plugins accepted by one kernel.
+ *
+ * @category limits
+ * @since 1.0.0-rc.0
+ */
+export const maximumPlugins = 256;
+/**
+ * Maximum aggregate hook handlers accepted by one kernel.
+ *
+ * @category limits
+ * @since 1.0.0-rc.0
+ */
+export const maximumHandlers = 1_024;
+/**
+ * Maximum input nodes, including arrays and omitted entries.
+ *
+ * @category limits
+ * @since 1.0.0-rc.0
+ */
+export const maximumPluginInputNodes = 4_096;
+/**
+ * Maximum UTF-16 length of one plugin or hook name.
+ *
+ * @category limits
+ * @since 1.0.0-rc.0
+ */
+export const maximumPluginNameLength = 256;
+/**
+ * Default fiber bound for parallel observers.
+ *
+ * @category limits
+ * @since 1.0.0-rc.0
+ */
+export const defaultParallelConcurrency = 16;
+/**
+ * Maximum configurable parallel-observer bound.
+ *
+ * @category limits
+ * @since 1.0.0-rc.0
+ */
+export const maximumParallelConcurrency = 256;
+const failure = (code, message, path, fields = {}) => new PluginError({ code, message, path, ...fields });
+const invalidPlugin = (path, complaint, fields = {}) => failure("invalid_plugin", `plugin input ${complaint}`, path, fields);
+// Bound before quoting or scanning caller-controlled keys. Keep Boundary's
+// identifier/dot and JSON-quoted/bracket path convention.
+const diagnosticKey = (key) => key.length > 64 ? `${key.slice(0, 64)}...` : key;
+const childPath = (path, key) => {
+    const bounded = diagnosticKey(key);
+    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(bounded) ? `${path}.${bounded}` : `${path}[${JSON.stringify(bounded)}]`;
+};
+const ownData = (input, path, allowed) => {
+    if (typeof input !== "object" || input === null || Array.isArray(input)) {
+        throw invalidPlugin(path, "must be an ordinary record");
+    }
+    const prototype = Object.getPrototypeOf(input);
+    if (prototype !== Object.prototype && prototype !== null)
+        throw invalidPlugin(path, "must be an ordinary record");
+    const output = {};
+    for (const key of Reflect.ownKeys(input)) {
+        if (typeof key !== "string")
+            throw invalidPlugin(path, "must not contain symbol keys");
+        if (allowed !== undefined && !allowed.has(key)) {
+            throw invalidPlugin(childPath(path, key), "contains an unknown property");
+        }
+        const descriptor = Object.getOwnPropertyDescriptor(input, key);
+        if (descriptor === undefined || !("value" in descriptor) || !descriptor.enumerable) {
+            throw invalidPlugin(childPath(path, key), "must be an enumerable data property");
+        }
+        Object.defineProperty(output, key, { value: descriptor.value, enumerable: true });
+    }
+    return output;
+};
+const snapshotOptions = (input) => {
+    const values = ownData(input, "$options", new Set(["config", "target", "hooks", "cacheEnvironment", "parallelConcurrency"]));
+    return {
+        config: values.config,
+        target: values.target,
+        hooks: values.hooks,
+        cacheEnvironment: values.cacheEnvironment,
+        parallelConcurrency: values.parallelConcurrency
+    };
+};
+const validName = (value) => typeof value === "string" && value.length > 0 && value.length <= maximumPluginNameLength &&
+    Boundary.isWellFormedText(value) && !/^\s*$/u.test(value) && !/\p{Cc}/u.test(value);
+const snapshotCatalog = (input) => {
+    if (typeof input !== "object" || input === null || Array.isArray(input)) {
+        throw invalidPlugin("$options.hooks", "must be an ordinary hook catalog");
+    }
+    const prototype = Object.getPrototypeOf(input);
+    if (prototype !== Object.prototype && prototype !== null) {
+        throw invalidPlugin("$options.hooks", "must be an ordinary hook catalog");
+    }
+    const output = {};
+    for (const key of Reflect.ownKeys(input)) {
+        if (typeof key !== "string" || !validName(key)) {
+            throw invalidPlugin("$options.hooks", "contains an invalid hook name");
+        }
+        const descriptor = Object.getOwnPropertyDescriptor(input, key);
+        if (descriptor === undefined || !("value" in descriptor) || !descriptor.enumerable) {
+            throw invalidPlugin(childPath("$options.hooks", key), "must be an enumerable data property");
+        }
+        if (!["sequential", "parallel", "first", "waterfall"].includes(descriptor.value)) {
+            throw invalidPlugin(childPath("$options.hooks", key), "contains an invalid hook kind");
+        }
+        Object.defineProperty(output, key, { value: descriptor.value, enumerable: true });
+    }
+    for (const hook of Object.keys(engineHooks)) {
+        if (Object.hasOwn(output, hook) && output[hook] !== engineHooks[hook]) {
+            throw failure("hook_kind_mismatch", `hook catalog declares shared hook ${JSON.stringify(hook)} as ${JSON.stringify(output[hook])}, the kernel dispatches it as ${JSON.stringify(engineHooks[hook])}`, childPath("$options.hooks", hook), { hook });
+        }
+    }
+    return Object.freeze(output);
+};
+const snapshotHook = (entry, path, plugin, hook) => {
+    if (typeof entry === "function")
+        return entry;
+    if (entry === undefined) {
+        throw invalidPlugin(path, "must be a function or a hook object", { plugin, hook });
+    }
+    const values = ownData(entry, path, new Set(["order", "handler"]));
+    if (typeof values.handler !== "function") {
+        throw invalidPlugin(`${path}.handler`, "must be a function", { plugin, hook });
+    }
+    if (values.order !== undefined && values.order !== "pre" && values.order !== "post") {
+        throw invalidPlugin(`${path}.order`, "must be pre or post", { plugin, hook });
+    }
+    return Object.freeze({
+        ...(values.order === undefined ? {} : { order: values.order }),
+        handler: values.handler
+    });
+};
+const snapshotPlugin = (input, path) => {
+    const values = ownData(input, path, new Set(["name", "version", "enforce", "apply", "layer", "hooks"]));
+    if (!validName(values.name))
+        throw invalidPlugin(`${path}.name`, "requires a bounded non-empty name");
+    const name = values.name;
+    if (values.version !== undefined && !validName(values.version)) {
+        throw invalidPlugin(`${path}.version`, "requires a bounded non-empty version", { plugin: name });
+    }
+    if (values.enforce !== undefined && values.enforce !== "pre" && values.enforce !== "post") {
+        throw invalidPlugin(`${path}.enforce`, "must be pre or post", { plugin: name });
+    }
+    if (values.apply !== undefined && values.apply !== "engine" && values.apply !== "harness" &&
+        typeof values.apply !== "function")
+        throw invalidPlugin(`${path}.apply`, "must be engine, harness, or a predicate", { plugin: name });
+    if (values.layer !== undefined && !Layer.isLayer(values.layer)) {
+        throw invalidPlugin(`${path}.layer`, "must be an Effect Layer", { plugin: name });
+    }
+    let hooks;
+    if (values.hooks !== undefined) {
+        const rawHooks = ownData(values.hooks, `${path}.hooks`);
+        const snapshot = Object.create(null);
+        for (const [index, hook] of Object.keys(rawHooks).entries()) {
+            if (!validName(hook)) {
+                throw invalidPlugin(`${path}.hooks[${index}]`, "contains an invalid hook name");
+            }
+            const entry = rawHooks[hook];
+            Object.defineProperty(snapshot, hook, {
+                value: snapshotHook(entry, childPath(`${path}.hooks`, hook), name, hook),
+                enumerable: true
+            });
+        }
+        hooks = Object.freeze(snapshot);
+    }
+    return Object.freeze({
+        name,
+        ...(values.version === undefined ? {} : { version: values.version }),
+        ...(values.enforce === undefined ? {} : { enforce: values.enforce }),
+        ...(values.apply === undefined ? {} : { apply: values.apply }),
+        ...(values.layer === undefined ? {} : { layer: values.layer }),
+        ...(hooks === undefined ? {} : { hooks: hooks })
+    });
+};
+const flatten = (input) => {
+    const output = [];
+    const arrays = new WeakSet();
+    const stack = [
+        { value: input, path: "$", depth: 0 }
+    ];
+    let nodes = 0;
+    while (stack.length > 0) {
+        const current = stack.pop();
+        nodes += 1;
+        if (current.value === false || current.value === null || current.value === undefined)
+            continue;
+        if (Array.isArray(current.value)) {
+            if (current.depth >= maximumPluginDepth) {
+                throw failure("resource_limit", `plugin input exceeds the depth limit of ${maximumPluginDepth}`, current.path);
+            }
+            if (arrays.has(current.value))
+                throw invalidPlugin(current.path, "contains a cycle or repeated preset array");
+            arrays.add(current.value);
+            const length = current.value.length;
+            // Every queued frame and array element costs a node, including omitted
+            // entries. Refuse before enumerating keys, descriptors, or child frames.
+            if (length > maximumPluginInputNodes - nodes - stack.length) {
+                throw failure("resource_limit", `plugin input exceeds the ${maximumPluginInputNodes}-node limit`, current.path);
+            }
+            const keys = Reflect.ownKeys(current.value);
+            if (keys.length !== length + 1 || !keys.includes("length")) {
+                throw invalidPlugin(current.path, "must be a dense preset array with no extra properties");
+            }
+            for (let index = length - 1; index >= 0; index--) {
+                const descriptor = Object.getOwnPropertyDescriptor(current.value, String(index));
+                if (descriptor === undefined || !("value" in descriptor) || !descriptor.enumerable) {
+                    throw invalidPlugin(`${current.path}[${index}]`, "must be an enumerable data property");
+                }
+                stack.push({ value: descriptor.value, path: `${current.path}[${index}]`, depth: current.depth + 1 });
+            }
+            continue;
+        }
+        output.push(Object.freeze({ plugin: snapshotPlugin(current.value, current.path), path: current.path }));
+        if (output.length > maximumPlugins) {
+            throw failure("resource_limit", `plugin input exceeds the ${maximumPlugins}-plugin limit`, current.path);
+        }
+    }
+    return output;
+};
+const included = (plugin, config, target) => {
+    const apply = plugin.apply;
+    if (apply === undefined)
+        return Effect.succeed(true);
+    if (typeof apply !== "function")
+        return Effect.succeed(apply === target);
+    return Effect.try({
+        try: () => apply(config),
+        catch: () => failure("apply_failed", `plugin "${plugin.name}" apply predicate failed`, "$.apply", {
+            plugin: plugin.name
+        })
+    }).pipe(Effect.flatMap((result) => typeof result === "boolean"
+        ? Effect.succeed(result)
+        : Effect.fail(invalidPlugin("$.apply", "predicate must return a boolean", { plugin: plugin.name }))));
+};
+const rank = (enforce) => (enforce === "pre" ? 0 : enforce === "post" ? 2 : 1);
+/**
+ * Resolves a plugin preset into an immutable, resource-bounded catalog.
+ *
+ * @category constructors
+ * @since 1.0.0-rc.0
+ */
+export const resolve = (input, options = {}, configOverride) => Effect.gen(function* () {
+    const raw = yield* Effect.try({
+        try: () => snapshotOptions(options),
+        catch: (cause) => cause instanceof PluginError
+            ? cause
+            : invalidPlugin("$options", "could not be inspected without executing user code")
+    });
+    if (configOverride !== undefined && raw.config !== undefined) {
+        return yield* Effect.fail(invalidPlugin("$options.config", "cannot declare config in options alongside the positional override"));
+    }
+    if (raw.target !== undefined && raw.target !== "engine" && raw.target !== "harness") {
+        return yield* Effect.fail(invalidPlugin("$options.target", "must be engine or harness"));
+    }
+    if (raw.parallelConcurrency !== undefined &&
+        (typeof raw.parallelConcurrency !== "number" || !Number.isSafeInteger(raw.parallelConcurrency) ||
+            raw.parallelConcurrency <= 0 ||
+            raw.parallelConcurrency > maximumParallelConcurrency)) {
+        return yield* Effect.fail(failure("resource_limit", `parallel concurrency must be between 1 and ${maximumParallelConcurrency}`, "$options.parallelConcurrency"));
+    }
+    const parallelConcurrency = raw.parallelConcurrency === undefined
+        ? defaultParallelConcurrency
+        : raw.parallelConcurrency;
+    const config = yield* Config.snapshot(configOverride ?? raw.config ?? {});
+    const known = yield* Effect.try({
+        try: () => snapshotCatalog(raw.hooks ?? engineHooks),
+        catch: (cause) => cause instanceof PluginError
+            ? cause
+            : invalidPlugin("$options.hooks", "could not be inspected without executing user code")
+    });
+    const admitted = yield* Effect.try({
+        try: () => flatten(input),
+        catch: (cause) => cause instanceof PluginError
+            ? cause
+            : invalidPlugin("$", "could not be inspected without executing user code")
+    });
+    const target = raw.target ?? "engine";
+    const selected = yield* Effect.filter(admitted, ({ plugin }) => included(plugin, config, target));
+    let handlerCount = 0;
+    for (const { path, plugin } of selected) {
+        const pluginHooks = plugin.hooks;
+        if (pluginHooks === undefined)
+            continue;
+        for (const hook of Object.keys(pluginHooks)) {
+            if (!Object.hasOwn(known, hook)) {
+                return yield* Effect.fail(failure("unknown_hook", `plugin ${JSON.stringify(plugin.name)} declares unknown hook ${JSON.stringify(diagnosticKey(hook))}`, childPath(`${path}.hooks`, hook), { plugin: plugin.name, hook }));
+            }
+            handlerCount += 1;
+            if (handlerCount > maximumHandlers) {
+                return yield* Effect.fail(failure("resource_limit", `plugin handlers exceed the limit of ${maximumHandlers}`, childPath(`${path}.hooks`, hook)));
+            }
+        }
+    }
+    const seen = new Set();
+    for (const { plugin } of selected) {
+        if (seen.has(plugin.name)) {
+            return yield* Effect.fail(failure("duplicate_name", `duplicate plugin name "${plugin.name}"`, "$.name", { plugin: plugin.name }));
+        }
+        seen.add(plugin.name);
+    }
+    const plugins = Object.freeze(selected
+        .map(({ plugin }, index) => ({ plugin, index }))
+        .sort((left, right) => rank(left.plugin.enforce) - rank(right.plugin.enforce) || left.index - right.index)
+        .map(({ plugin }) => plugin));
+    const entries = [];
+    for (const hook of Object.keys(known)) {
+        const records = [];
+        for (const [index, plugin] of plugins.entries()) {
+            const pluginHooks = plugin.hooks;
+            if (pluginHooks === undefined || !Object.hasOwn(pluginHooks, hook))
+                continue;
+            const entry = pluginHooks[hook];
+            const record = Object.freeze({ plugin: plugin.name, hook, handler: handlerOf(entry) });
+            records.push({ record, enforceRank: rank(plugin.enforce), orderRank: rank(orderOf(entry)), index });
+        }
+        // Vite's rule, verbatim: the per-hook `order` is the outer partition and
+        // the enforce-sorted plugin list supplies the stable order inside it, so a
+        // hook marked `order: "pre"` runs ahead of every normal-order handler even
+        // when its plugin is `enforce: "post"`.
+        const ordered = records
+            .sort((left, right) => left.orderRank - right.orderRank || left.enforceRank - right.enforceRank || left.index - right.index)
+            .map(({ record }) => record);
+        if (ordered.length > 0)
+            entries.push([hook, Object.freeze(ordered)]);
+    }
+    const cacheEnvironment = yield* snapshotCacheEnvironment(raw.cacheEnvironment, plugins);
+    return Object.freeze({
+        plugins,
+        handlers: ImmutableMap.make(entries),
+        kinds: known,
+        parallelConcurrency,
+        ...(cacheEnvironment === undefined ? {} : { cacheEnvironment })
+    });
+});
+/**
+ * Merges every resolved plugin layer left-to-right and supplies the detached
+ * cache environment captured during resolution.
+ *
+ * @category combinators
+ * @since 1.0.0-rc.0
+ */
+export const layer = (resolved) => mergePluginLayers(resolved.plugins, resolved.cacheEnvironment);
+//# sourceMappingURL=Resolve.js.map

package/dist/esm/Resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Resolve.js","sourceRoot":"","sources":["../../src/Resolve.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Bounded plugin resolution: admit, filter, validate, order, and snapshot.\n *\n * The resulting catalog owns every record it exposes. Dispatch never reads a\n * caller-owned map, plugin record, hook object, config value, or cache identity.\n *\n * @since 1.0.0-rc.0\n */\n\nimport * as ImmutableMap from \"@smthrs/canonical/ReadonlyMap\"\nimport type { Action } from \"@smthrs/flow\"\nimport * as Effect from \"effect/Effect\"\nimport * as Layer from \"effect/Layer\"\nimport type { FlowsConfig } from \"./Config.ts\"\nimport * as Config from \"./Config.ts\"\nimport type { HookCatalog, HookKind, HookObject } from \"./Hooks.ts\"\nimport { engineHooks, handlerOf, orderOf } from \"./Hooks.ts\"\nimport type { FlowsHooks } from \"./index.ts\"\nimport * as Boundary from \"./internal/Boundary.ts\"\nimport { mergePluginLayers } from \"./internal/mergePluginLayers.ts\"\nimport { snapshotCacheEnvironment } from \"./internal/snapshotCacheEnvironment.ts\"\nimport type { Apply, FlowsPlugin, PluginInput } from \"./Plugin.ts\"\nimport { PluginError, type PluginErrorCode } from \"./PluginError.ts\"\n\n/**\n * Maximum nested preset-array depth accepted at startup.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumPluginDepth = 64\n\n/**\n * Maximum plugins accepted by one kernel.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumPlugins = 256\n\n/**\n * Maximum aggregate hook handlers accepted by one kernel.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumHandlers = 1_024\n\n/**\n * Maximum input nodes, including arrays and omitted entries.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumPluginInputNodes = 4_096\n\n/**\n * Maximum UTF-16 length of one plugin or hook name.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumPluginNameLength = 256\n\n/**\n * Default fiber bound for parallel observers.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const defaultParallelConcurrency = 16\n\n/**\n * Maximum configurable parallel-observer bound.\n *\n * @category limits\n * @since 1.0.0-rc.0\n */\nexport const maximumParallelConcurrency = 256\n\n/**\n * One resolved handler with immutable attribution.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport interface HandlerRecord {\n  readonly plugin: string\n  readonly hook: string\n  readonly handler: (...args: Array<any>) => unknown\n}\n\n/**\n * The immutable output of plugin resolution.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport interface Resolved<H = FlowsHooks> {\n  readonly plugins: ReadonlyArray<FlowsPlugin<H>>\n  readonly handlers: ReadonlyMap<string, ReadonlyArray<HandlerRecord>>\n  /** The frozen runtime catalog this resolution admitted. Dispatch refuses a method whose kind differs from it. */\n  readonly kinds: Readonly<Record<string, HookKind>>\n  readonly parallelConcurrency: number\n  readonly cacheEnvironment?: Action.CacheEnvironment | undefined\n}\n\n/**\n * Options for {@link resolve}.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport interface Options<H = FlowsHooks> {\n  /** Pre-resolution config tested by `apply` predicates. */\n  readonly config?: FlowsConfig | undefined\n  /** Host whose literal `apply` selectors are active. Defaults to `\"engine\"`. */\n  readonly target?: \"engine\" | \"harness\" | undefined\n  /**\n   * Hook names recognized by this host, each with the kind `H` declares for\n   * it. The shared `config` and `configResolved` hooks are fixed to\n   * `waterfall` and `parallel`; another kind fails with `hook_kind_mismatch`.\n   */\n  readonly hooks?: HookCatalog<H> | undefined\n  /** Complete composition identity for sealed activity keys. Requires every selected plugin to have a version. */\n  readonly cacheEnvironment?: Action.CacheEnvironment | undefined\n  /** Maximum observers run at once. Defaults to 16 and cannot exceed 256. */\n  readonly parallelConcurrency?: number | undefined\n}\n\ninterface RawOptions {\n  readonly config: unknown\n  readonly target: unknown\n  readonly hooks: unknown\n  readonly cacheEnvironment: unknown\n  readonly parallelConcurrency: unknown\n}\n\nconst failure = (\n  code: PluginErrorCode,\n  message: string,\n  path: string,\n  fields: { readonly plugin?: string; readonly hook?: string } = {}\n): PluginError => new PluginError({ code, message, path, ...fields })\n\nconst invalidPlugin = (\n  path: string,\n  complaint: string,\n  fields: { readonly plugin?: string; readonly hook?: string } = {}\n): PluginError => failure(\"invalid_plugin\", `plugin input ${complaint}`, path, fields)\n\n// Bound before quoting or scanning caller-controlled keys. Keep Boundary's\n// identifier/dot and JSON-quoted/bracket path convention.\nconst diagnosticKey = (key: string): string => key.length > 64 ? `${key.slice(0, 64)}...` : key\n\nconst childPath = (path: string, key: string): string => {\n  const bounded = diagnosticKey(key)\n  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(bounded) ? `${path}.${bounded}` : `${path}[${JSON.stringify(bounded)}]`\n}\n\nconst ownData = (\n  input: unknown,\n  path: string,\n  allowed?: ReadonlySet<string>\n): Readonly<Record<string, unknown>> => {\n  if (typeof input !== \"object\" || input === null || Array.isArray(input)) {\n    throw invalidPlugin(path, \"must be an ordinary record\")\n  }\n  const prototype = Object.getPrototypeOf(input)\n  if (prototype !== Object.prototype && prototype !== null) throw invalidPlugin(path, \"must be an ordinary record\")\n  const output: Record<string, unknown> = {}\n  for (const key of Reflect.ownKeys(input)) {\n    if (typeof key !== \"string\") throw invalidPlugin(path, \"must not contain symbol keys\")\n    if (allowed !== undefined && !allowed.has(key)) {\n      throw invalidPlugin(childPath(path, key), \"contains an unknown property\")\n    }\n    const descriptor = Object.getOwnPropertyDescriptor(input, key)\n    if (descriptor === undefined || !(\"value\" in descriptor) || !descriptor.enumerable) {\n      throw invalidPlugin(childPath(path, key), \"must be an enumerable data property\")\n    }\n    Object.defineProperty(output, key, { value: descriptor.value, enumerable: true })\n  }\n  return output\n}\n\nconst snapshotOptions = (input: unknown): RawOptions => {\n  const values = ownData(\n    input,\n    \"$options\",\n    new Set([\"config\", \"target\", \"hooks\", \"cacheEnvironment\", \"parallelConcurrency\"])\n  )\n  return {\n    config: values.config,\n    target: values.target,\n    hooks: values.hooks,\n    cacheEnvironment: values.cacheEnvironment,\n    parallelConcurrency: values.parallelConcurrency\n  }\n}\n\nconst validName = (value: unknown): value is string =>\n  typeof value === \"string\" && value.length > 0 && value.length <= maximumPluginNameLength &&\n  Boundary.isWellFormedText(value) && !/^\\s*$/u.test(value) && !/\\p{Cc}/u.test(value)\n\nconst snapshotCatalog = (input: unknown): Readonly<Record<string, HookKind>> => {\n  if (typeof input !== \"object\" || input === null || Array.isArray(input)) {\n    throw invalidPlugin(\"$options.hooks\", \"must be an ordinary hook catalog\")\n  }\n  const prototype = Object.getPrototypeOf(input)\n  if (prototype !== Object.prototype && prototype !== null) {\n    throw invalidPlugin(\"$options.hooks\", \"must be an ordinary hook catalog\")\n  }\n  const output: Record<string, HookKind> = {}\n  for (const key of Reflect.ownKeys(input)) {\n    if (typeof key !== \"string\" || !validName(key)) {\n      throw invalidPlugin(\"$options.hooks\", \"contains an invalid hook name\")\n    }\n    const descriptor = Object.getOwnPropertyDescriptor(input, key)\n    if (descriptor === undefined || !(\"value\" in descriptor) || !descriptor.enumerable) {\n      throw invalidPlugin(childPath(\"$options.hooks\", key), \"must be an enumerable data property\")\n    }\n    if (!([\"sequential\", \"parallel\", \"first\", \"waterfall\"] as ReadonlyArray<unknown>).includes(descriptor.value)) {\n      throw invalidPlugin(childPath(\"$options.hooks\", key), \"contains an invalid hook kind\")\n    }\n    Object.defineProperty(output, key, { value: descriptor.value, enumerable: true })\n  }\n  for (const hook of Object.keys(engineHooks) as ReadonlyArray<keyof typeof engineHooks>) {\n    if (Object.hasOwn(output, hook) && output[hook] !== engineHooks[hook]) {\n      throw failure(\n        \"hook_kind_mismatch\",\n        `hook catalog declares shared hook ${JSON.stringify(hook)} as ${\n          JSON.stringify(output[hook])\n        }, the kernel dispatches it as ${JSON.stringify(engineHooks[hook])}`,\n        childPath(\"$options.hooks\", hook),\n        { hook }\n      )\n    }\n  }\n  return Object.freeze(output)\n}\n\nconst snapshotHook = (\n  entry: unknown,\n  path: string,\n  plugin: string,\n  hook: string\n): ((...args: Array<any>) => unknown) | HookObject<(...args: Array<any>) => unknown> => {\n  if (typeof entry === \"function\") return entry as (...args: Array<any>) => unknown\n  if (entry === undefined) {\n    throw invalidPlugin(path, \"must be a function or a hook object\", { plugin, hook })\n  }\n  const values = ownData(entry, path, new Set([\"order\", \"handler\"]))\n  if (typeof values.handler !== \"function\") {\n    throw invalidPlugin(`${path}.handler`, \"must be a function\", { plugin, hook })\n  }\n  if (values.order !== undefined && values.order !== \"pre\" && values.order !== \"post\") {\n    throw invalidPlugin(`${path}.order`, \"must be pre or post\", { plugin, hook })\n  }\n  return Object.freeze({\n    ...(values.order === undefined ? {} : { order: values.order }),\n    handler: values.handler\n  }) as HookObject<(...args: Array<any>) => unknown>\n}\n\nconst snapshotPlugin = <H>(\n  input: unknown,\n  path: string\n): FlowsPlugin<H> => {\n  const values = ownData(input, path, new Set([\"name\", \"version\", \"enforce\", \"apply\", \"layer\", \"hooks\"]))\n  if (!validName(values.name)) throw invalidPlugin(`${path}.name`, \"requires a bounded non-empty name\")\n  const name = values.name\n  if (values.version !== undefined && !validName(values.version)) {\n    throw invalidPlugin(`${path}.version`, \"requires a bounded non-empty version\", { plugin: name })\n  }\n  if (values.enforce !== undefined && values.enforce !== \"pre\" && values.enforce !== \"post\") {\n    throw invalidPlugin(`${path}.enforce`, \"must be pre or post\", { plugin: name })\n  }\n  if (\n    values.apply !== undefined && values.apply !== \"engine\" && values.apply !== \"harness\" &&\n    typeof values.apply !== \"function\"\n  ) throw invalidPlugin(`${path}.apply`, \"must be engine, harness, or a predicate\", { plugin: name })\n  if (values.layer !== undefined && !Layer.isLayer(values.layer)) {\n    throw invalidPlugin(`${path}.layer`, \"must be an Effect Layer\", { plugin: name })\n  }\n\n  let hooks: Readonly<Record<string, unknown>> | undefined\n  if (values.hooks !== undefined) {\n    const rawHooks = ownData(values.hooks, `${path}.hooks`)\n    const snapshot: Record<string, unknown> = Object.create(null)\n    for (const [index, hook] of Object.keys(rawHooks).entries()) {\n      if (!validName(hook)) {\n        throw invalidPlugin(`${path}.hooks[${index}]`, \"contains an invalid hook name\")\n      }\n      const entry = rawHooks[hook]\n      Object.defineProperty(snapshot, hook, {\n        value: snapshotHook(entry, childPath(`${path}.hooks`, hook), name, hook),\n        enumerable: true\n      })\n    }\n    hooks = Object.freeze(snapshot)\n  }\n\n  return Object.freeze({\n    name,\n    ...(values.version === undefined ? {} : { version: values.version }),\n    ...(values.enforce === undefined ? {} : { enforce: values.enforce }),\n    ...(values.apply === undefined ? {} : { apply: values.apply as Apply }),\n    ...(values.layer === undefined ? {} : { layer: values.layer as Layer.Layer<never, any, any> }),\n    ...(hooks === undefined ? {} : { hooks: hooks as Partial<H> })\n  })\n}\n\ninterface AdmittedPlugin<H> {\n  readonly plugin: FlowsPlugin<H>\n  readonly path: string\n}\n\nconst flatten = <H>(input: unknown): ReadonlyArray<AdmittedPlugin<H>> => {\n  const output: Array<AdmittedPlugin<H>> = []\n  const arrays = new WeakSet<object>()\n  const stack: Array<{ readonly value: unknown; readonly path: string; readonly depth: number }> = [\n    { value: input, path: \"$\", depth: 0 }\n  ]\n  let nodes = 0\n  while (stack.length > 0) {\n    const current = stack.pop()!\n    nodes += 1\n    if (current.value === false || current.value === null || current.value === undefined) continue\n    if (Array.isArray(current.value)) {\n      if (current.depth >= maximumPluginDepth) {\n        throw failure(\"resource_limit\", `plugin input exceeds the depth limit of ${maximumPluginDepth}`, current.path)\n      }\n      if (arrays.has(current.value)) throw invalidPlugin(current.path, \"contains a cycle or repeated preset array\")\n      arrays.add(current.value)\n      const length = current.value.length\n      // Every queued frame and array element costs a node, including omitted\n      // entries. Refuse before enumerating keys, descriptors, or child frames.\n      if (length > maximumPluginInputNodes - nodes - stack.length) {\n        throw failure(\"resource_limit\", `plugin input exceeds the ${maximumPluginInputNodes}-node limit`, current.path)\n      }\n      const keys = Reflect.ownKeys(current.value)\n      if (keys.length !== length + 1 || !keys.includes(\"length\")) {\n        throw invalidPlugin(current.path, \"must be a dense preset array with no extra properties\")\n      }\n      for (let index = length - 1; index >= 0; index--) {\n        const descriptor = Object.getOwnPropertyDescriptor(current.value, String(index))\n        if (descriptor === undefined || !(\"value\" in descriptor) || !descriptor.enumerable) {\n          throw invalidPlugin(`${current.path}[${index}]`, \"must be an enumerable data property\")\n        }\n        stack.push({ value: descriptor.value, path: `${current.path}[${index}]`, depth: current.depth + 1 })\n      }\n      continue\n    }\n    output.push(Object.freeze({ plugin: snapshotPlugin<H>(current.value, current.path), path: current.path }))\n    if (output.length > maximumPlugins) {\n      throw failure(\"resource_limit\", `plugin input exceeds the ${maximumPlugins}-plugin limit`, current.path)\n    }\n  }\n  return output\n}\n\nconst included = <H>(\n  plugin: FlowsPlugin<H>,\n  config: FlowsConfig,\n  target: \"engine\" | \"harness\"\n): Effect.Effect<boolean, PluginError> => {\n  const apply = plugin.apply\n  if (apply === undefined) return Effect.succeed(true)\n  if (typeof apply !== \"function\") return Effect.succeed(apply === target)\n  return Effect.try({\n    try: () => apply(config),\n    catch: () =>\n      failure(\"apply_failed\", `plugin \"${plugin.name}\" apply predicate failed`, \"$.apply\", {\n        plugin: plugin.name\n      })\n  }).pipe(\n    Effect.flatMap((result) =>\n      typeof result === \"boolean\"\n        ? Effect.succeed(result)\n        : Effect.fail(invalidPlugin(\"$.apply\", \"predicate must return a boolean\", { plugin: plugin.name }))\n    )\n  )\n}\n\nconst rank = (enforce: \"pre\" | \"post\" | undefined): number => (enforce === \"pre\" ? 0 : enforce === \"post\" ? 2 : 1)\n\n/**\n * Resolves a plugin preset into an immutable, resource-bounded catalog.\n *\n * @category constructors\n * @since 1.0.0-rc.0\n */\nexport const resolve = <H = FlowsHooks>(\n  input: PluginInput<NoInfer<H>>,\n  options: Options<NoInfer<H>> = {},\n  configOverride?: FlowsConfig\n): Effect.Effect<Resolved<H>, PluginError> =>\n  Effect.gen(function*() {\n    const raw = yield* Effect.try({\n      try: () => snapshotOptions(options),\n      catch: (cause) =>\n        cause instanceof PluginError\n          ? cause\n          : invalidPlugin(\"$options\", \"could not be inspected without executing user code\")\n    })\n    if (configOverride !== undefined && raw.config !== undefined) {\n      return yield* Effect.fail(invalidPlugin(\n        \"$options.config\",\n        \"cannot declare config in options alongside the positional override\"\n      ))\n    }\n    if (raw.target !== undefined && raw.target !== \"engine\" && raw.target !== \"harness\") {\n      return yield* Effect.fail(invalidPlugin(\"$options.target\", \"must be engine or harness\"))\n    }\n    if (\n      raw.parallelConcurrency !== undefined &&\n      (typeof raw.parallelConcurrency !== \"number\" || !Number.isSafeInteger(raw.parallelConcurrency) ||\n        raw.parallelConcurrency <= 0 ||\n        raw.parallelConcurrency > maximumParallelConcurrency)\n    ) {\n      return yield* Effect.fail(failure(\n        \"resource_limit\",\n        `parallel concurrency must be between 1 and ${maximumParallelConcurrency}`,\n        \"$options.parallelConcurrency\"\n      ))\n    }\n    const parallelConcurrency = raw.parallelConcurrency === undefined\n      ? defaultParallelConcurrency\n      : raw.parallelConcurrency\n    const config = yield* Config.snapshot(configOverride ?? raw.config ?? {})\n    const known = yield* Effect.try({\n      try: () => snapshotCatalog(raw.hooks ?? engineHooks),\n      catch: (cause) =>\n        cause instanceof PluginError\n          ? cause\n          : invalidPlugin(\"$options.hooks\", \"could not be inspected without executing user code\")\n    })\n    const admitted = yield* Effect.try({\n      try: () => flatten<H>(input),\n      catch: (cause) =>\n        cause instanceof PluginError\n          ? cause\n          : invalidPlugin(\"$\", \"could not be inspected without executing user code\")\n    })\n    const target = raw.target ?? \"engine\"\n    const selected = yield* Effect.filter(admitted, ({ plugin }) => included(plugin, config, target))\n\n    let handlerCount = 0\n    for (const { path, plugin } of selected) {\n      const pluginHooks = plugin.hooks as Readonly<Record<string, unknown>> | undefined\n      if (pluginHooks === undefined) continue\n      for (const hook of Object.keys(pluginHooks)) {\n        if (!Object.hasOwn(known, hook)) {\n          return yield* Effect.fail(failure(\n            \"unknown_hook\",\n            `plugin ${JSON.stringify(plugin.name)} declares unknown hook ${JSON.stringify(diagnosticKey(hook))}`,\n            childPath(`${path}.hooks`, hook),\n            { plugin: plugin.name, hook }\n          ))\n        }\n        handlerCount += 1\n        if (handlerCount > maximumHandlers) {\n          return yield* Effect.fail(failure(\n            \"resource_limit\",\n            `plugin handlers exceed the limit of ${maximumHandlers}`,\n            childPath(`${path}.hooks`, hook)\n          ))\n        }\n      }\n    }\n\n    const seen = new Set<string>()\n    for (const { plugin } of selected) {\n      if (seen.has(plugin.name)) {\n        return yield* Effect.fail(failure(\n          \"duplicate_name\",\n          `duplicate plugin name \"${plugin.name}\"`,\n          \"$.name\",\n          { plugin: plugin.name }\n        ))\n      }\n      seen.add(plugin.name)\n    }\n\n    const plugins = Object.freeze(\n      selected\n        .map(({ plugin }, index) => ({ plugin, index }))\n        .sort((left, right) => rank(left.plugin.enforce) - rank(right.plugin.enforce) || left.index - right.index)\n        .map(({ plugin }) => plugin)\n    )\n    const entries: Array<readonly [string, ReadonlyArray<HandlerRecord>]> = []\n    for (const hook of Object.keys(known)) {\n      const records: Array<{\n        readonly record: HandlerRecord\n        readonly enforceRank: number\n        readonly orderRank: number\n        readonly index: number\n      }> = []\n      for (const [index, plugin] of plugins.entries()) {\n        const pluginHooks = plugin.hooks as Readonly<Record<string, unknown>> | undefined\n        if (pluginHooks === undefined || !Object.hasOwn(pluginHooks, hook)) continue\n        const entry = pluginHooks[hook]\n        const record = Object.freeze({ plugin: plugin.name, hook, handler: handlerOf(entry) })\n        records.push({ record, enforceRank: rank(plugin.enforce), orderRank: rank(orderOf(entry)), index })\n      }\n      // Vite's rule, verbatim: the per-hook `order` is the outer partition and\n      // the enforce-sorted plugin list supplies the stable order inside it, so a\n      // hook marked `order: \"pre\"` runs ahead of every normal-order handler even\n      // when its plugin is `enforce: \"post\"`.\n      const ordered = records\n        .sort((left, right) =>\n          left.orderRank - right.orderRank || left.enforceRank - right.enforceRank || left.index - right.index\n        )\n        .map(({ record }) => record)\n      if (ordered.length > 0) entries.push([hook, Object.freeze(ordered)])\n    }\n    const cacheEnvironment = yield* snapshotCacheEnvironment(raw.cacheEnvironment, plugins)\n    return Object.freeze({\n      plugins,\n      handlers: ImmutableMap.make(entries),\n      kinds: known,\n      parallelConcurrency,\n      ...(cacheEnvironment === undefined ? {} : { cacheEnvironment })\n    })\n  })\n\n/**\n * Merges every resolved plugin layer left-to-right and supplies the detached\n * cache environment captured during resolution.\n *\n * @category combinators\n * @since 1.0.0-rc.0\n */\nexport const layer = <H>(resolved: Resolved<H>): Layer.Layer<any, PluginError, any> =>\n  mergePluginLayers(resolved.plugins, resolved.cacheEnvironment)\n"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,83 @@
+/**
+ * The bounded cell-host plugin kernel: typed hooks, resolution and ordering,
+ * and the config pipeline.
+ *
+ * The public package contract is documented at
+ * {@link https://smithers.sh/docs/reference/api/plugin}, with the shipped host catalog in
+ * `packages/smithers/agent/src/CellPlugin.ts`. Durable
+ * engine extension remains dependency injection; this package does not expose
+ * an engine-wide lifecycle registry.
+ *
+ * @since 1.0.0-rc.0
+ */
+import type * as Effect from "effect/Effect";
+import type { FlowsConfig, ResolvedConfig } from "./Config.ts";
+import type { ParallelHook, WaterfallHook } from "./Hooks.ts";
+/**
+ * The shared kernel's base hook catalog.
+ *
+ * Declared here, in the package entry point, so that the documented
+ * augmentation specifier works: an interface can only be augmented in the
+ * module that declares it:
+ *
+ * ```ts
+ * declare module "@smthrs/plugin" {
+ *   interface FlowsHooks {
+ *     toolCall: SequentialHook<(ctx: ToolCallContext) => Effect.Effect<Option.Option<ToolOverride>>>
+ *   }
+ * }
+ * ```
+ *
+ * Closed for dispatch, open for augmentation: the kernel dispatches only the
+ * config lifecycle below; a host supplies and dispatches its own catalog over
+ * the same augmented interface.
+ *
+ * Both startup hooks are context-free: `Kernel.make` runs them before any
+ * plugin layer exists and supplies no services of its own, so a handler that
+ * needs a service provides it inside the hook. A host whose startup hooks do
+ * require services declares a separate hook interface, and `Kernel.make` then
+ * surfaces those requirements as `Kernel.StartupContext<H>`.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export interface FlowsHooks {
+    readonly config: WaterfallHook<(config: FlowsConfig) => Effect.Effect<Partial<FlowsConfig> | void, any, never>>;
+    readonly configResolved: ParallelHook<(config: ResolvedConfig) => Effect.Effect<void, any, never>>;
+}
+/**
+ * @since 1.0.0-rc.0
+ * @category config
+ */
+export * as Config from "./Config.ts";
+/**
+ * @since 1.0.0-rc.0
+ * @category hooks
+ */
+export * from "./Hooks.ts";
+/**
+ * @since 1.0.0-rc.0
+ * @category startup
+ */
+export * as Kernel from "./Kernel.ts";
+/**
+ * @since 1.0.0-rc.0
+ * @category models
+ */
+export * from "./Plugin.ts";
+/**
+ * @since 1.0.0-rc.0
+ * @category errors
+ */
+export * from "./PluginError.ts";
+/**
+ * @since 1.0.0-rc.0
+ * @category dispatch
+ */
+export * as Plugins from "./Plugins.ts";
+/**
+ * @since 1.0.0-rc.0
+ * @category resolution
+ */
+export * as Resolve from "./Resolve.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,MAAM,EAAE,WAAW,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAA;IAC/G,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC,MAAM,EAAE,cAAc,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAA;CACnG;AAED;;;GAGG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;GAGG;AACH,cAAc,YAAY,CAAA;AAE1B;;;GAGG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;GAGG;AACH,cAAc,aAAa,CAAA;AAE3B;;;GAGG;AACH,cAAc,kBAAkB,CAAA;AAEhC;;;GAGG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;;GAGG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA"}

package/dist/esm/index.js

@@ -0,0 +1,48 @@
+/**
+ * The bounded cell-host plugin kernel: typed hooks, resolution and ordering,
+ * and the config pipeline.
+ *
+ * The public package contract is documented at
+ * {@link https://smithers.sh/docs/reference/api/plugin}, with the shipped host catalog in
+ * `packages/smithers/agent/src/CellPlugin.ts`. Durable
+ * engine extension remains dependency injection; this package does not expose
+ * an engine-wide lifecycle registry.
+ *
+ * @since 1.0.0-rc.0
+ */
+/**
+ * @since 1.0.0-rc.0
+ * @category config
+ */
+export * as Config from "./Config.js";
+/**
+ * @since 1.0.0-rc.0
+ * @category hooks
+ */
+export * from "./Hooks.js";
+/**
+ * @since 1.0.0-rc.0
+ * @category startup
+ */
+export * as Kernel from "./Kernel.js";
+/**
+ * @since 1.0.0-rc.0
+ * @category models
+ */
+export * from "./Plugin.js";
+/**
+ * @since 1.0.0-rc.0
+ * @category errors
+ */
+export * from "./PluginError.js";
+/**
+ * @since 1.0.0-rc.0
+ * @category dispatch
+ */
+export * as Plugins from "./Plugins.js";
+/**
+ * @since 1.0.0-rc.0
+ * @category resolution
+ */
+export * as Resolve from "./Resolve.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAuCH;;;GAGG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;GAGG;AACH,cAAc,YAAY,CAAA;AAE1B;;;GAGG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;GAGG;AACH,cAAc,aAAa,CAAA;AAE3B;;;GAGG;AACH,cAAc,kBAAkB,CAAA;AAEhC;;;GAGG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;;GAGG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA","sourcesContent":["/**\n * The bounded cell-host plugin kernel: typed hooks, resolution and ordering,\n * and the config pipeline.\n *\n * The public package contract is documented at\n * {@link https://smithers.sh/docs/reference/api/plugin}, with the shipped host catalog in\n * `packages/smithers/agent/src/CellPlugin.ts`. Durable\n * engine extension remains dependency injection; this package does not expose\n * an engine-wide lifecycle registry.\n *\n * @since 1.0.0-rc.0\n */\n\nimport type * as Effect from \"effect/Effect\"\nimport type { FlowsConfig, ResolvedConfig } from \"./Config.ts\"\nimport type { ParallelHook, WaterfallHook } from \"./Hooks.ts\"\n\n/**\n * The shared kernel's base hook catalog.\n *\n * Declared here, in the package entry point, so that the documented\n * augmentation specifier works: an interface can only be augmented in the\n * module that declares it:\n *\n * ```ts\n * declare module \"@smthrs/plugin\" {\n *   interface FlowsHooks {\n *     toolCall: SequentialHook<(ctx: ToolCallContext) => Effect.Effect<Option.Option<ToolOverride>>>\n *   }\n * }\n * ```\n *\n * Closed for dispatch, open for augmentation: the kernel dispatches only the\n * config lifecycle below; a host supplies and dispatches its own catalog over\n * the same augmented interface.\n *\n * Both startup hooks are context-free: `Kernel.make` runs them before any\n * plugin layer exists and supplies no services of its own, so a handler that\n * needs a service provides it inside the hook. A host whose startup hooks do\n * require services declares a separate hook interface, and `Kernel.make` then\n * surfaces those requirements as `Kernel.StartupContext<H>`.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport interface FlowsHooks {\n  readonly config: WaterfallHook<(config: FlowsConfig) => Effect.Effect<Partial<FlowsConfig> | void, any, never>>\n  readonly configResolved: ParallelHook<(config: ResolvedConfig) => Effect.Effect<void, any, never>>\n}\n\n/**\n * @since 1.0.0-rc.0\n * @category config\n */\nexport * as Config from \"./Config.ts\"\n\n/**\n * @since 1.0.0-rc.0\n * @category hooks\n */\nexport * from \"./Hooks.ts\"\n\n/**\n * @since 1.0.0-rc.0\n * @category startup\n */\nexport * as Kernel from \"./Kernel.ts\"\n\n/**\n * @since 1.0.0-rc.0\n * @category models\n */\nexport * from \"./Plugin.ts\"\n\n/**\n * @since 1.0.0-rc.0\n * @category errors\n */\nexport * from \"./PluginError.ts\"\n\n/**\n * @since 1.0.0-rc.0\n * @category dispatch\n */\nexport * as Plugins from \"./Plugins.ts\"\n\n/**\n * @since 1.0.0-rc.0\n * @category resolution\n */\nexport * as Resolve from \"./Resolve.ts\"\n"]}