详细说明 resolve 的唯一答案语义、失败规则，以及它和普通 hook 的本质区别

Resolve

resolve 是最容易被误解的一种扩展点。

因为它写起来也像一个 handler，但它的语义不是“参与流程”，而是：

对某个问题给出最终答案

把它先和前三种分开

前三种更像：

pipeline：大家一起加工
guard：大家一起审查
effect：大家一起做副作用

而 resolve 更像：

这个问题，最终谁说了算

为什么必须只有一个 resolver

因为它面对的问题通常不是“多个人都来补一点”。

而是：

最终角色是什么
最终 provider 是哪个
最终路由目标是谁

这些问题都要求：

一个确定答案
一个最终权威

所以当前实现里，同一个 resolve 点重复注册会直接报错。

一个最小例子

const role = await agent.plugins.resolve<{ userId: string }, string>(
  "auth.resolve_role",
  { userId: "owner" },
);

plugin 可以这样定义：

resolves: {
  "auth.resolve_role": async ({ value }) => {
    const body = value as { userId?: unknown };
    const userId = String(body.userId || "").trim();
    if (!userId) {
      throw new Error("userId is required");
    }
    if (userId === "owner") return "admin" as never;
    return "member" as never;
  },
}