@smthrs/plugin 1.0.0-rc.7 → 1.0.0-rc.9

package/dist/esm/Plugins.js

@@ -26,9 +26,19 @@ const empty = Object.freeze([]);
 // The typed catalog and the runtime catalog can only drift when a host casts
 // around `KeysOfKind`; refuse before any handler runs rather than execute a
 // hook under semantics its declaration never promised.
-const kindMismatch = (resolved, hook, kind) => {
-    if (!Object.hasOwn(resolved.kinds, hook))
-        return undefined;
+// A hook the catalog does not declare dispatches as empty, unless a
+// hand-built resolution registered handlers for it: those have no declared
+// kind to honor, so they are refused too.
+const kindMismatch = (resolved, hook, kind, handlers) => {
+    if (!Object.hasOwn(resolved.kinds, hook)) {
+        if (handlers.length === 0)
+            return undefined;
+        return new PluginError({
+            code: "hook_kind_mismatch",
+            message: `hook "${hook}" has handlers but is not declared in the runtime catalog`,
+            hook
+        });
+    }
     const declared = resolved.kinds[hook];
     if (declared === kind)
         return undefined;
@@ -64,7 +74,7 @@ const runHandler = (record, args) => {
 export const make = (resolved) => {
     const handlers = (hook) => resolved.handlers.get(hook) ?? empty;
     const sequential = ((hook, ...args) => Effect.gen(function* () {
-        const mismatch = kindMismatch(resolved, hook, "sequential");
+        const mismatch = kindMismatch(resolved, hook, "sequential", handlers(hook));
         if (mismatch !== undefined)
             return yield* Effect.fail(mismatch);
         const results = [];
@@ -74,13 +84,13 @@ export const make = (resolved) => {
         return results;
     }));
     const parallel = ((hook, ...args) => {
-        const mismatch = kindMismatch(resolved, hook, "parallel");
+        const mismatch = kindMismatch(resolved, hook, "parallel", handlers(hook));
         if (mismatch !== undefined)
             return Effect.succeed([mismatch]);
         return Effect.forEach(handlers(hook), (record) => runHandler(record, args).pipe(Effect.match({ onFailure: (error) => [error], onSuccess: () => [] })), { concurrency: resolved.parallelConcurrency }).pipe(Effect.map((chunks) => chunks.flat()));
     });
     const first = ((hook, ...args) => Effect.gen(function* () {
-        const mismatch = kindMismatch(resolved, hook, "first");
+        const mismatch = kindMismatch(resolved, hook, "first", handlers(hook));
         if (mismatch !== undefined)
             return yield* Effect.fail(mismatch);
         for (const record of handlers(hook)) {
@@ -99,7 +109,7 @@ export const make = (resolved) => {
         return Option.none();
     }));
     const waterfall = ((hook, initial, merge) => Effect.gen(function* () {
-        const mismatch = kindMismatch(resolved, hook, "waterfall");
+        const mismatch = kindMismatch(resolved, hook, "waterfall", handlers(hook));
         if (mismatch !== undefined)
             return yield* Effect.fail(mismatch);
         let value = initial;
@@ -114,13 +124,15 @@ export const make = (resolved) => {
                             message: cause.message,
                             plugin: record.plugin,
                             hook: record.hook,
-                            path: cause.path
+                            path: cause.path,
+                            cause
                         })
                         : new PluginError({
                             code: "config_invalid",
                             message: `waterfall hook "${record.hook}" in plugin "${record.plugin}" returned an invalid patch`,
                             plugin: record.plugin,
-                            hook: record.hook
+                            hook: record.hook,
+                            cause
                         })
                 });
             }

package/dist/esm/Plugins.js.map

@@ -1 +1 @@
-{"version":3,"file":"Plugins.js","sourceRoot":"","sources":["../../src/Plugins.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The dispatcher: a plain service over a resolved plugin list, generic over the\n * hook interface.\n *\n * The public package contract is documented at\n * {@link https://smithers.sh/docs/reference/api/plugin}. Each host holds an instance over its\n * augmented `FlowsHooks` and may dispatch only the runtime catalog it supplied.\n * The shipped cell host owns the three\n * waterfalls declared in `packages/smithers/agent/src/CellPlugin.ts`; there is\n * no engine-wide lifecycle dispatcher.\n *\n * Cancellation is fiber interruption via scope closure; nothing here threads an\n * `AbortSignal`.\n *\n * @since 1.0.0-rc.0\n */\n\nimport * as ImmutableMap from \"@smthrs/canonical/ReadonlyMap\"\nimport type * as Cause from \"effect/Cause\"\nimport * as Context from \"effect/Context\"\nimport * as Effect from \"effect/Effect\"\nimport * as Layer from \"effect/Layer\"\nimport * as Option from \"effect/Option\"\nimport type { ArgsOf, ContextOf, HookKind, KeysOfKind, SuccessOf } from \"./Hooks.ts\"\nimport { engineHooks } from \"./Hooks.ts\"\nimport type { FlowsHooks } from \"./index.ts\"\nimport { PluginError } from \"./PluginError.ts\"\nimport { defaultParallelConcurrency, type HandlerRecord, type Resolved } from \"./Resolve.ts\"\n\nconst empty: ReadonlyArray<HandlerRecord> = Object.freeze([])\n\n// The typed catalog and the runtime catalog can only drift when a host casts\n// around `KeysOfKind`; refuse before any handler runs rather than execute a\n// hook under semantics its declaration never promised.\nconst kindMismatch = (resolved: Resolved<unknown>, hook: string, kind: HookKind): PluginError | undefined => {\n  if (!Object.hasOwn(resolved.kinds, hook)) return undefined\n  const declared = resolved.kinds[hook]\n  if (declared === kind) return undefined\n  return new PluginError({\n    code: \"hook_kind_mismatch\",\n    message: `hook \"${hook}\" is declared ${JSON.stringify(declared)} in the runtime catalog but was dispatched as ${\n      JSON.stringify(kind)\n    }`,\n    hook\n  })\n}\n\nconst runHandler = (\n  record: HandlerRecord,\n  args: ReadonlyArray<unknown>\n): Effect.Effect<unknown, PluginError, any> => {\n  const onCause = (cause: Cause.Cause<unknown>) =>\n    Effect.fail(\n      new PluginError({\n        code: \"hook_failed\",\n        message: `hook \"${record.hook}\" failed in plugin \"${record.plugin}\"`,\n        plugin: record.plugin,\n        hook: record.hook,\n        cause\n      })\n    )\n\n  return Effect.sync(() => record.handler(...args)).pipe(\n    Effect.catchCause(onCause),\n    Effect.flatMap((result) =>\n      Effect.isEffect(result)\n        ? result.pipe(Effect.catchCause(onCause))\n        : Effect.fail(\n          new PluginError({\n            code: \"hook_failed\",\n            message: `hook \"${record.hook}\" in plugin \"${record.plugin}\" returned a non-Effect (${typeof result})`,\n            plugin: record.plugin,\n            hook: record.hook\n          })\n        )\n    )\n  )\n}\n\n/**\n * The dispatch surface.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport interface Service<H = FlowsHooks> {\n  /** The resolved list this dispatcher walks. */\n  readonly resolved: Resolved<H>\n  /** Frozen, ordered handler records for a hook. */\n  readonly handlers: (hook: string) => ReadonlyArray<HandlerRecord>\n  /** Runs every handler in resolved order, one at a time. */\n  readonly sequential: <K extends KeysOfKind<H, \"sequential\">>(\n    hook: K,\n    ...args: ArgsOf<H[K]>\n  ) => Effect.Effect<ReadonlyArray<SuccessOf<H[K]>>, PluginError, ContextOf<H[K]>>\n  /**\n   * Runs every handler concurrently, ignoring results. Never fails: handler\n   * failures are returned so the caller can report them at its own boundary.\n   */\n  readonly parallel: <K extends KeysOfKind<H, \"parallel\">>(\n    hook: K,\n    ...args: ArgsOf<H[K]>\n  ) => Effect.Effect<ReadonlyArray<PluginError>, never, ContextOf<H[K]>>\n  /** Runs handlers in order until one returns `Option.some`. */\n  readonly first: <K extends KeysOfKind<H, \"first\">>(\n    hook: K,\n    ...args: ArgsOf<H[K]>\n  ) => Effect.Effect<SuccessOf<H[K]>, PluginError, ContextOf<H[K]>>\n  /** Threads a value through every handler, merging each returned patch. */\n  readonly waterfall: <K extends KeysOfKind<H, \"waterfall\">>(\n    hook: K,\n    initial: ArgsOf<H[K]>[0],\n    merge: (previous: ArgsOf<H[K]>[0], patch: Exclude<SuccessOf<H[K]>, void>) => ArgsOf<H[K]>[0]\n  ) => Effect.Effect<ArgsOf<H[K]>[0], PluginError, ContextOf<H[K]>>\n}\n\n/**\n * Builds a dispatcher over an already resolved plugin list.\n *\n * @category constructors\n * @since 1.0.0-rc.0\n */\nexport const make = <H = FlowsHooks>(resolved: Resolved<H>): Service<H> => {\n  const handlers = (hook: string): ReadonlyArray<HandlerRecord> => resolved.handlers.get(hook) ?? empty\n\n  const sequential = ((hook: string, ...args: Array<unknown>) =>\n    Effect.gen(function*() {\n      const mismatch = kindMismatch(resolved, hook, \"sequential\")\n      if (mismatch !== undefined) return yield* Effect.fail(mismatch)\n      const results: Array<unknown> = []\n      for (const record of handlers(hook)) {\n        results.push(yield* runHandler(record, args))\n      }\n      return results\n    })) as Service<H>[\"sequential\"]\n\n  const parallel = ((hook: string, ...args: Array<unknown>) => {\n    const mismatch = kindMismatch(resolved, hook, \"parallel\")\n    if (mismatch !== undefined) return Effect.succeed([mismatch])\n    return Effect.forEach(\n      handlers(hook),\n      (record) =>\n        runHandler(record, args).pipe(\n          Effect.match({ onFailure: (error) => [error], onSuccess: () => [] as Array<PluginError> })\n        ),\n      { concurrency: resolved.parallelConcurrency }\n    ).pipe(Effect.map((chunks) => chunks.flat()))\n  }) as Service<H>[\"parallel\"]\n\n  const first = ((hook: string, ...args: Array<unknown>) =>\n    Effect.gen(function*() {\n      const mismatch = kindMismatch(resolved, hook, \"first\")\n      if (mismatch !== undefined) return yield* Effect.fail(mismatch)\n      for (const record of handlers(hook)) {\n        const result = yield* runHandler(record, args)\n        if (!Option.isOption(result)) {\n          return yield* Effect.fail(\n            new PluginError({\n              code: \"invalid_hook_result\",\n              message: `first hook \"${record.hook}\" in plugin \"${record.plugin}\" did not return an Option`,\n              plugin: record.plugin,\n              hook: record.hook\n            })\n          )\n        }\n        if (Option.isSome(result)) return result\n      }\n      return Option.none()\n    })) as unknown as Service<H>[\"first\"]\n\n  const waterfall =\n    ((hook: string, initial: unknown, merge: (previous: unknown, patch: unknown) => unknown) =>\n      Effect.gen(function*() {\n        const mismatch = kindMismatch(resolved, hook, \"waterfall\")\n        if (mismatch !== undefined) return yield* Effect.fail(mismatch)\n        let value = initial\n        for (const record of handlers(hook)) {\n          const patch = yield* runHandler(record, [value])\n          if (patch !== undefined) {\n            value = yield* Effect.try({\n              try: () => merge(value, patch),\n              catch: (cause) =>\n                cause instanceof PluginError\n                  ? new PluginError({\n                    code: cause.code,\n                    message: cause.message,\n                    plugin: record.plugin,\n                    hook: record.hook,\n                    path: cause.path\n                  })\n                  : new PluginError({\n                    code: \"config_invalid\",\n                    message: `waterfall hook \"${record.hook}\" in plugin \"${record.plugin}\" returned an invalid patch`,\n                    plugin: record.plugin,\n                    hook: record.hook\n                  })\n            })\n          }\n        }\n        return value\n      })) as Service<H>[\"waterfall\"]\n\n  return Object.freeze({ resolved, handlers, sequential, parallel, first, waterfall })\n}\n\n/**\n * A dispatcher with no plugins at all.\n *\n * @category constructors\n * @since 1.0.0-rc.0\n */\nexport const makeNoop = <H = FlowsHooks>(): Service<H> =>\n  make<H>(Object.freeze({\n    plugins: Object.freeze([]),\n    handlers: ImmutableMap.make<string, ReadonlyArray<HandlerRecord>>(),\n    kinds: engineHooks,\n    parallelConcurrency: defaultParallelConcurrency\n  }))\n\n/**\n * The shared dispatcher, as a service tag.\n *\n * This tag holds one dispatcher over the process-wide augmented `FlowsHooks`.\n * `declare module \"@smthrs/plugin\"` augmentation is the supported extension\n * mechanism for values placed in the tag. A host typed against a separate hook\n * interface holds its `Service<H>` directly, as `@smthrs/agent` does, and does\n * not use this tag or its layers.\n *\n * @category context\n * @since 1.0.0-rc.0\n */\nexport class Plugins extends Context.Service<Plugins, Service>()(\"flows/plugin/Plugins\") {}\n\n/**\n * Layer providing a dispatcher over an already resolved plugin list.\n *\n * This layer targets the shared augmented `FlowsHooks` catalog only. A host\n * with a separate hook interface holds its `Service<H>` directly.\n *\n * @category layers\n * @since 1.0.0-rc.0\n */\nexport const layer = (resolved: Resolved): Layer.Layer<Plugins> => Layer.succeed(Plugins)(make(resolved))\n\n/**\n * Layer providing a dispatcher with no plugins.\n *\n * This layer targets the shared augmented `FlowsHooks` catalog only. A host\n * with a separate hook interface holds its `Service<H>` directly.\n *\n * @category layers\n * @since 1.0.0-rc.0\n */\nexport const layerNoop: Layer.Layer<Plugins> = Layer.succeed(Plugins)(makeNoop())\n"]}
+{"version":3,"file":"Plugins.js","sourceRoot":"","sources":["../../src/Plugins.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The dispatcher: a plain service over a resolved plugin list, generic over the\n * hook interface.\n *\n * The public package contract is documented at\n * {@link https://smithers.sh/docs/reference/api/plugin}. Each host holds an instance over its\n * augmented `FlowsHooks` and may dispatch only the runtime catalog it supplied.\n * The shipped cell host owns the three\n * waterfalls declared in `packages/smithers/agent/src/CellPlugin.ts`; there is\n * no engine-wide lifecycle dispatcher.\n *\n * Cancellation is fiber interruption via scope closure; nothing here threads an\n * `AbortSignal`.\n *\n * @since 1.0.0-rc.0\n */\n\nimport * as ImmutableMap from \"@smthrs/canonical/ReadonlyMap\"\nimport type * as Cause from \"effect/Cause\"\nimport * as Context from \"effect/Context\"\nimport * as Effect from \"effect/Effect\"\nimport * as Layer from \"effect/Layer\"\nimport * as Option from \"effect/Option\"\nimport type { ArgsOf, ContextOf, HookKind, KeysOfKind, SuccessOf } from \"./Hooks.ts\"\nimport { engineHooks } from \"./Hooks.ts\"\nimport type { FlowsHooks } from \"./index.ts\"\nimport { PluginError } from \"./PluginError.ts\"\nimport { defaultParallelConcurrency, type HandlerRecord, type Resolved } from \"./Resolve.ts\"\n\nconst empty: ReadonlyArray<HandlerRecord> = Object.freeze([])\n\n// The typed catalog and the runtime catalog can only drift when a host casts\n// around `KeysOfKind`; refuse before any handler runs rather than execute a\n// hook under semantics its declaration never promised.\n// A hook the catalog does not declare dispatches as empty, unless a\n// hand-built resolution registered handlers for it: those have no declared\n// kind to honor, so they are refused too.\nconst kindMismatch = (\n  resolved: Resolved<unknown>,\n  hook: string,\n  kind: HookKind,\n  handlers: ReadonlyArray<HandlerRecord>\n): PluginError | undefined => {\n  if (!Object.hasOwn(resolved.kinds, hook)) {\n    if (handlers.length === 0) return undefined\n    return new PluginError({\n      code: \"hook_kind_mismatch\",\n      message: `hook \"${hook}\" has handlers but is not declared in the runtime catalog`,\n      hook\n    })\n  }\n  const declared = resolved.kinds[hook]\n  if (declared === kind) return undefined\n  return new PluginError({\n    code: \"hook_kind_mismatch\",\n    message: `hook \"${hook}\" is declared ${JSON.stringify(declared)} in the runtime catalog but was dispatched as ${\n      JSON.stringify(kind)\n    }`,\n    hook\n  })\n}\n\nconst runHandler = (\n  record: HandlerRecord,\n  args: ReadonlyArray<unknown>\n): Effect.Effect<unknown, PluginError, any> => {\n  const onCause = (cause: Cause.Cause<unknown>) =>\n    Effect.fail(\n      new PluginError({\n        code: \"hook_failed\",\n        message: `hook \"${record.hook}\" failed in plugin \"${record.plugin}\"`,\n        plugin: record.plugin,\n        hook: record.hook,\n        cause\n      })\n    )\n\n  return Effect.sync(() => record.handler(...args)).pipe(\n    Effect.catchCause(onCause),\n    Effect.flatMap((result) =>\n      Effect.isEffect(result)\n        ? result.pipe(Effect.catchCause(onCause))\n        : Effect.fail(\n          new PluginError({\n            code: \"hook_failed\",\n            message: `hook \"${record.hook}\" in plugin \"${record.plugin}\" returned a non-Effect (${typeof result})`,\n            plugin: record.plugin,\n            hook: record.hook\n          })\n        )\n    )\n  )\n}\n\n/**\n * The dispatch surface.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport interface Service<H = FlowsHooks> {\n  /** The resolved list this dispatcher walks. */\n  readonly resolved: Resolved<H>\n  /** Frozen, ordered handler records for a hook. */\n  readonly handlers: (hook: string) => ReadonlyArray<HandlerRecord>\n  /** Runs every handler in resolved order, one at a time. */\n  readonly sequential: <K extends KeysOfKind<H, \"sequential\">>(\n    hook: K,\n    ...args: ArgsOf<H[K]>\n  ) => Effect.Effect<ReadonlyArray<SuccessOf<H[K]>>, PluginError, ContextOf<H[K]>>\n  /**\n   * Runs every handler concurrently, ignoring results. Never fails: handler\n   * failures are returned so the caller can report them at its own boundary.\n   */\n  readonly parallel: <K extends KeysOfKind<H, \"parallel\">>(\n    hook: K,\n    ...args: ArgsOf<H[K]>\n  ) => Effect.Effect<ReadonlyArray<PluginError>, never, ContextOf<H[K]>>\n  /** Runs handlers in order until one returns `Option.some`. */\n  readonly first: <K extends KeysOfKind<H, \"first\">>(\n    hook: K,\n    ...args: ArgsOf<H[K]>\n  ) => Effect.Effect<SuccessOf<H[K]>, PluginError, ContextOf<H[K]>>\n  /** Threads a value through every handler, merging each returned patch. */\n  readonly waterfall: <K extends KeysOfKind<H, \"waterfall\">>(\n    hook: K,\n    initial: ArgsOf<H[K]>[0],\n    merge: (previous: ArgsOf<H[K]>[0], patch: Exclude<SuccessOf<H[K]>, void>) => ArgsOf<H[K]>[0]\n  ) => Effect.Effect<ArgsOf<H[K]>[0], PluginError, ContextOf<H[K]>>\n}\n\n/**\n * Builds a dispatcher over an already resolved plugin list.\n *\n * @category constructors\n * @since 1.0.0-rc.0\n */\nexport const make = <H = FlowsHooks>(resolved: Resolved<H>): Service<H> => {\n  const handlers = (hook: string): ReadonlyArray<HandlerRecord> => resolved.handlers.get(hook) ?? empty\n\n  const sequential = ((hook: string, ...args: Array<unknown>) =>\n    Effect.gen(function*() {\n      const mismatch = kindMismatch(resolved, hook, \"sequential\", handlers(hook))\n      if (mismatch !== undefined) return yield* Effect.fail(mismatch)\n      const results: Array<unknown> = []\n      for (const record of handlers(hook)) {\n        results.push(yield* runHandler(record, args))\n      }\n      return results\n    })) as Service<H>[\"sequential\"]\n\n  const parallel = ((hook: string, ...args: Array<unknown>) => {\n    const mismatch = kindMismatch(resolved, hook, \"parallel\", handlers(hook))\n    if (mismatch !== undefined) return Effect.succeed([mismatch])\n    return Effect.forEach(\n      handlers(hook),\n      (record) =>\n        runHandler(record, args).pipe(\n          Effect.match({ onFailure: (error) => [error], onSuccess: () => [] as Array<PluginError> })\n        ),\n      { concurrency: resolved.parallelConcurrency }\n    ).pipe(Effect.map((chunks) => chunks.flat()))\n  }) as Service<H>[\"parallel\"]\n\n  const first = ((hook: string, ...args: Array<unknown>) =>\n    Effect.gen(function*() {\n      const mismatch = kindMismatch(resolved, hook, \"first\", handlers(hook))\n      if (mismatch !== undefined) return yield* Effect.fail(mismatch)\n      for (const record of handlers(hook)) {\n        const result = yield* runHandler(record, args)\n        if (!Option.isOption(result)) {\n          return yield* Effect.fail(\n            new PluginError({\n              code: \"invalid_hook_result\",\n              message: `first hook \"${record.hook}\" in plugin \"${record.plugin}\" did not return an Option`,\n              plugin: record.plugin,\n              hook: record.hook\n            })\n          )\n        }\n        if (Option.isSome(result)) return result\n      }\n      return Option.none()\n    })) as unknown as Service<H>[\"first\"]\n\n  const waterfall =\n    ((hook: string, initial: unknown, merge: (previous: unknown, patch: unknown) => unknown) =>\n      Effect.gen(function*() {\n        const mismatch = kindMismatch(resolved, hook, \"waterfall\", handlers(hook))\n        if (mismatch !== undefined) return yield* Effect.fail(mismatch)\n        let value = initial\n        for (const record of handlers(hook)) {\n          const patch = yield* runHandler(record, [value])\n          if (patch !== undefined) {\n            value = yield* Effect.try({\n              try: () => merge(value, patch),\n              catch: (cause) =>\n                cause instanceof PluginError\n                  ? new PluginError({\n                    code: cause.code,\n                    message: cause.message,\n                    plugin: record.plugin,\n                    hook: record.hook,\n                    path: cause.path,\n                    cause\n                  })\n                  : new PluginError({\n                    code: \"config_invalid\",\n                    message: `waterfall hook \"${record.hook}\" in plugin \"${record.plugin}\" returned an invalid patch`,\n                    plugin: record.plugin,\n                    hook: record.hook,\n                    cause\n                  })\n            })\n          }\n        }\n        return value\n      })) as Service<H>[\"waterfall\"]\n\n  return Object.freeze({ resolved, handlers, sequential, parallel, first, waterfall })\n}\n\n/**\n * A dispatcher with no plugins at all.\n *\n * @category constructors\n * @since 1.0.0-rc.0\n */\nexport const makeNoop = <H = FlowsHooks>(): Service<H> =>\n  make<H>(Object.freeze({\n    plugins: Object.freeze([]),\n    handlers: ImmutableMap.make<string, ReadonlyArray<HandlerRecord>>(),\n    kinds: engineHooks,\n    parallelConcurrency: defaultParallelConcurrency\n  }))\n\n/**\n * The shared dispatcher, as a service tag.\n *\n * This tag holds one dispatcher over the process-wide augmented `FlowsHooks`.\n * `declare module \"@smthrs/plugin\"` augmentation is the supported extension\n * mechanism for values placed in the tag. A host typed against a separate hook\n * interface holds its `Service<H>` directly, as `@smthrs/agent` does, and does\n * not use this tag or its layers.\n *\n * @category context\n * @since 1.0.0-rc.0\n */\nexport class Plugins extends Context.Service<Plugins, Service>()(\"flows/plugin/Plugins\") {}\n\n/**\n * Layer providing a dispatcher over an already resolved plugin list.\n *\n * This layer targets the shared augmented `FlowsHooks` catalog only. A host\n * with a separate hook interface holds its `Service<H>` directly.\n *\n * @category layers\n * @since 1.0.0-rc.0\n */\nexport const layer = (resolved: Resolved): Layer.Layer<Plugins> => Layer.succeed(Plugins)(make(resolved))\n\n/**\n * Layer providing a dispatcher with no plugins.\n *\n * This layer targets the shared augmented `FlowsHooks` catalog only. A host\n * with a separate hook interface holds its `Service<H>` directly.\n *\n * @category layers\n * @since 1.0.0-rc.0\n */\nexport const layerNoop: Layer.Layer<Plugins> = Layer.succeed(Plugins)(makeNoop())\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"Resolve.d.ts","sourceRoot":"","sources":["../../src/Resolve.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Resolve.d.ts","sourceRoot":"","sources":["../../src/Resolve.ts"],"names":[],"mappings":"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"}

package/dist/esm/Resolve.js

@@ -73,23 +73,24 @@ 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) => {
+const ownData = (input, path, allowed, fields = {}) => {
     if (typeof input !== "object" || input === null || Array.isArray(input)) {
-        throw invalidPlugin(path, "must be an ordinary record");
+        throw invalidPlugin(path, "must be an ordinary record", fields);
     }
     const prototype = Object.getPrototypeOf(input);
-    if (prototype !== Object.prototype && prototype !== null)
-        throw invalidPlugin(path, "must be an ordinary record");
+    if (prototype !== Object.prototype && prototype !== null) {
+        throw invalidPlugin(path, "must be an ordinary record", fields);
+    }
     const output = {};
     for (const key of Reflect.ownKeys(input)) {
         if (typeof key !== "string")
-            throw invalidPlugin(path, "must not contain symbol keys");
+            throw invalidPlugin(path, "must not contain symbol keys", fields);
         if (allowed !== undefined && !allowed.has(key)) {
-            throw invalidPlugin(childPath(path, key), "contains an unknown property");
+            throw invalidPlugin(childPath(path, key), "contains an unknown property", fields);
         }
         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");
+            throw invalidPlugin(childPath(path, key), "must be an enumerable data property", fields);
         }
         Object.defineProperty(output, key, { value: descriptor.value, enumerable: true });
     }
@@ -142,7 +143,7 @@ const snapshotHook = (entry, path, plugin, hook) => {
     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"]));
+    const values = ownData(entry, path, new Set(["order", "handler"]), { plugin, hook });
     if (typeof values.handler !== "function") {
         throw invalidPlugin(`${path}.handler`, "must be a function", { plugin, hook });
     }
@@ -173,11 +174,11 @@ const snapshotPlugin = (input, path) => {
     }
     let hooks;
     if (values.hooks !== undefined) {
-        const rawHooks = ownData(values.hooks, `${path}.hooks`);
+        const rawHooks = ownData(values.hooks, `${path}.hooks`, undefined, { plugin: name });
         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");
+                throw invalidPlugin(`${path}.hooks[${index}]`, "contains an invalid hook name", { plugin: name });
             }
             const entry = rawHooks[hook];
             Object.defineProperty(snapshot, hook, {
@@ -241,7 +242,7 @@ const flatten = (input) => {
     }
     return output;
 };
-const included = (plugin, config, target) => {
+const included = ({ path, plugin }, config, target) => {
     const apply = plugin.apply;
     if (apply === undefined)
         return Effect.succeed(true);
@@ -249,12 +250,12 @@ const included = (plugin, config, target) => {
         return Effect.succeed(apply === target);
     return Effect.try({
         try: () => apply(config),
-        catch: () => failure("apply_failed", `plugin "${plugin.name}" apply predicate failed`, "$.apply", {
+        catch: () => failure("apply_failed", `plugin "${plugin.name}" apply predicate failed`, `${path}.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 }))));
+        : Effect.fail(invalidPlugin(`${path}.apply`, "predicate must return a boolean", { plugin: plugin.name }))));
 };
 const rank = (enforce) => (enforce === "pre" ? 0 : enforce === "post" ? 2 : 1);
 /**
@@ -299,7 +300,7 @@ export const resolve = (input, options = {}, configOverride) => Effect.gen(funct
             : 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));
+    const selected = yield* Effect.filter(admitted, (entry) => included(entry, config, target));
     let handlerCount = 0;
     for (const { path, plugin } of selected) {
         const pluginHooks = plugin.hooks;
@@ -316,16 +317,17 @@ export const resolve = (input, options = {}, configOverride) => Effect.gen(funct
         }
     }
     const seen = new Set();
-    for (const { plugin } of selected) {
+    for (const { path, plugin } of selected) {
         if (seen.has(plugin.name)) {
-            return yield* Effect.fail(failure("duplicate_name", `duplicate plugin name "${plugin.name}"`, "$.name", { plugin: plugin.name }));
+            return yield* Effect.fail(failure("duplicate_name", `duplicate plugin name "${plugin.name}"`, `${path}.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 orderedEntries = selected
+        .map((entry, index) => ({ entry, index }))
+        .sort((left, right) => rank(left.entry.plugin.enforce) - rank(right.entry.plugin.enforce) || left.index - right.index)
+        .map(({ entry }) => entry);
+    const plugins = Object.freeze(orderedEntries.map(({ plugin }) => plugin));
     const entries = [];
     for (const hook of Object.keys(known)) {
         const records = [];
@@ -347,7 +349,7 @@ export const resolve = (input, options = {}, configOverride) => Effect.gen(funct
         if (ordered.length > 0)
             entries.push([hook, Object.freeze(ordered)]);
     }
-    const cacheEnvironment = yield* snapshotCacheEnvironment(raw.cacheEnvironment, plugins);
+    const cacheEnvironment = yield* snapshotCacheEnvironment(raw.cacheEnvironment, orderedEntries);
     return Object.freeze({
         plugins,
         handlers: ImmutableMap.make(entries),

package/dist/esm/Resolve.js.map

@@ -1 +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"]}
+{"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  fields: { readonly plugin?: string; readonly hook?: 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\", fields)\n  }\n  const prototype = Object.getPrototypeOf(input)\n  if (prototype !== Object.prototype && prototype !== null) {\n    throw invalidPlugin(path, \"must be an ordinary record\", fields)\n  }\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\", fields)\n    if (allowed !== undefined && !allowed.has(key)) {\n      throw invalidPlugin(childPath(path, key), \"contains an unknown property\", fields)\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\", fields)\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\"]), { plugin, hook })\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`, undefined, { plugin: name })\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\", { plugin: 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  { path, plugin }: AdmittedPlugin<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`, `${path}.apply`, {\n        plugin: plugin.name\n      })\n  }).pipe(\n    Effect.flatMap((result) =>\n      typeof result === \"boolean\"\n        ? Effect.succeed(result)\n        : Effect.fail(invalidPlugin(`${path}.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, (entry) => included(entry, 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 { path, 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          `${path}.name`,\n          { plugin: plugin.name }\n        ))\n      }\n      seen.add(plugin.name)\n    }\n\n    const orderedEntries = selected\n      .map((entry, index) => ({ entry, index }))\n      .sort((left, right) =>\n        rank(left.entry.plugin.enforce) - rank(right.entry.plugin.enforce) || left.index - right.index\n      )\n      .map(({ entry }) => entry)\n    const plugins = Object.freeze(orderedEntries.map(({ plugin }) => plugin))\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, orderedEntries)\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/internal/snapshotCacheEnvironment.d.ts

@@ -10,10 +10,14 @@ import type { FlowsPlugin } from "../Plugin.ts";
 import { PluginError } from "../PluginError.ts";
 /**
  * Admits a caller cache environment and prepends one escaped `name@version`
- * identity per plugin, in resolved order. An absent input stays absent.
+ * identity per plugin, in resolved order. An absent input stays absent. A
+ * versionless plugin is refused at the dollar-path it was admitted from.
  *
  * @private
  * @since 1.0.0-rc.0
  */
-export declare const snapshotCacheEnvironment: <H>(input: unknown, plugins: ReadonlyArray<FlowsPlugin<H>>) => Effect.Effect<Action.CacheEnvironment | undefined, PluginError>;
+export declare const snapshotCacheEnvironment: <H>(input: unknown, plugins: ReadonlyArray<{
+    readonly plugin: FlowsPlugin<H>;
+    readonly path: string;
+}>) => Effect.Effect<Action.CacheEnvironment | undefined, PluginError>;
 //# sourceMappingURL=snapshotCacheEnvironment.d.ts.map

package/dist/esm/internal/snapshotCacheEnvironment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshotCacheEnvironment.d.ts","sourceRoot":"","sources":["../../../src/internal/snapshotCacheEnvironment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAO/C;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,EACxC,OAAO,OAAO,EACd,SAAS,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,KACrC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,GAAG,SAAS,EAAE,WAAW,CAgDhE,CAAA"}
+{"version":3,"file":"snapshotCacheEnvironment.d.ts","sourceRoot":"","sources":["../../../src/internal/snapshotCacheEnvironment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAO/C;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,EACxC,OAAO,OAAO,EACd,SAAS,aAAa,CAAC;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,KACjF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,GAAG,SAAS,EAAE,WAAW,CAgDhE,CAAA"}

package/dist/esm/internal/snapshotCacheEnvironment.js

@@ -14,7 +14,8 @@ const escapePluginIdentityPart = (value) =>
 value.replaceAll("%", "%25").replaceAll("@", "%40");
 /**
  * Admits a caller cache environment and prepends one escaped `name@version`
- * identity per plugin, in resolved order. An absent input stays absent.
+ * identity per plugin, in resolved order. An absent input stays absent. A
+ * versionless plugin is refused at the dollar-path it was admitted from.
  *
  * @private
  * @since 1.0.0-rc.0
@@ -23,12 +24,12 @@ export const snapshotCacheEnvironment = (input, plugins) => {
     if (input === undefined)
         return Effect.succeed(undefined);
     const pluginIdentities = [];
-    for (const plugin of plugins) {
+    for (const { path, plugin } of plugins) {
         if (plugin.version === undefined) {
             return Effect.fail(new PluginError({
                 code: "cache_environment_invalid",
                 message: `cache environment requires a version for plugin "${plugin.name}"`,
-                path: "$.version",
+                path: `${path}.version`,
                 plugin: plugin.name
             }));
         }

package/dist/esm/internal/snapshotCacheEnvironment.js.map

@@ -1 +1 @@
-{"version":3,"file":"snapshotCacheEnvironment.js","sourceRoot":"","sources":["../../../src/internal/snapshotCacheEnvironment.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Cache identity admission for a resolved plugin list.\n *\n * @private\n * @since 1.0.0-rc.0\n */\n\nimport { Action } from \"@smthrs/flow\"\nimport * as Effect from \"effect/Effect\"\nimport * as Schema from \"effect/Schema\"\nimport type { FlowsPlugin } from \"../Plugin.ts\"\nimport { PluginError } from \"../PluginError.ts\"\nimport * as Boundary from \"./Boundary.ts\"\n\nconst escapePluginIdentityPart = (value: string): string =>\n  // Percent must be escaped first so literal escape-looking text remains distinct from the `@` escape added next.\n  value.replaceAll(\"%\", \"%25\").replaceAll(\"@\", \"%40\")\n\n/**\n * Admits a caller cache environment and prepends one escaped `name@version`\n * identity per plugin, in resolved order. An absent input stays absent.\n *\n * @private\n * @since 1.0.0-rc.0\n */\nexport const snapshotCacheEnvironment = <H>(\n  input: unknown,\n  plugins: ReadonlyArray<FlowsPlugin<H>>\n): Effect.Effect<Action.CacheEnvironment | undefined, PluginError> => {\n  if (input === undefined) return Effect.succeed(undefined)\n  const pluginIdentities: Array<string> = []\n  for (const plugin of plugins) {\n    if (plugin.version === undefined) {\n      return Effect.fail(\n        new PluginError({\n          code: \"cache_environment_invalid\",\n          message: `cache environment requires a version for plugin \"${plugin.name}\"`,\n          path: \"$.version\",\n          plugin: plugin.name\n        })\n      )\n    }\n    pluginIdentities.push(`${escapePluginIdentityPart(plugin.name)}@${escapePluginIdentityPart(plugin.version)}`)\n  }\n  const admitted = Boundary.record(input)\n  if (!admitted.ok) {\n    return Effect.fail(\n      new PluginError({\n        code: \"cache_environment_invalid\",\n        message: `cache environment ${admitted.complaint}`,\n        path: `$options.cacheEnvironment${admitted.path.slice(1)}`\n      })\n    )\n  }\n  return Schema.decodeUnknownEffect(Action.CacheEnvironment)(admitted.value).pipe(\n    Effect.mapError(() =>\n      new PluginError({\n        code: \"cache_environment_invalid\",\n        message: \"cache environment does not match the complete cache identity schema\",\n        path: \"$options.cacheEnvironment\"\n      })\n    ),\n    Effect.map((environment) => {\n      const capabilities: Record<string, ReadonlyArray<string>> = {}\n      for (const name of Object.keys(environment.capabilities)) {\n        Object.defineProperty(capabilities, name, {\n          value: Object.freeze([...environment.capabilities[name]!]),\n          enumerable: true\n        })\n      }\n      return Object.freeze({\n        layers: Object.freeze([...pluginIdentities, ...environment.layers]),\n        capabilities: Object.freeze(capabilities)\n      })\n    })\n  )\n}\n"]}
+{"version":3,"file":"snapshotCacheEnvironment.js","sourceRoot":"","sources":["../../../src/internal/snapshotCacheEnvironment.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Cache identity admission for a resolved plugin list.\n *\n * @private\n * @since 1.0.0-rc.0\n */\n\nimport { Action } from \"@smthrs/flow\"\nimport * as Effect from \"effect/Effect\"\nimport * as Schema from \"effect/Schema\"\nimport type { FlowsPlugin } from \"../Plugin.ts\"\nimport { PluginError } from \"../PluginError.ts\"\nimport * as Boundary from \"./Boundary.ts\"\n\nconst escapePluginIdentityPart = (value: string): string =>\n  // Percent must be escaped first so literal escape-looking text remains distinct from the `@` escape added next.\n  value.replaceAll(\"%\", \"%25\").replaceAll(\"@\", \"%40\")\n\n/**\n * Admits a caller cache environment and prepends one escaped `name@version`\n * identity per plugin, in resolved order. An absent input stays absent. A\n * versionless plugin is refused at the dollar-path it was admitted from.\n *\n * @private\n * @since 1.0.0-rc.0\n */\nexport const snapshotCacheEnvironment = <H>(\n  input: unknown,\n  plugins: ReadonlyArray<{ readonly plugin: FlowsPlugin<H>; readonly path: string }>\n): Effect.Effect<Action.CacheEnvironment | undefined, PluginError> => {\n  if (input === undefined) return Effect.succeed(undefined)\n  const pluginIdentities: Array<string> = []\n  for (const { path, plugin } of plugins) {\n    if (plugin.version === undefined) {\n      return Effect.fail(\n        new PluginError({\n          code: \"cache_environment_invalid\",\n          message: `cache environment requires a version for plugin \"${plugin.name}\"`,\n          path: `${path}.version`,\n          plugin: plugin.name\n        })\n      )\n    }\n    pluginIdentities.push(`${escapePluginIdentityPart(plugin.name)}@${escapePluginIdentityPart(plugin.version)}`)\n  }\n  const admitted = Boundary.record(input)\n  if (!admitted.ok) {\n    return Effect.fail(\n      new PluginError({\n        code: \"cache_environment_invalid\",\n        message: `cache environment ${admitted.complaint}`,\n        path: `$options.cacheEnvironment${admitted.path.slice(1)}`\n      })\n    )\n  }\n  return Schema.decodeUnknownEffect(Action.CacheEnvironment)(admitted.value).pipe(\n    Effect.mapError(() =>\n      new PluginError({\n        code: \"cache_environment_invalid\",\n        message: \"cache environment does not match the complete cache identity schema\",\n        path: \"$options.cacheEnvironment\"\n      })\n    ),\n    Effect.map((environment) => {\n      const capabilities: Record<string, ReadonlyArray<string>> = {}\n      for (const name of Object.keys(environment.capabilities)) {\n        Object.defineProperty(capabilities, name, {\n          value: Object.freeze([...environment.capabilities[name]!]),\n          enumerable: true\n        })\n      }\n      return Object.freeze({\n        layers: Object.freeze([...pluginIdentities, ...environment.layers]),\n        capabilities: Object.freeze(capabilities)\n      })\n    })\n  )\n}\n"]}

package/docs/README.md

@@ -51,7 +51,9 @@ class, no registration call, and no inheritance.
 
 ## Install
 
-Not on npm yet; see [Installation](https://github.com/smithersai/smithers/blob/main/packages/smithers/flows/flow/docs/installation.md#use-the-libraries).
+```bash
+npm install @smthrs/plugin@next effect
+```
 
 Node.js 26.4.0 or later is required. For the runtime requirements, the import
 forms, and the subpaths the export map blocks, see

package/docs/api.md

@@ -256,8 +256,10 @@ Every method first compares its kind with the runtime catalog the resolution
 admitted (`Resolved.kinds`). A hook the catalog declares with a different kind
 is refused before any handler runs: `sequential`, `first`, and `waterfall` fail
 with `hook_kind_mismatch`, and `parallel` returns that one error. A hook name
-absent from the catalog dispatches nothing. The typed signatures make the
-mismatch unreachable without a cast; the runtime check covers the cast.
+absent from the catalog dispatches nothing, unless a hand-built `Resolved`
+registered handlers under it; those are refused the same way, because no kind
+was declared for them. The typed signatures make the mismatch unreachable
+without a cast; the runtime check covers the cast.
 
 Handlers must return an Effect. Synchronous throws, Effect failures and defects,
 and non-Effect results (including `undefined`, scalars, and Promises) become
@@ -482,8 +484,8 @@ class PluginError extends Schema.TaggedError<PluginError>()("flows/plugin/Plugin
 
 Every startup and dispatch refusal uses this one error. `plugin` and `hook` are
 attribution, `path` is a diagnostic dollar-path into the refused value, and
-`cause` carries a failing handler's or layer's original failure. Match on
-`code`; the messages are prose.
+`cause` carries a failing handler's, layer's, or waterfall merge's original
+failure. Match on `code`; the messages are prose.
 
 `cause` is not redacted. It holds whatever the plugin failed or threw with,
 which can include credentials or config values. Keep it in process for

package/docs/guides/cache-identity.md

@@ -67,7 +67,7 @@ const refused = Kernel.make(
   {},
   { cacheEnvironment: { layers: [], capabilities: {} } }
 )
-// Fails with PluginError { code: "cache_environment_invalid", plugin: "flows-plugin-model-sonnet", path: "$.version" }
+// Fails with PluginError { code: "cache_environment_invalid", plugin: "flows-plugin-model-sonnet", path: "$[0].version" }
 ```
 
 A versionless plugin is refused rather than folded in as a bare name, because a