@adhd/apigen-engine-runtime 0.2.2 → 0.2.4

package/index.mjs

@@ -1,70 +1,69 @@
-import "ts-morph";
 import "node:fs";
+import { createRequire as he } from "node:module";
 import "node:path";
-import "ts-json-schema-generator";
 import N from "pino";
-import ge from "ajv";
-import we from "ajv-formats";
-const C = "$apigen";
-class W extends Error {
+import _e from "ajv";
+import ke from "ajv-formats";
+const M = "$apigen";
+let Z = class extends Error {
   constructor(t) {
     super(t), this.code = "E_DUP_CODEC", this.name = "CodecRegistryError";
   }
-}
-function be(e) {
+};
+function Ie(e) {
   const t = /* @__PURE__ */ new Map();
   return {
-    register(r, n) {
-      if (t.has(r.id) && !(n != null && n.override))
-        throw new W(
-          `E_DUP_CODEC: a codec is already registered for id "${r.id}"`
+    register(n, r) {
+      if (t.has(n.id) && !(r != null && r.override))
+        throw new Z(
+          `E_DUP_CODEC: a codec is already registered for id "${n.id}"`
         );
-      t.set(r.id, r);
+      t.set(n.id, n);
     },
-    resolve(r) {
-      for (const n of t.values())
-        if (n.matches(r))
-          return n;
+    resolve(n) {
+      for (const r of t.values())
+        if (r.matches(n))
+          return r;
     },
-    get(r) {
-      return t.get(r);
+    get(n) {
+      return t.get(n);
     },
     ids() {
       return [...t.keys()];
     },
     freeze() {
-      const r = new Map(t), n = {
+      const n = new Map(t), r = {
         register() {
-          throw new W(
+          throw new Z(
             "E_DUP_CODEC: registry is frozen and cannot accept new codecs"
           );
         },
         resolve(o) {
-          for (const i of r.values())
+          for (const i of n.values())
             if (i.matches(o))
               return i;
         },
         get(o) {
-          return r.get(o);
+          return n.get(o);
         },
         ids() {
-          return [...r.keys()];
+          return [...n.keys()];
         },
         freeze() {
-          return n;
+          return r;
         }
       };
-      return n;
+      return r;
     }
   };
 }
-const L = "x-apigen-logical", R = "x-apigen-codec", S = "x-apigen-ctor", x = "x-apigen-tojson", ve = "0.1.0";
-function G(e, t) {
+const F = "x-apigen-logical", V = "x-apigen-codec", T = "x-apigen-ctor", P = "x-apigen-tojson", Ce = "0.1.0";
+function Q(e, t) {
   return {
     registry: e,
-    resolve: (r) => {
+    resolve: (n) => {
       throw new Error(
-        `[apigen-logical] $ref "${r}" cannot be resolved in run-mode without a descriptor root. Supply a resolve() in the ctx override to handle $ref.`
+        `[apigen-logical] $ref "${n}" cannot be resolved in run-mode without a descriptor root. Supply a resolve() in the ctx override to handle $ref.`
       );
     },
     seen: /* @__PURE__ */ new WeakSet(),
@@ -73,66 +72,66 @@ function G(e, t) {
     ...t
   };
 }
-function v(e, t, r) {
-  const n = r.registry.resolve(t);
-  if (n)
-    return n.encode(e, t, r);
+function v(e, t, n) {
+  const r = n.registry.resolve(t);
+  if (r)
+    return r.encode(e, t, n);
   const o = t.$ref;
   if (typeof o == "string") {
-    const a = r.resolve(o);
-    return v(e, a, r);
+    const a = n.resolve(o);
+    return v(e, a, n);
   }
   const i = t.oneOf;
   if (Array.isArray(i)) {
-    const a = ue(e, i, t);
-    return v(e, a, r);
+    const a = ge(e, i, t, n);
+    return v(e, a, n);
   }
   const s = t.type;
   if (s === "array") {
     if (!Array.isArray(e))
-      return _(e, t, r);
+      return A(e, t, n);
     const a = t.items;
     if (!a)
-      return e.map((c) => w(c));
-    const f = r.path;
-    return Array.isArray(a) ? e.map((c, u) => {
-      const p = a[u];
-      return p === void 0 ? w(c) : v(c, p, { ...r, path: `${f}/${u}` });
+      return e.map((u) => w(u));
+    const f = n.path;
+    return Array.isArray(a) ? e.map((u, c) => {
+      const l = a[c];
+      return l === void 0 ? w(u) : v(u, l, { ...n, path: `${f}/${c}` });
     }) : e.map(
-      (c, u) => v(c, a, { ...r, path: `${f}/${u}` })
+      (u, c) => v(u, a, { ...n, path: `${f}/${c}` })
     );
   }
   if (s === "object") {
     if (e === null || typeof e != "object" || Array.isArray(e))
-      return _(e, t, r);
+      return A(e, t, n);
     const a = t.properties;
     if (!a)
       return w(e);
-    const f = r.path, c = {};
-    for (const [u, p] of Object.entries(a)) {
-      const d = e[u];
-      d !== void 0 && (c[u] = v(d, p, {
-        ...r,
-        path: `${f}/${u}`
+    const f = n.path, u = {};
+    for (const [c, l] of Object.entries(a)) {
+      const p = e[c];
+      p !== void 0 && (u[c] = v(p, l, {
+        ...n,
+        path: `${f}/${c}`
       }));
     }
-    return c;
+    return u;
   }
-  return s == null ? _(e, t, r) : w(e);
+  return s == null ? A(e, t, n) : w(e);
 }
-function $(e, t, r) {
-  const n = r.registry.resolve(t);
-  if (n)
-    return n.decode(e, t, r);
+function $(e, t, n) {
+  const r = n.registry.resolve(t);
+  if (r)
+    return r.decode(e, t, n);
   const o = t.$ref;
   if (typeof o == "string") {
-    const a = r.resolve(o);
-    return $(e, a, r);
+    const a = n.resolve(o);
+    return $(e, a, n);
   }
   const i = t.oneOf;
   if (Array.isArray(i)) {
-    const a = ue(e, i, t);
-    return $(e, a, r);
+    const a = ge(e, i, t, n);
+    return $(e, a, n);
   }
   const s = t.type;
   if (s === "array") {
@@ -141,12 +140,12 @@ function $(e, t, r) {
     const a = t.items;
     if (!a)
       return e;
-    const f = r.path;
-    return Array.isArray(a) ? e.map((c, u) => {
-      const p = a[u];
-      return p === void 0 ? c : $(c, p, { ...r, path: `${f}/${u}` });
+    const f = n.path;
+    return Array.isArray(a) ? e.map((u, c) => {
+      const l = a[c];
+      return l === void 0 ? u : $(u, l, { ...n, path: `${f}/${c}` });
     }) : e.map(
-      (c, u) => $(c, a, { ...r, path: `${f}/${u}` })
+      (u, c) => $(u, a, { ...n, path: `${f}/${c}` })
     );
   }
   if (s === "object") {
@@ -155,50 +154,176 @@ function $(e, t, r) {
     const a = t.properties;
     if (!a)
       return e;
-    const f = r.path, c = {};
-    for (const [u, p] of Object.entries(a)) {
-      const d = e[u];
-      d !== void 0 && (c[u] = $(d, p, {
-        ...r,
-        path: `${f}/${u}`
+    const f = n.path, u = {};
+    for (const [c, l] of Object.entries(a)) {
+      const p = e[c];
+      p !== void 0 && (u[c] = $(p, l, {
+        ...n,
+        path: `${f}/${c}`
       }));
     }
-    return c;
+    for (const [c, l] of Object.entries(e))
+      !(c in a) && l !== void 0 && (u[c] = l);
+    return u;
   }
-  return s == null ? $e(e, r) : e;
-}
-function ue(e, t, r, n) {
-  const o = r.discriminator;
-  if (o != null && o.propertyName) {
-    const i = e !== null && typeof e == "object" ? e[o.propertyName] : void 0;
-    if (typeof i == "string" && o.mapping) {
-      const s = o.mapping[i];
-      if (s) {
-        const a = t.find((f) => f.$ref === s);
-        if (a)
-          return a;
+  return s == null ? D(e, n) : e;
+}
+function ge(e, t, n, r) {
+  var o;
+  const i = n.discriminator;
+  if (i != null && i.propertyName) {
+    const u = i.propertyName, c = e !== null && typeof e == "object" ? e[u] : void 0;
+    if (typeof c == "string") {
+      if (i.mapping) {
+        const l = i.mapping[c];
+        if (l) {
+          const p = t.find((y) => y.$ref === l);
+          if (p)
+            return p;
+        }
+      }
+      for (const l of t) {
+        const p = (o = _(l, r).properties) == null ? void 0 : o[u];
+        if (!p)
+          continue;
+        const y = p.enum;
+        if (p.const === c || Array.isArray(y) && y.includes(c))
+          return l;
       }
     }
   }
-  return t[0] ?? {};
+  const s = xe(e, t, r);
+  if (s)
+    return s;
+  let a, f = -1;
+  for (const u of t) {
+    const c = _(u, r), l = we(e, c, r);
+    l !== null && l > f && (f = l, a = u);
+  }
+  return a !== void 0 ? a : t[0] ?? {};
+}
+function _(e, t) {
+  const n = e.$ref;
+  return typeof n == "string" ? t.resolve(n) : e;
+}
+function X(e) {
+  if ("const" in e)
+    return e.const;
+  const t = e.enum;
+  if (Array.isArray(t) && t.length === 1)
+    return t[0];
+}
+function xe(e, t, n) {
+  if (e === null || typeof e != "object" || Array.isArray(e))
+    return;
+  const r = e, o = t.map((s) => _(s, n)), i = /* @__PURE__ */ new Set();
+  for (const s of o) {
+    const a = s.properties;
+    if (a)
+      for (const [f, u] of Object.entries(a))
+        X(u) !== void 0 && i.add(f);
+  }
+  for (const s of i) {
+    const a = o.map((p) => {
+      const y = p.properties, d = y == null ? void 0 : y[s];
+      return d ? X(d) : void 0;
+    }), f = a.filter((p) => p !== void 0), u = new Set(f);
+    if (f.length < 2 || u.size !== f.length)
+      continue;
+    const c = r[s];
+    if (c === void 0)
+      continue;
+    const l = a.findIndex((p) => p === c);
+    if (l !== -1)
+      return t[l];
+  }
 }
-function _(e, t, r) {
-  for (const n of r.registry.ids()) {
-    const o = r.registry.get(n);
-    if (o)
-      try {
-        const i = o.encode(e, o.schema, r);
-        return { [C]: n, v: i };
-      } catch {
+function Se(e) {
+  if (e === null)
+    return "null";
+  if (Array.isArray(e))
+    return "array";
+  const t = typeof e;
+  return t === "number" ? Number.isInteger(e) ? "integer" : "number" : t;
+}
+function we(e, t, n) {
+  const r = t.oneOf;
+  if (Array.isArray(r)) {
+    let c = null;
+    for (const l of r) {
+      const p = we(e, _(l, n), n);
+      p !== null && (c === null || p > c) && (c = p);
+    }
+    return c;
+  }
+  const o = t.type, i = Se(e);
+  if (typeof o == "string") {
+    if (!(o === i || o === "number" && i === "integer"))
+      return null;
+  } else if (Array.isArray(o) && !o.some(
+    (c) => c === i || c === "number" && i === "integer"
+  ))
+    return null;
+  if (e === null || typeof e != "object" || Array.isArray(e))
+    return typeof o == "string" ? 1 : 0;
+  const s = e, a = t.required;
+  let f = 0;
+  if (Array.isArray(a)) {
+    for (const c of a)
+      if (typeof c == "string") {
+        if (s[c] === void 0)
+          return null;
+        f += 2;
       }
   }
+  const u = t.properties;
+  if (u) {
+    for (const c of Object.keys(u))
+      s[c] !== void 0 && (f += 1);
+    for (const c of Object.keys(s))
+      u[c] === void 0 && (f -= 1);
+  }
+  return f;
+}
+function A(e, t, n) {
+  var r;
+  for (const o of n.registry.ids()) {
+    const i = n.registry.get(o);
+    if ((r = i == null ? void 0 : i.ownsValue) != null && r.call(i, e))
+      return {
+        [M]: o,
+        v: i.encode(e, i.schema, n)
+      };
+  }
+  if (Array.isArray(e))
+    return e.map((o) => A(o, {}, n));
+  if (be(e)) {
+    const o = {};
+    for (const [i, s] of Object.entries(e))
+      s !== void 0 && (o[i] = A(s, {}, n));
+    return o;
+  }
   return w(e);
 }
-function $e(e, t) {
-  if (e !== null && typeof e == "object" && !Array.isArray(e) && C in e) {
-    const r = e, n = r[C], o = t.registry.get(n);
+function be(e) {
+  if (e === null || typeof e != "object" || Array.isArray(e))
+    return !1;
+  const t = Object.getPrototypeOf(e);
+  return t === Object.prototype || t === null;
+}
+function D(e, t) {
+  if (e !== null && typeof e == "object" && !Array.isArray(e) && M in e) {
+    const n = e, r = n[M], o = t.registry.get(r);
     if (o)
-      return o.decode(r.v, o.schema, t);
+      return o.decode(n.v, o.schema, t);
+  }
+  if (Array.isArray(e))
+    return e.map((n) => D(n, t));
+  if (be(e)) {
+    const n = {};
+    for (const [r, o] of Object.entries(e))
+      n[r] = D(o, t);
+    return n;
   }
   return e;
 }
@@ -209,63 +334,69 @@ function w(e) {
     return e.map(w);
   if (typeof e == "object") {
     const t = {};
-    for (const [r, n] of Object.entries(e))
-      n !== void 0 && (t[r] = w(n));
+    for (const [n, r] of Object.entries(e))
+      r !== void 0 && (t[n] = w(r));
     return t;
   }
   return null;
 }
-function je(e) {
+function Me(e) {
   return {
-    encode(t, r, n) {
-      const o = G(e, n);
-      return v(t, r, o);
+    encode(t, n, r) {
+      const o = Q(e, r);
+      return v(t, n, o);
     },
-    decode(t, r, n) {
-      const o = G(e, n);
-      return $(t, r, o);
+    decode(t, n, r) {
+      const o = Q(e, r);
+      return $(t, n, o);
     }
   };
 }
-const B = {
+const H = {
   id: "date-time",
   kind: "scalar",
   schema: { type: "string", format: "date-time" },
   matches(e) {
     return e.type === "string" && e.format === "date-time";
   },
-  encode(e, t, r) {
+  ownsValue(e) {
+    return e instanceof Date;
+  },
+  encode(e, t, n) {
     return e.toISOString();
   },
-  decode(e, t, r) {
+  decode(e, t, n) {
     if (typeof e != "string") {
-      if (r.mode === "strict")
+      if (n.mode === "strict")
         throw new TypeError(
-          `[date-time] expected a string on the wire at "${r.path}", got ${typeof e}`
+          `[date-time] expected a string on the wire at "${n.path}", got ${typeof e}`
         );
       return new Date(String(e));
     }
-    if (r.mode === "strict" && Number.isNaN(new Date(e).getTime()))
+    if (n.mode === "strict" && Number.isNaN(new Date(e).getTime()))
       throw new TypeError(
-        `[date-time] invalid date-time string at "${r.path}": ${JSON.stringify(e)}`
+        `[date-time] invalid date-time string at "${n.path}": ${JSON.stringify(e)}`
       );
     return new Date(e);
   }
-}, F = {
+}, K = {
   id: "int64",
   kind: "scalar",
   schema: { type: "string", format: "int64" },
   matches(e) {
     return e.type === "string" && e.format === "int64";
   },
-  encode(e, t, r) {
+  ownsValue(e) {
+    return typeof e == "bigint";
+  },
+  encode(e, t, n) {
     return String(e);
   },
-  decode(e, t, r) {
+  decode(e, t, n) {
     if (typeof e != "string") {
-      if (r.mode === "strict")
+      if (n.mode === "strict")
         throw new TypeError(
-          `[int64] expected a string on the wire at "${r.path}", got ${typeof e}`
+          `[int64] expected a string on the wire at "${n.path}", got ${typeof e}`
         );
       try {
         return BigInt(Math.trunc(Number(e)));
@@ -273,7 +404,7 @@ const B = {
         return BigInt(0);
       }
     }
-    if (r.mode === "strict")
+    if (n.mode === "strict")
       return BigInt(e);
     if (/^-?\d+$/.test(e))
       try {
@@ -283,176 +414,296 @@ const B = {
       }
     return BigInt(0);
   }
-}, K = {
+}, z = {
   id: "decimal",
   kind: "scalar",
   schema: { type: "string", format: "decimal" },
   matches(e) {
     return e.type === "string" && e.format === "decimal";
   },
-  encode(e, t, r) {
+  encode(e, t, n) {
     return e;
   },
-  decode(e, t, r) {
+  decode(e, t, n) {
     if (typeof e != "string") {
-      if (r.mode === "strict")
+      if (n.mode === "strict")
         throw new TypeError(
-          `[decimal] expected a string on the wire at "${r.path}", got ${typeof e}`
+          `[decimal] expected a string on the wire at "${n.path}", got ${typeof e}`
         );
       return String(e);
     }
-    if (r.mode === "strict" && !/^-?\d+(\.\d+)?$/.test(e))
+    if (n.mode === "strict" && !/^-?\d+(\.\d+)?$/.test(e))
       throw new TypeError(
-        `[decimal] wire value "${e}" at "${r.path}" is not a valid decimal string`
+        `[decimal] wire value "${e}" at "${n.path}" is not a valid decimal string`
       );
     return e;
   }
-}, H = {
+}, J = {
   id: "byte",
   kind: "scalar",
   schema: { type: "string", format: "byte" },
   matches(e) {
     return e.type === "string" && e.format === "byte";
   },
-  encode(e, t, r) {
+  ownsValue(e) {
+    return e instanceof Uint8Array;
+  },
+  encode(e, t, n) {
     return Buffer.from(e).toString("base64");
   },
-  decode(e, t, r) {
+  decode(e, t, n) {
     if (typeof e != "string") {
-      if (r.mode === "strict")
+      if (n.mode === "strict")
         throw new TypeError(
-          `[byte] expected a base64 string on the wire at "${r.path}", got ${typeof e}`
+          `[byte] expected a base64 string on the wire at "${n.path}", got ${typeof e}`
         );
       return new Uint8Array(0);
     }
-    if (r.mode === "strict" && !/^[A-Za-z0-9+/]*={0,2}$/.test(e))
+    if (n.mode === "strict" && !/^[A-Za-z0-9+/]*={0,2}$/.test(e))
       throw new TypeError(
-        `[byte] wire value at "${r.path}" is not standard base64 (format:byte): "${e}"`
+        `[byte] wire value at "${n.path}" is not standard base64 (format:byte): "${e}"`
       );
     return new Uint8Array(Buffer.from(e, "base64"));
   }
-}, Ne = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/, q = {
+}, Te = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/, W = {
   id: "uuid",
   kind: "scalar",
   schema: { type: "string", format: "uuid" },
   matches(e) {
     return e.type === "string" && e.format === "uuid";
   },
-  encode(e, t, r) {
+  encode(e, t, n) {
     return e.toLowerCase();
   },
-  decode(e, t, r) {
+  decode(e, t, n) {
     if (typeof e != "string") {
-      if (r.mode === "strict")
+      if (n.mode === "strict")
         throw new TypeError(
-          `[uuid] expected a string on the wire at "${r.path}", got ${typeof e}`
+          `[uuid] expected a string on the wire at "${n.path}", got ${typeof e}`
         );
       return String(e).toLowerCase();
     }
-    if (r.mode === "strict" && !Ne.test(e))
+    if (n.mode === "strict" && !Te.test(e))
       throw new TypeError(
-        `[uuid] wire value "${e}" at "${r.path}" is not a lowercase-hyphenated RFC 4122 UUID`
+        `[uuid] wire value "${e}" at "${n.path}" is not a lowercase-hyphenated RFC 4122 UUID`
       );
     return e;
   }
-}, M = "NaN", T = "Infinity", P = "-Infinity", Oe = /* @__PURE__ */ new Set([
-  M,
-  T,
-  P
-]), z = {
+}, U = "NaN", R = "Infinity", L = "-Infinity", Pe = /* @__PURE__ */ new Set([
+  U,
+  R,
+  L
+]), G = {
   id: "number-special",
   kind: "scalar",
   schema: { type: "number" },
   matches(e) {
     return e.type === "number" && e.format === void 0;
   },
-  encode(e, t, r) {
-    return Number.isNaN(e) ? M : e === 1 / 0 ? T : e === -1 / 0 ? P : e;
+  ownsValue(e) {
+    return typeof e == "number" && !Number.isFinite(e);
+  },
+  encode(e, t, n) {
+    return Number.isNaN(e) ? U : e === 1 / 0 ? R : e === -1 / 0 ? L : e;
   },
-  decode(e, t, r) {
+  decode(e, t, n) {
     if (typeof e == "number")
       return e;
     if (typeof e == "string") {
-      if (e === M)
+      if (e === U)
         return NaN;
-      if (e === T)
+      if (e === R)
         return 1 / 0;
-      if (e === P)
+      if (e === L)
         return -1 / 0;
-      const n = Number(e);
-      if (!Number.isNaN(n))
-        return n;
+      const r = Number(e);
+      if (!Number.isNaN(r))
+        return r;
     }
-    if (r.mode === "strict")
+    if (n.mode === "strict")
       throw new TypeError(
-        `[number-special] unrecognized wire value at "${r.path}": ${JSON.stringify(e)}. Expected a number or one of ${[...Oe].join(", ")}.`
+        `[number-special] unrecognized wire value at "${n.path}": ${JSON.stringify(e)}. Expected a number or one of ${[...Pe].join(", ")}.`
       );
     return NaN;
   }
-}, Ae = [
-  B,
-  F,
-  K,
+}, De = [
   H,
-  q,
-  z
+  K,
+  z,
+  J,
+  W,
+  G
 ];
-function _e(e, t = {}) {
-  for (const r of Ae)
-    e.register(r, { override: t.override ?? !1 });
-}
-B.id, // 'date-time'
-F.id, // 'int64'
-K.id, // 'decimal'
-H.id, // 'byte'
-q.id, // 'uuid'
-z.id;
-const fe = be();
-_e(fe);
-const pe = je(fe.freeze());
-function Ee(e, t) {
-  var n;
-  const r = ((n = e.input) == null ? void 0 : n.properties) ?? {};
-  return t in r;
-}
-function ke(e) {
-  var r, n;
-  const t = (n = (r = e.input) == null ? void 0 : r.properties) == null ? void 0 : n.data;
+function Ue(e, t = {}) {
+  for (const n of De)
+    e.register(n, { override: t.override ?? !1 });
+}
+const Re = 12;
+function Le(e, t) {
+  const n = /^#\/(definitions|\$defs)\/(.+)$/.exec(e);
+  if (!n)
+    return;
+  const [, r, o] = n, i = r === "$defs" ? t.$defs : t.definitions;
+  return i == null ? void 0 : i[decodeURIComponent(o)];
+}
+function ee(e) {
+  return Array.isArray(e) && e.length > 0 ? e[0] : void 0;
+}
+function Be(e) {
+  if (Array.isArray(e.type))
+    return e.type.find((t) => t !== "null") ?? e.type[0];
+  if (typeof e.type == "string")
+    return e.type;
+  if (e.properties)
+    return "object";
+}
+function qe(e) {
+  switch (e.format) {
+    case "date-time":
+      return "1970-01-01T00:00:00.000Z";
+    case "date":
+      return "1970-01-01";
+    case "time":
+      return "00:00:00Z";
+    case "uuid":
+      return "00000000-0000-0000-0000-000000000000";
+    case "email":
+      return "user@example.com";
+    case "uri":
+    case "url":
+    case "uri-reference":
+      return "https://example.com";
+    case "hostname":
+      return "example.com";
+    case "ipv4":
+      return "127.0.0.1";
+    case "ipv6":
+      return "::1";
+    case "decimal":
+      return "0";
+    case "int64":
+      return "0";
+    case "byte":
+      return "";
+    default:
+      return "<string>";
+  }
+}
+function te(e, t, n) {
+  const r = e.properties ?? {}, o = e.required ?? [], i = {};
+  for (const s of o) {
+    const a = r[s];
+    i[s] = a !== void 0 ? j(a, t, n + 1) : `<${s}>`;
+  }
+  return i;
+}
+function Fe(e, t, n) {
+  const r = Array.isArray(e.items) ? e.items[0] : e.items;
+  return r ? [j(r, t, n + 1)] : [];
+}
+function j(e, t = e ?? {}, n = 0) {
+  if (!e || n > Re)
+    return null;
+  if (typeof e.$ref == "string") {
+    const o = Le(e.$ref, t);
+    return o !== void 0 ? j(o, t, n + 1) : null;
+  }
+  if (e.const !== void 0)
+    return e.const;
+  if (Array.isArray(e.enum) && e.enum.length > 0)
+    return e.enum[0];
+  if (Array.isArray(e.allOf) && e.allOf.length > 0) {
+    const o = {}, i = [];
+    for (const s of e.allOf) {
+      Object.assign(o, s.properties ?? {});
+      for (const a of s.required ?? [])
+        i.includes(a) || i.push(a);
+    }
+    return te(
+      { ...e, properties: o, required: i },
+      t,
+      n
+    );
+  }
+  const r = ee(e.oneOf) ?? ee(e.anyOf);
+  if (r)
+    return j(r, t, n + 1);
+  switch (Be(e)) {
+    case "object":
+      return te(e, t, n);
+    case "array":
+      return Fe(e, t, n);
+    case "string":
+      return qe(e);
+    case "integer":
+    case "number":
+      return 0;
+    case "boolean":
+      return !1;
+    case "null":
+      return null;
+    default:
+      return null;
+  }
+}
+function ve(e) {
+  if (!e)
+    return;
+  const t = j(e);
+  return `Example: ${JSON.stringify(t)}`;
+}
+H.id, // 'date-time'
+K.id, // 'int64'
+z.id, // 'decimal'
+J.id, // 'byte'
+W.id, // 'uuid'
+G.id;
+const $e = Ie();
+Ue($e);
+const Ae = Me($e.freeze());
+function Ve(e, t) {
+  var r;
+  const n = ((r = e.input) == null ? void 0 : r.properties) ?? {};
+  return t in n;
+}
+function He(e) {
+  var n, r;
+  const t = (r = (n = e.input) == null ? void 0 : n.properties) == null ? void 0 : r.data;
   return Object.keys((t == null ? void 0 : t.properties) ?? {});
 }
-function Ie(e, t) {
+function Ke(e, t) {
   var o, i, s;
-  const r = (s = (i = (o = e.input) == null ? void 0 : o.properties) == null ? void 0 : i.data) == null ? void 0 : s.properties, n = r == null ? void 0 : r[t];
-  return n !== void 0 ? n : void 0;
+  const n = (s = (i = (o = e.input) == null ? void 0 : o.properties) == null ? void 0 : i.data) == null ? void 0 : s.properties, r = n == null ? void 0 : n[t];
+  return r !== void 0 ? r : void 0;
 }
-function Ce(e, t) {
-  return t === void 0 || e === void 0 ? e : pe.decode(e, t);
+function ze(e, t) {
+  return t === void 0 || e === void 0 ? e : Ae.decode(e, t);
 }
-function E(e, t) {
-  const r = t.output;
-  return !r || Object.keys(r).length === 0 ? e : pe.encode(e, r);
+function C(e, t) {
+  const n = t.output;
+  return !n || Object.keys(n).length === 0 ? e : Ae.encode(e, n);
 }
-async function Se(e, t, r, n, o, i) {
-  const a = ke(r).map(
-    (c) => Ce(i[c], Ie(r, c))
+async function Je(e, t, n, r, o, i) {
+  const a = He(n).map(
+    (u) => ze(i[u], Ke(n, u))
   );
-  if (Ee(r, "session") && t) {
-    const c = await t({ session: o.session }), u = await e[n](c, ...a);
-    return E(u, r);
+  if (Ve(n, "session") && t) {
+    const u = await t({ session: o.session }), c = await e[r](u, ...a);
+    return C(c, n);
   }
-  if (r.hasCtx) {
-    const c = t ? await t(o) : void 0, u = await e[n](c, ...a);
-    return E(u, r);
+  if (n.hasCtx) {
+    const u = t ? await t(o) : void 0, c = await e[r](u, ...a);
+    return C(c, n);
   }
-  const f = await e[n](...a);
-  return E(f, r);
+  const f = await e[r](...a);
+  return C(f, n);
 }
-class xe {
+class We {
   constructor() {
     this._map = /* @__PURE__ */ new Map();
   }
-  set(t, r) {
-    this._map.set(t, r);
+  set(t, n) {
+    this._map.set(t, n);
   }
   get(t) {
     return this._map.get(t);
@@ -462,31 +713,31 @@ class xe {
     return this._map.has(t);
   }
 }
-function Me(e = []) {
-  return async function(r, n, o) {
-    const i = o.schemas[r];
+function Ge(e = []) {
+  return async function(n, r, o) {
+    const i = o.schemas[n];
     if (!i)
       throw new Error(
-        `apigen/invoke: no schema found for operation "${r}"`
+        `apigen/invoke: no schema found for operation "${n}"`
       );
-    const s = () => Se(
+    const s = () => Je(
       o.fns,
       o.createClient,
       i,
-      r,
-      n.envelope,
-      n.domainArgs
+      n,
+      r.envelope,
+      r.domainArgs
     );
     return e.reduceRight(
-      (f, c) => () => c(n, f),
+      (f, u) => () => u(r, f),
       s
     )();
   };
 }
-function Kt(e) {
+function ln(e) {
   return e;
 }
-class Te {
+class Ye {
   constructor() {
     this.handlers = /* @__PURE__ */ new Map();
   }
@@ -495,16 +746,16 @@ class Te {
    * per-request/per-package MUST be removed (via the returned fn, {@link off},
    * or {@link clear}) or they accumulate for the bus's lifetime.
    */
-  on(t, r) {
-    const n = this.handlers.get(t) ?? [];
-    return this.handlers.set(t, [...n, r]), () => this.off(t, r);
+  on(t, n) {
+    const r = this.handlers.get(t) ?? [];
+    return this.handlers.set(t, [...r, n]), () => this.off(t, n);
   }
   /** Remove a previously registered handler (no-op if absent). */
-  off(t, r) {
-    const n = this.handlers.get(t);
-    if (!n)
+  off(t, n) {
+    const r = this.handlers.get(t);
+    if (!r)
       return;
-    const o = n.filter((i) => i !== r);
+    const o = r.filter((i) => i !== n);
     o.length === 0 ? this.handlers.delete(t) : this.handlers.set(t, o);
   }
   /** Remove every handler — call on package/server teardown. */
@@ -512,115 +763,116 @@ class Te {
     this.handlers.clear();
   }
   async emit(t) {
-    for (const [r, n] of this.handlers)
-      if (Pe(r, t))
-        for (const o of n)
+    for (const [n, r] of this.handlers)
+      if (Ze(n, t))
+        for (const o of r)
           await o(t);
   }
 }
-function Pe(e, t) {
-  const [r, n, o] = e.split(":");
-  return !(r !== "*" && r !== t.module || n && n !== "*" && n !== t.method || o && o !== "*" && o !== t.lifecycle);
+function Ze(e, t) {
+  const [n, r, o] = e.split(":");
+  return !(n !== "*" && n !== t.module || r && r !== "*" && r !== t.method || o && o !== "*" && o !== t.lifecycle);
 }
-function De(e, t) {
-  for (const r of e)
-    if (r.eventMapping)
-      for (const [n, o] of Object.entries(r.eventMapping))
-        t.on(n, o);
+function Qe(e, t) {
+  for (const n of e)
+    if (n.eventMapping)
+      for (const [r, o] of Object.entries(n.eventMapping))
+        t.on(r, o);
 }
-async function Ue(e, t, r) {
-  let n = { ...t };
+async function Xe(e, t, n) {
+  let r = { ...t };
   for (const o of e)
     if (o.createContext) {
-      await r.emit({
+      await n.emit({
         module: o.id,
         method: "createContext",
         lifecycle: "start",
-        ctx: n
+        ctx: r
       });
       try {
-        const i = await o.createContext(n);
-        n = { ...n, ...i }, await r.emit({
+        const i = await o.createContext(r);
+        r = { ...r, ...i }, await n.emit({
           module: o.id,
           method: "createContext",
           lifecycle: "complete",
-          ctx: n
+          ctx: r
         });
       } catch (i) {
-        throw await r.emit({
+        throw await n.emit({
           module: o.id,
           method: "createContext",
           lifecycle: "error",
-          ctx: n,
+          ctx: r,
           error: i
         }), i;
       }
     }
-  return n;
+  return r;
 }
-function J(e, t) {
-  const r = /* @__PURE__ */ new Set(), n = [e];
-  for (; n.length > 0; ) {
-    const o = n.pop();
-    if (!o || r.has(o))
+he(import.meta.url);
+function ne(e, t) {
+  const n = /* @__PURE__ */ new Set(), r = [e];
+  for (; r.length > 0; ) {
+    const o = r.pop();
+    if (!o || n.has(o))
       continue;
-    r.add(o);
+    n.add(o);
     const i = o.$ref;
     if (typeof i == "string") {
       if (t) {
-        const p = t[i];
-        if (!p) {
-          const d = Object.keys(t).join(", ") || "(none)";
+        const l = t[i];
+        if (!l) {
+          const p = Object.keys(t).join(", ") || "(none)";
           throw new Error(
-            `[apigen-logical] $ref "${i}" cannot be resolved. Available $defs: ${d}`
+            `[apigen-logical] $ref "${i}" cannot be resolved. Available $defs: ${p}`
           );
         }
-        n.push(p);
+        r.push(l);
       }
       continue;
     }
     const s = o.oneOf;
     if (Array.isArray(s))
-      for (const p of s)
-        typeof p == "object" && p !== null && n.push(p);
+      for (const l of s)
+        typeof l == "object" && l !== null && r.push(l);
     const a = o.properties;
     if (a)
-      for (const p of Object.values(a))
-        n.push(p);
+      for (const l of Object.values(a))
+        r.push(l);
     const f = o.items;
     if (Array.isArray(f))
-      for (const p of f)
-        typeof p == "object" && p !== null && n.push(p);
+      for (const l of f)
+        typeof l == "object" && l !== null && r.push(l);
     else
-      typeof f == "object" && f !== null && n.push(f);
-    const c = o.additionalProperties;
-    typeof c == "object" && c !== null && n.push(c);
-    const u = o.propertyNames;
-    typeof u == "object" && u !== null && n.push(u);
+      typeof f == "object" && f !== null && r.push(f);
+    const u = o.additionalProperties;
+    typeof u == "object" && u !== null && r.push(u);
+    const c = o.propertyNames;
+    typeof c == "object" && c !== null && r.push(c);
   }
 }
-const Y = /* @__PURE__ */ new Set(["string", "number", "boolean", "integer"]);
-function Le(e) {
+const re = /* @__PURE__ */ new Set(["string", "number", "boolean", "integer"]);
+function et(e) {
   if (typeof e != "object" || e === null)
     return !1;
   const t = e;
   if (t.$ref !== void 0 || t.oneOf || t.anyOf || t.allOf)
     return !1;
-  const { type: r } = t;
-  return typeof r == "string" ? Y.has(r) : Array.isArray(r) ? r.every((n) => Y.has(n) || n === "null") : Array.isArray(t.enum) && t.enum.length > 0 ? t.enum.every((n) => ["string", "number", "boolean"].includes(typeof n)) : !1;
+  const { type: n } = t;
+  return typeof n == "string" ? re.has(n) : Array.isArray(n) ? n.every((r) => re.has(r) || r === "null") : Array.isArray(t.enum) && t.enum.length > 0 ? t.enum.every((r) => ["string", "number", "boolean"].includes(typeof r)) : !1;
 }
-function Re(e) {
+function tt(e) {
   if (!e || typeof e != "object")
     return !1;
   const t = e.properties;
   return t === void 0 || typeof t != "object" || t === null ? !1 : Object.values(t).every(
-    Le
+    et
   );
 }
-function Be(e) {
-  const t = {}, r = (n) => {
+function nt(e) {
+  const t = {}, n = (r) => {
     for (const o of ["definitions", "$defs"]) {
-      const i = n[o];
+      const i = r[o];
       if (i)
         for (const [s, a] of Object.entries(i)) {
           const f = s.startsWith("#/") ? s : `#/${o}/${s}`;
@@ -628,80 +880,80 @@ function Be(e) {
         }
     }
   };
-  for (const n of Object.values(e.schemas))
-    r(n.input), r(n.output);
+  for (const r of Object.values(e.schemas))
+    n(r.input), n(r.output);
   if (Object.keys(t).length !== 0)
-    for (const [n, o] of Object.entries(e.schemas))
+    for (const [r, o] of Object.entries(e.schemas))
       try {
-        J(o.input, t), J(o.output, t);
+        ne(o.input, t), ne(o.output, t);
       } catch (i) {
         throw new Error(
-          `[apigen-core-client] Schema validation failed for function "${n}": ${i.message}`
+          `[apigen-core-client] Schema validation failed for function "${r}": ${i.message}`
         );
       }
 }
-function Fe(e, t) {
-  const r = [
+function rt(e, t) {
+  const n = [
     'apigen calling convention: all domain parameters go inside a "data" envelope — e.g. { "data": { ... } }' + (t ? "." : " (an empty object for this zero-parameter tool).")
   ];
-  return e.length > 0 && r.push(
-    `Field(s) ${e.map((n) => `"${n}"`).join(", ")} are transport-level envelope metadata, NOT domain data — do not nest them under "data". Over MCP they are read from arguments._meta["x-<pluginId>-<field>"] (default pluginId "adhd"); see @adhd/apigen-engine-naming's envelopeMetaKey/envelopeCliFlag/envelopeEnvVar for the HTTP-header / CLI-flag / env-var equivalents.`
-  ), r.join(" ");
+  return e.length > 0 && n.push(
+    `Field(s) ${e.map((r) => `"${r}"`).join(", ")} are transport-level envelope metadata, NOT domain data — do not nest them under "data". Over MCP they are read from arguments._meta["x-<pluginId>-<field>"] (default pluginId "adhd"); see @adhd/apigen-engine-naming's envelopeMetaKey/envelopeCliFlag/envelopeEnvVar for the HTTP-header / CLI-flag / env-var equivalents.`
+  ), n.join(" ");
 }
-function Ke(e, t, r) {
-  Be(e);
-  const n = {};
+function ot(e, t, n) {
+  nt(e);
+  const r = {};
   for (const [o, i] of Object.entries(e.schemas)) {
-    const s = (r == null ? void 0 : r[o]) ?? {}, a = i.input.properties ?? {}, f = i.input.required ?? [], c = {}, u = [], p = {};
+    const s = (n == null ? void 0 : n[o]) ?? {}, a = i.input.properties ?? {}, f = i.input.required ?? [], u = {}, c = [], l = {};
     for (const h of t)
       if (h.envelope && s[h.id] !== !1)
-        for (const [b, he] of Object.entries(h.envelope))
-          c[b] = he, p[b] = h.id, u.includes(b) || u.push(b);
-    const d = {
+        for (const [b, Ee] of Object.entries(h.envelope))
+          u[b] = Ee, l[b] = h.id, c.includes(b) || c.push(b);
+    const p = {
       type: "object",
       properties: a,
       additionalProperties: !1,
       ...f.length > 0 ? { required: f } : {}
-    }, m = i.safe === !0 || Re(i.input), l = i.input.definitions, y = i.input.$defs;
-    n[o] = {
+    }, y = i.safe === !0 || tt(i.input), d = i.input.definitions, m = i.input.$defs;
+    r[o] = {
       input: {
         type: "object",
-        properties: { ...c, data: d },
+        properties: { ...u, data: p },
         required: [
-          ...u,
+          ...c,
           ...f.length > 0 ? ["data"] : []
         ],
         // BUG-APIGEN-017: reject any property that isn't a declared envelope
         // field or the "data" wrapper — no silently-ignored junk params.
         additionalProperties: !1,
         // BUG-APIGEN-020: document the envelope/data calling convention inline.
-        description: Fe(
-          Object.keys(c),
+        description: rt(
+          Object.keys(u),
           Object.keys(a).length > 0
         ),
-        ...l ? { definitions: l } : {},
-        ...y ? { $defs: y } : {}
+        ...d ? { definitions: d } : {},
+        ...m ? { $defs: m } : {}
       },
       output: i.output,
       // Carry the ctx-param flag through to dispatch (BUG-APIGEN-001).
       ...i.hasCtx ? { hasCtx: !0 } : {},
-      "x-apigen-safe": m,
+      "x-apigen-safe": y,
       // DEBT-APIGEN-ENVELOPE-CAPABILITY-UNWIRED-001: field → pluginId map,
       // read by `op-plan.ts`'s `computeEnvelopeFields`. Omitted (not an empty
       // object) when no middleware contributed an envelope field, matching
       // `x-apigen-safe`'s own "absent means nothing to report" convention.
-      ...Object.keys(p).length > 0 ? { "x-apigen-envelope": p } : {}
+      ...Object.keys(l).length > 0 ? { "x-apigen-envelope": l } : {}
     };
   }
-  return n;
+  return r;
 }
-const He = {
+const it = {
   "decimal.js": "Decimal"
 };
-function qe(e) {
+function st(e) {
   return e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-Object.entries(He).map(([e, t]) => ({
+Object.entries(it).map(([e, t]) => ({
   // Matches: import("...{modSpec}...").<anyMemberName>  (single or double quotes)
   // The module specifier appears inside an absolute path, so we allow any
   // characters between the quote and the specifier, and between the specifier
@@ -709,127 +961,155 @@ Object.entries(He).map(([e, t]) => ({
   // …) is matched generically (`\w+`) rather than anchored to one spelling —
   // see the doc comment above for why.
   pattern: new RegExp(
-    `import\\(["'][^"']*${qe(e)}[^"']*["']\\)\\.\\w+`,
+    `import\\(["'][^"']*${st(e)}[^"']*["']\\)\\.\\w+`,
     "g"
   ),
   key: t
 }));
-class D extends Error {
+class B extends Error {
   constructor(t) {
     super(t), this.name = "ConfigurationError";
   }
 }
-function ze(e) {
+function at(e) {
   for (const t of e)
-    for (const r of Object.keys(t.eventMapping ?? {})) {
-      const [n] = r.split(":");
-      if (n !== "*" && n === t.id)
-        throw new D(
-          `Middleware "${t.id}" subscribes to its own events via "${r}". This would cause infinite recursion.`
+    for (const n of Object.keys(t.eventMapping ?? {})) {
+      const [r] = n.split(":");
+      if (r !== "*" && r === t.id)
+        throw new B(
+          `Middleware "${t.id}" subscribes to its own events via "${n}". This would cause infinite recursion.`
         );
     }
 }
-function Ht(e) {
+function pn(e) {
   const {
     domainSchemas: t,
-    middlewares: r,
-    overrides: n = {},
+    middlewares: n,
+    overrides: r = {},
     strict: o = !1
   } = e;
-  ze(r);
-  for (const c of Object.keys(n))
-    if (!(c in t.schemas)) {
-      const u = `Override key "${c}" not found in domain schemas.`;
+  at(n);
+  for (const u of Object.keys(r))
+    if (!(u in t.schemas)) {
+      const c = `Override key "${u}" not found in domain schemas.`;
       if (o)
-        throw new D(u);
-      console.warn("[apigen-runtime]", u);
+        throw new B(c);
+      console.warn("[apigen-runtime]", c);
     }
-  const i = new Set(r.map((c) => c.id));
-  for (const [c, u] of Object.entries(n))
-    for (const p of Object.keys(u ?? {}))
-      if (!i.has(p)) {
-        const d = `Override key "${c}.${p}" does not match any declared middleware id.`;
+  const i = new Set(n.map((u) => u.id));
+  for (const [u, c] of Object.entries(r))
+    for (const l of Object.keys(c ?? {}))
+      if (!i.has(l)) {
+        const p = `Override key "${u}.${l}" does not match any declared middleware id.`;
         if (o)
-          throw new D(d);
-        console.warn("[apigen-runtime]", d);
+          throw new B(p);
+        console.warn("[apigen-runtime]", p);
       }
-  const s = Ke(
+  const s = ot(
     t,
-    r,
-    n
-  ), a = new Te();
-  return De(r, a), { schemas: s, createClient: async (c) => Ue(r, c, a), dispose: () => a.clear() };
+    n,
+    r
+  ), a = new Ye();
+  return Qe(n, a), { schemas: s, createClient: async (u) => Xe(n, u, a), dispose: () => a.clear() };
 }
-function qt(e = {}) {
-  const t = e.level ?? "info", r = typeof e.destination == "string" && e.destination.length > 0, n = !r && !!process.stderr.isTTY, o = e.format ?? (n ? "pretty" : "json"), i = { level: t };
+function dn(e = {}) {
+  const t = e.level ?? "info", n = typeof e.destination == "string" && e.destination.length > 0, r = !n && !!process.stderr.isTTY, o = e.format ?? (r ? "pretty" : "json"), i = { level: t };
   if (o === "pretty")
     return i.transport = {
       target: "pino-pretty",
       options: {
-        colorize: !r,
+        colorize: !n,
         translateTime: "SYS:HH:MM:ss.l",
         ignore: "pid,hostname",
-        ...r ? { destination: e.destination, mkdir: !0 } : { destination: 2 }
+        ...n ? { destination: e.destination, mkdir: !0 } : { destination: 2 }
       }
     }, N(i);
-  const s = r ? N.destination({ dest: e.destination, mkdir: !0, sync: !0 }) : N.destination(2);
+  const s = n ? N.destination({ dest: e.destination, mkdir: !0, sync: !0 }) : N.destination(2);
   return N(i, s);
 }
-function le(e) {
-  return e ? e.type === "array" ? `${le(e.items)}[]` : e.enum ? "enum" : e.$ref ? String(e.$ref).split("/").pop() || "object" : e.anyOf || e.oneOf ? "union" : e.type ?? "object" : "unknown";
+function ct(e) {
+  if (!e || e.type !== "object" || !e.properties)
+    return;
+  const t = Object.entries(e.properties);
+  if (t.length === 0)
+    return;
+  const n = new Set(e.required ?? []);
+  return `{ ${t.map(([o, i]) => `${o}${n.has(o) ? "" : "?"}: ${k(i)}`).join(", ")} }`;
+}
+function ut(e) {
+  return typeof e == "string" ? `'${e}'` : JSON.stringify(e);
+}
+function ft(e) {
+  const t = e.enum ?? [];
+  return t.length === 0 ? "unknown" : t.map(ut).join("|");
 }
-function Ve(e) {
+function lt(e, t) {
+  return e.map((n) => k(n, t)).join(" | ");
+}
+function k(e, t = 0) {
+  if (!e)
+    return "unknown";
+  if (e.type === "array")
+    return `${k(e.items, 0)}[]`;
+  if (e.enum)
+    return ft(e);
+  if (e.$ref)
+    return String(e.$ref).split("/").pop() || "object";
+  const n = e.anyOf ?? e.oneOf;
+  return n ? n.length === 0 ? "unknown" : t >= 2 ? lt(n, t - 1) : "union" : t >= 1 && e.type === "object" ? ct(e) ?? "object" : e.type ?? "object";
+}
+function pt(e) {
   var a;
-  const r = (a = ((e == null ? void 0 : e.input) ?? {}).properties) == null ? void 0 : a.data, n = (r == null ? void 0 : r.properties) ?? {}, o = new Set((r == null ? void 0 : r.required) ?? []), i = Object.entries(n).map(([f, c]) => ({
+  const n = (a = ((e == null ? void 0 : e.input) ?? {}).properties) == null ? void 0 : a.data, r = (n == null ? void 0 : n.properties) ?? {}, o = new Set((n == null ? void 0 : n.required) ?? []), i = Object.entries(r).map(([f, u]) => ({
     name: f,
-    type: le(c),
+    type: k(u, 2),
     required: o.has(f)
   })), s = i.map((f) => `${f.name}${f.required ? "" : "?"}: ${f.type}`).join(", ");
   return { params: i, text: s };
 }
-function We(e) {
+function dt(e) {
   let t;
-  return Array.isArray(e) ? t = e : e ? t = [e] : t = [], t.find((r) => r === "number" || r === "integer" || r === "boolean");
+  return Array.isArray(e) ? t = e : e ? t = [e] : t = [], t.find((n) => n === "number" || n === "integer" || n === "boolean");
 }
-function zt(e, t) {
+function yn(e, t) {
   var i, s;
-  const n = ((s = (i = ((t == null ? void 0 : t.input) ?? {}).properties) == null ? void 0 : i.data) == null ? void 0 : s.properties) ?? {}, o = { ...e };
-  for (const [a, f] of Object.entries(n)) {
-    const c = o[a];
-    if (typeof c != "string")
+  const r = ((s = (i = ((t == null ? void 0 : t.input) ?? {}).properties) == null ? void 0 : i.data) == null ? void 0 : s.properties) ?? {}, o = { ...e };
+  for (const [a, f] of Object.entries(r)) {
+    const u = o[a];
+    if (typeof u != "string")
       continue;
-    const u = We(f == null ? void 0 : f.type);
-    if (u === "number" || u === "integer") {
-      const p = Number(c);
-      !Number.isNaN(p) && c.trim() !== "" && (o[a] = p);
+    const c = dt(f == null ? void 0 : f.type);
+    if (c === "number" || c === "integer") {
+      const l = Number(u);
+      !Number.isNaN(l) && u.trim() !== "" && (o[a] = l);
     } else
-      u === "boolean" && (c === "true" ? o[a] = !0 : c === "false" && (o[a] = !1));
+      c === "boolean" && (u === "true" ? o[a] = !0 : u === "false" && (o[a] = !1));
   }
   return o;
 }
-const X = /* @__PURE__ */ new Set(["default", "module.exports", "__esModule"]);
-function Vt(e) {
-  const t = {}, r = (n, o) => {
-    for (const [i, s] of Object.entries(n))
+const oe = /* @__PURE__ */ new Set(["default", "module.exports", "__esModule"]);
+function mn(e) {
+  const t = {}, n = (r, o) => {
+    for (const [i, s] of Object.entries(r))
       if (typeof s == "function") {
-        !X.has(i) && !(i in t) && (t[i] = s);
+        !oe.has(i) && !(i in t) && (t[i] = s);
         const a = s.name;
         a && !(a in t) && (t[a] = s);
       } else
-        s && typeof s == "object" && o < 2 && X.has(i) && r(s, o + 1);
+        s && typeof s == "object" && o < 2 && oe.has(i) && n(s, o + 1);
   };
-  return r(e, 0), t;
+  return n(e, 0), t;
 }
-const Ge = [
+const yt = [
   "invalid_argument",
   "unauthenticated",
   "permission_denied",
   "not_found",
   "internal"
 ];
-class A extends Error {
-  constructor(t, r, n) {
-    super(r), this.name = "ApiError", this.code = t, this.details = n, Object.setPrototypeOf(this, new.target.prototype);
+class I extends Error {
+  constructor(t, n, r) {
+    super(n), this.name = "ApiError", this.code = t, this.details = r, Object.setPrototypeOf(this, new.target.prototype);
   }
   /** Serialise to a plain object suitable for JSON transport. */
   toJSON() {
@@ -840,81 +1120,85 @@ class A extends Error {
     return this.details !== void 0 && (t.details = this.details), t;
   }
 }
-function de(e) {
-  return typeof e == "object" && e !== null && e.name === "ApiError" && Ge.includes(e.code) && typeof e.toJSON == "function";
+function je(e) {
+  return typeof e == "object" && e !== null && e.name === "ApiError" && yt.includes(e.code) && typeof e.toJSON == "function";
 }
-function Q(e, t, r = 0) {
-  return e === "before-first-chunk" ? { phase: e, error: t } : { phase: e, error: t, chunksDelivered: r };
+function ie(e, t, n = 0) {
+  return e === "before-first-chunk" ? { phase: e, error: t } : { phase: e, error: t, chunksDelivered: n };
 }
-const j = new ge({ allErrors: !0 });
-we(j);
+const O = new _e({ allErrors: !0 });
+ke(O);
 for (const e of [
-  L,
-  R,
-  S,
-  x,
+  F,
+  V,
+  T,
+  P,
   "discriminator"
 ])
-  j.addKeyword({ keyword: e, valid: !0 });
-j.addFormat("decimal", /^[+-]?(?:\d+(?:\.\d+)?|\.\d+)$/);
-function ye(e) {
+  O.addKeyword({ keyword: e, valid: !0 });
+O.addFormat("decimal", /^[+-]?(?:\d+(?:\.\d+)?|\.\d+)$/);
+function mt(e) {
   return e.map(
     (t) => `${t.instancePath || "(root)"} ${t.message ?? "failed schema check"}`
   ).join("; ");
 }
-const Wt = async (e, t) => {
-  const r = e.ctx.get(Je);
-  if (r === void 0)
+function Oe(e, t) {
+  const n = ve(t), r = [`Validation failed: ${mt(e)}`];
+  return n && r.push(n), r.join(" — ");
+}
+const hn = async (e, t) => {
+  const n = e.ctx.get(ht);
+  if (n === void 0)
     return t();
-  const n = e.operation.id, o = r[n];
+  const r = e.operation.id, o = n[r];
   if (o === void 0)
     return t();
   const i = {
     data: e.domainArgs,
     ...e.envelope
-  }, s = j.compile(o.input);
+  }, s = O.compile(o.input);
   if (!s(i)) {
     const f = s.errors ?? [];
-    throw new A(
+    throw new I(
       "invalid_argument",
-      `Validation failed: ${ye(f)}`,
+      Oe(f, o.input),
       f
     );
   }
   return t();
-}, Je = Symbol("ValidateSchemasToken");
-function Ye(e) {
-  return async function(r, n) {
-    const o = r.operation.id, i = e[o];
+}, ht = Symbol("ValidateSchemasToken");
+function gt(e) {
+  return async function(n, r) {
+    const o = n.operation.id, i = e[o];
     if (i === void 0)
-      return n();
+      return r();
     const s = {
-      data: r.domainArgs,
-      ...r.envelope
-    }, a = j.compile(i.input);
+      data: n.domainArgs,
+      ...n.envelope
+    }, a = O.compile(i.input);
     if (!a(s)) {
-      const c = a.errors ?? [];
-      throw new A(
+      const u = a.errors ?? [];
+      throw new I(
         "invalid_argument",
-        `Validation failed: ${ye(c)}`,
-        c
+        Oe(u, i.input),
+        u
       );
     }
-    return n();
+    return r();
   };
 }
-function Xe() {
+function wt() {
   return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (e) => {
     const t = Math.random() * 16 | 0;
     return (e === "x" ? t : t & 3 | 8).toString(16);
   });
 }
-class Gt {
+class gn {
   constructor(t = {}) {
-    var n, o;
+    var r, o;
     this._store = /* @__PURE__ */ new Map(), this._sweeper = null, this._defaultTtlMs = t.defaultTtlMs;
-    let r = null;
-    t.sweepIntervalMs === 0 ? r = null : t.sweepIntervalMs !== void 0 ? r = t.sweepIntervalMs : this._defaultTtlMs !== void 0 ? r = Math.max(1e3, Math.floor(this._defaultTtlMs / 4)) : r = null, r !== null && r > 0 && (this._sweeper = setInterval(() => this._sweep(), r), (o = (n = this._sweeper).unref) == null || o.call(n));
+    let n = null;
+    t.sweepIntervalMs === 0 ? n = null : t.sweepIntervalMs !== void 0 ? n = t.sweepIntervalMs : this._defaultTtlMs !== void 0 ? n = Math.max(1e3, Math.floor(this._defaultTtlMs / 4)) : n = null, n !== null && n > 0 && (this._sweeper = setInterval(() => this._sweep(), n), (o = (r = this._sweeper).unref) == null || o.call(r));
   }
   // ---------------------------------------------------------------------------
   // create — construct + register
@@ -927,8 +1211,8 @@ class Gt {
    * @param ttlMs - Per-entry TTL override.  Falls back to `defaultTtlMs`.
    * @returns `{ instanceId }` — pass this to `dispatch()` / `get()`.
    */
-  create(t, r = [], n) {
-    const o = new t(...r), i = Xe(), s = n ?? this._defaultTtlMs, a = s !== void 0 ? Date.now() + s : null;
+  create(t, n = [], r) {
+    const o = new t(...n), i = wt(), s = r ?? this._defaultTtlMs, a = s !== void 0 ? Date.now() + s : null;
     return this._store.set(i, { instance: o, expiresAt: a }), { instanceId: i };
   }
   // ---------------------------------------------------------------------------
@@ -940,16 +1224,16 @@ class Gt {
    * @throws When `instanceId` is unknown or the entry has expired.
    */
   get(t) {
-    const r = this._store.get(t);
-    if (!r)
+    const n = this._store.get(t);
+    if (!n)
       throw new Error(
         `[instance-registry] Unknown instanceId: "${t}"`
       );
-    if (r.expiresAt !== null && Date.now() > r.expiresAt)
-      throw this._evict(t, r), new Error(
+    if (n.expiresAt !== null && Date.now() > n.expiresAt)
+      throw this._evict(t, n), new Error(
         `[instance-registry] Instance "${t}" has expired`
       );
-    return r.instance;
+    return n.instance;
   }
   // ---------------------------------------------------------------------------
   // dispatch — call a method on a live instance
@@ -960,13 +1244,13 @@ class Gt {
    * @throws When `instanceId` is unknown/expired, or `method` is not a function
    *   on the instance.
    */
-  async dispatch(t, r, n = []) {
-    const o = this.get(t), i = o[r];
+  async dispatch(t, n, r = []) {
+    const o = this.get(t), i = o[n];
     if (typeof i != "function")
       throw new Error(
-        `[instance-registry] Method "${r}" not found on instance "${t}"`
+        `[instance-registry] Method "${n}" not found on instance "${t}"`
       );
-    return i.call(o, ...n);
+    return i.call(o, ...r);
   }
   // ---------------------------------------------------------------------------
   // dispose — explicit teardown
@@ -976,8 +1260,8 @@ class Gt {
    * instance exposes one (opt-in lifecycle hook).
    */
   async dispose(t) {
-    const r = this._store.get(t);
-    r && (this._store.delete(t), await k(r.instance));
+    const n = this._store.get(t);
+    n && (this._store.delete(t), await x(n.instance));
   }
   // ---------------------------------------------------------------------------
   // disposeAll — full teardown
@@ -989,7 +1273,7 @@ class Gt {
   async disposeAll() {
     this._sweeper !== null && (clearInterval(this._sweeper), this._sweeper = null);
     const t = [...this._store.entries()];
-    this._store.clear(), await Promise.all(t.map(([, r]) => k(r.instance)));
+    this._store.clear(), await Promise.all(t.map(([, n]) => x(n.instance)));
   }
   // ---------------------------------------------------------------------------
   // size — diagnostic helper
@@ -1003,27 +1287,27 @@ class Gt {
   // ---------------------------------------------------------------------------
   _sweep() {
     const t = Date.now();
-    for (const [r, n] of this._store)
-      n.expiresAt !== null && t > n.expiresAt && this._evict(r, n);
+    for (const [n, r] of this._store)
+      r.expiresAt !== null && t > r.expiresAt && this._evict(n, r);
   }
-  _evict(t, r) {
-    this._store.delete(t), k(r.instance);
+  _evict(t, n) {
+    this._store.delete(t), x(n.instance);
   }
 }
-async function k(e) {
+async function x(e) {
   if (e !== null && typeof e == "object" && "dispose" in e) {
     const t = e.dispose;
     typeof t == "function" && await t.call(e);
   }
 }
-function Jt(e) {
-  const { produce: t, signal: r } = e, n = r ?? new AbortController().signal;
+function wn(e) {
+  const { produce: t, signal: n } = e, r = n ?? new AbortController().signal;
   return {
     [Symbol.asyncIterator]() {
-      const o = t(n);
+      const o = t(r);
       return {
         async next() {
-          return n.aborted ? (await o.return(void 0), { done: !0, value: void 0 }) : o.next();
+          return r.aborted ? (await o.return(void 0), { done: !0, value: void 0 }) : o.next();
         },
         async return(i) {
           return await o.return(i), { done: !0, value: void 0 };
@@ -1035,183 +1319,183 @@ function Jt(e) {
     }
   };
 }
-async function Yt(e) {
+async function bn(e) {
   const t = [];
-  for await (const r of e)
-    t.push(r);
+  for await (const n of e)
+    t.push(n);
   return t;
 }
-async function Qe(e) {
+async function bt(e) {
   const t = [];
   try {
-    for await (const r of e)
-      t.push(r);
+    for await (const n of e)
+      t.push(n);
     return { ok: !0, chunks: t };
-  } catch (r) {
-    const n = de(r) ? r : new A(
+  } catch (n) {
+    const r = je(n) ? n : new I(
       "internal",
-      r instanceof Error ? r.message : String(r)
+      n instanceof Error ? n.message : String(n)
     );
     return t.length === 0 ? {
       ok: !1,
-      carrier: Q("before-first-chunk", n)
+      carrier: ie("before-first-chunk", r)
     } : {
       ok: !1,
-      carrier: Q("after-first-chunk", n, t.length)
+      carrier: ie("after-first-chunk", r, t.length)
     };
   }
 }
-function Ze(e) {
+function vt(e) {
   return e !== null && typeof e == "object" && Symbol.asyncIterator in e;
 }
 class g extends Error {
-  constructor(t, r) {
-    super(r), this.name = "UnionCodecError", this.code = t;
+  constructor(t, n) {
+    super(n), this.name = "UnionCodecError", this.code = t;
   }
 }
-function I(e) {
+function S(e) {
   const t = e.discriminator;
   if (t === null || typeof t != "object" || Array.isArray(t))
     return;
-  const r = t;
-  if (typeof r.propertyName != "string")
+  const n = t;
+  if (typeof n.propertyName != "string")
     return;
-  const n = r.mapping;
-  if (!(n === null || typeof n != "object" || Array.isArray(n)))
+  const r = n.mapping;
+  if (!(r === null || typeof r != "object" || Array.isArray(r)))
     return {
-      propertyName: r.propertyName,
-      mapping: n
+      propertyName: n.propertyName,
+      mapping: r
     };
 }
-function me(e, t) {
-  const r = e[R];
-  if (typeof r == "string") {
-    const n = t.registry.get(r);
-    if (n)
-      return n;
+function Ne(e, t) {
+  const n = e[V];
+  if (typeof n == "string") {
+    const r = t.registry.get(n);
+    if (r)
+      return r;
   }
   return t.registry.resolve(e);
 }
-function et(e, t, r) {
-  const n = me(t, r);
-  return n ? n.encode(e, t, r) : e;
+function $t(e, t, n) {
+  const r = Ne(t, n);
+  return r ? r.encode(e, t, n) : e;
 }
-function tt(e, t, r) {
-  const n = me(t, r);
-  return n ? n.decode(e, t, r) : e;
+function At(e, t, n) {
+  const r = Ne(t, n);
+  return r ? r.decode(e, t, n) : e;
 }
-function rt(e) {
-  const { id: t, schema: r } = e;
+function jt(e) {
+  const { id: t, schema: n } = e;
   return {
     id: t,
     kind: "union",
-    schema: r,
+    schema: n,
     /**
      * Structural ownership test: the node carries both `oneOf` (non-empty array)
      * and `discriminator.propertyName`. The `x-apigen-logical:"union"` hint
      * accelerates the match but is advisory — the structure is authoritative.
      */
-    matches(n) {
-      if (n[L] === "union")
+    matches(r) {
+      if (r[F] === "union")
         return !0;
-      const o = n.oneOf;
-      return !Array.isArray(o) || o.length === 0 ? !1 : I(n) !== void 0;
+      const o = r.oneOf;
+      return !Array.isArray(o) || o.length === 0 ? !1 : S(r) !== void 0;
     },
-    encode(n, o, i) {
-      const s = I(o);
+    encode(r, o, i) {
+      const s = S(o);
       if (!s)
         throw new g(
           "E_UNION_NO_DISCRIMINATOR",
           `[${t}] schema node at "${i.path}" has no discriminator.propertyName; cannot dispatch union branch.`
         );
-      const { propertyName: a, mapping: f } = s, c = n[a];
-      if (c == null)
+      const { propertyName: a, mapping: f } = s, u = r[a];
+      if (u == null)
         throw new g(
           "E_UNION_NO_DISCRIMINATOR",
           `[${t}] value at "${i.path}" is missing the discriminator property "${a}".`
         );
-      const u = String(c), p = f[u];
-      if (!p)
+      const c = String(u), l = f[c];
+      if (!l)
         throw new g(
           "E_UNION_UNKNOWN_TAG",
-          `[${t}] discriminator tag "${u}" at "${i.path}" is not in the mapping (known: ${Object.keys(f).join(", ")}).`
+          `[${t}] discriminator tag "${c}" at "${i.path}" is not in the mapping (known: ${Object.keys(f).join(", ")}).`
         );
-      const d = i.resolve(p);
-      return et(n, d, {
+      const p = i.resolve(l);
+      return $t(r, p, {
         ...i,
-        path: `${i.path}[${u}]`
+        path: `${i.path}[${c}]`
       });
     },
-    decode(n, o, i) {
-      if (n === null || typeof n != "object" || Array.isArray(n)) {
-        let l;
-        throw n === null ? l = "null" : Array.isArray(n) ? l = "array" : l = typeof n, new g(
+    decode(r, o, i) {
+      if (r === null || typeof r != "object" || Array.isArray(r)) {
+        let d;
+        throw r === null ? d = "null" : Array.isArray(r) ? d = "array" : d = typeof r, new g(
           "E_UNION_INVALID_WIRE",
-          `[${t}] expected a JSON object on the wire at "${i.path}", got ${l}.`
+          `[${t}] expected a JSON object on the wire at "${i.path}", got ${d}.`
         );
       }
-      const s = n, a = I(o);
+      const s = r, a = S(o);
       if (!a)
         throw new g(
           "E_UNION_NO_DISCRIMINATOR",
           `[${t}] schema node at "${i.path}" has no discriminator.propertyName; cannot dispatch union branch.`
         );
-      const { propertyName: f, mapping: c } = a, u = s[f];
-      if (u == null)
+      const { propertyName: f, mapping: u } = a, c = s[f];
+      if (c == null)
         throw new g(
           "E_UNION_NO_DISCRIMINATOR",
           `[${t}] wire object at "${i.path}" is missing the discriminator property "${f}".`
         );
-      const p = String(u), d = c[p];
-      if (!d)
+      const l = String(c), p = u[l];
+      if (!p)
         throw new g(
           "E_UNION_UNKNOWN_TAG",
-          `[${t}] discriminator tag "${p}" on the wire at "${i.path}" is not in the mapping (known: ${Object.keys(c).join(", ")}).`
+          `[${t}] discriminator tag "${l}" on the wire at "${i.path}" is not in the mapping (known: ${Object.keys(u).join(", ")}).`
         );
-      const m = i.resolve(d);
-      return tt(n, m, {
+      const y = i.resolve(p);
+      return At(r, y, {
         ...i,
-        path: `${i.path}[${p}]`
+        path: `${i.path}[${l}]`
       });
     }
   };
 }
-const nt = "x-apigen-instances";
-class O extends Error {
-  constructor(t, r) {
-    super(r), this.name = "NominalCodecError", this.code = t;
+const Ot = "x-apigen-instances";
+class E extends Error {
+  constructor(t, n) {
+    super(n), this.name = "NominalCodecError", this.code = t;
   }
 }
-function Z(e) {
+function se(e) {
   const t = e.properties;
   return t && typeof t == "object" && !Array.isArray(t) ? t : {};
 }
-function ot(e) {
+function Nt(e) {
   const t = e.required;
-  return Array.isArray(t) ? t.filter((r) => typeof r == "string") : [];
+  return Array.isArray(t) ? t.filter((n) => typeof n == "string") : [];
 }
-function ee(e, t, r) {
+function ae(e, t, n) {
   if (t) {
-    const n = r.registry.resolve(t);
-    if (n)
-      return n.encode(e, t, r);
+    const r = n.registry.resolve(t);
+    if (r)
+      return r.encode(e, t, n);
   }
   return e;
 }
-function it(e, t, r) {
+function Et(e, t, n) {
   if (t) {
-    const n = r.registry.resolve(t);
-    if (n)
-      return n.decode(e, t, r);
+    const r = n.registry.resolve(t);
+    if (r)
+      return r.decode(e, t, n);
   }
   return e;
 }
-function st(e) {
-  const { id: t, schema: r, ctor: n } = e;
+function _t(e) {
+  const { id: t, schema: n, ctor: r } = e;
   return {
     id: t,
     kind: "nominal",
-    schema: r,
+    schema: n,
     /**
      * Structural ownership test: the node advertises `x-apigen-logical:'nominal'`
      * or carries an `x-apigen-codec` matching this codec's id. Per
@@ -1220,14 +1504,14 @@ function st(e) {
      * handled by the transcoder walk, not by this cheap test.
      */
     matches(o) {
-      return o[L] === "nominal" ? !0 : o[R] === t;
+      return o[F] === "nominal" ? !0 : o[V] === t;
     },
     encode(o, i, s) {
       if (o === null || typeof o != "object")
         return o;
       if (s.seen.has(o)) {
         if (s.mode === "strict")
-          throw new O(
+          throw new E(
             "E_NOMINAL_CYCLE",
             `[${t}] cycle detected at "${s.path}": a nominal instance references itself. Strict mode rejects cycles (DESIGN §8.3); break the cycle or use 'lossy' mode.`
           );
@@ -1235,125 +1519,125 @@ function st(e) {
       }
       s.seen.add(o);
       try {
-        const a = Z(i), f = typeof i[x] == "string" ? i[x] : "toJSON", c = o[f];
-        if (typeof c == "function") {
-          const l = c.call(o);
-          if (l !== null && typeof l == "object" && !Array.isArray(l)) {
-            const y = {};
+        const a = se(i), f = typeof i[P] == "string" ? i[P] : "toJSON", u = o[f];
+        if (typeof u == "function") {
+          const d = u.call(o);
+          if (d !== null && typeof d == "object" && !Array.isArray(d)) {
+            const m = {};
             for (const [h, b] of Object.entries(
-              l
+              d
             ))
-              y[h] = ee(b, a[h], {
+              m[h] = ae(b, a[h], {
                 ...s,
                 path: `${s.path}/${h}`
               });
-            return y;
+            return m;
           }
-          return l;
+          return d;
         }
-        const u = {}, p = Object.keys(a), d = o, m = p.length > 0 ? p : Object.keys(d);
-        for (const l of m) {
-          const y = d[l];
-          y !== void 0 && (u[l] = ee(y, a[l], {
+        const c = {}, l = Object.keys(a), p = o, y = l.length > 0 ? l : Object.keys(p);
+        for (const d of y) {
+          const m = p[d];
+          m !== void 0 && (c[d] = ae(m, a[d], {
             ...s,
-            path: `${s.path}/${l}`
+            path: `${s.path}/${d}`
           }));
         }
-        return u;
+        return c;
       } finally {
         s.seen.delete(o);
       }
     },
     decode(o, i, s) {
       if (o === null || typeof o != "object" || Array.isArray(o)) {
-        let u;
-        throw o === null ? u = "null" : Array.isArray(o) ? u = "array" : u = typeof o, new O(
+        let c;
+        throw o === null ? c = "null" : Array.isArray(o) ? c = "array" : c = typeof o, new E(
           "E_NOMINAL_INVALID_WIRE",
-          `[${t}] expected a JSON object on the wire at "${s.path}", got ${u}.`
+          `[${t}] expected a JSON object on the wire at "${s.path}", got ${c}.`
         );
       }
       const a = o;
-      for (const u of ot(i))
-        if (!(u in a))
-          throw new O(
+      for (const c of Nt(i))
+        if (!(c in a))
+          throw new E(
             "E_NOMINAL_INVALID_WIRE",
-            `[${t}] required field "${u}" missing on the wire at "${s.path}".`
+            `[${t}] required field "${c}" missing on the wire at "${s.path}".`
           );
-      if (i[nt] === !1)
-        throw new O(
+      if (i[Ot] === !1)
+        throw new E(
           "E_NOMINAL_NONRECONSTRUCTABLE",
           `[${t}] is encode-only: the extractor marked it non-reconstructable (x-apigen-instances:false). It cannot be decoded back to a live instance.`
         );
-      const f = Z(i), c = {};
-      for (const [u, p] of Object.entries(a))
-        c[u] = it(p, f[u], {
+      const f = se(i), u = {};
+      for (const [c, l] of Object.entries(a))
+        u[c] = Et(l, f[c], {
           ...s,
-          path: `${s.path}/${u}`
+          path: `${s.path}/${c}`
         });
-      if (n) {
-        const u = typeof i[S] == "string" ? i[S] : "fromJSON", p = n[u];
-        if (typeof p == "function")
-          return p.call(
-            n,
-            c
+      if (r) {
+        const c = typeof i[T] == "string" ? i[T] : "fromJSON", l = r[c];
+        if (typeof l == "function")
+          return l.call(
+            r,
+            u
           );
-        const d = n;
-        return new d(c);
+        const p = r;
+        return new p(u);
       }
-      return c;
+      return u;
     }
   };
 }
-const at = [
-  B,
-  F,
-  K,
+const kt = [
   H,
-  q,
-  z
-], ct = {
+  K,
+  z,
+  J,
+  W,
+  G
+], It = {
   type: "object",
   "x-apigen-logical": "nominal",
   "x-apigen-codec": "ts.NominalSentinel"
-}, te = st({
+}, ce = _t({
   id: "ts.NominalSentinel",
-  schema: ct
-}), ut = {
+  schema: It
+}), Ct = {
   oneOf: [],
   discriminator: { propertyName: "kind", mapping: {} },
   "x-apigen-logical": "union",
   "x-apigen-codec": "ts.UnionSentinel"
-}, re = rt({
+}, ue = jt({
   id: "ts.UnionSentinel",
-  schema: ut
+  schema: Ct
 });
-function ft() {
+function xt() {
   const e = [
     // 6 well-known scalars
-    ...at.map((t) => [
+    ...kt.map((t) => [
       t.id,
       t
     ]),
     // nominal kind sentinel
-    [te.id, te],
+    [ce.id, ce],
     // union kind sentinel
-    [re.id, re]
+    [ue.id, ue]
   ];
   return Object.freeze(new Map(e));
 }
-const Xt = Object.freeze({
+const vn = Object.freeze({
   host: "ts",
-  logicalTypeVersion: ve,
-  codecs: ft()
+  logicalTypeVersion: Ce,
+  codecs: xt()
 });
-function Qt(e, t, r) {
-  var i;
-  const n = typeof ((i = t == null ? void 0 : t.input) == null ? void 0 : i.description) == "string" ? t.input.description : void 0, o = [r, n].filter(
-    (s) => typeof s == "string" && s.length > 0
+function $n(e, t, n) {
+  var s;
+  const r = typeof ((s = t == null ? void 0 : t.input) == null ? void 0 : s.description) == "string" ? t.input.description : void 0, o = ve(t == null ? void 0 : t.input), i = [n, r, o].filter(
+    (a) => typeof a == "string" && a.length > 0
   );
-  return o.length > 0 ? o.join(" — ") : e;
+  return i.length > 0 ? i.join(" — ") : e;
 }
-function Zt(e) {
+function An(e) {
   if (!e || typeof e != "object" || Array.isArray(e) || Object.keys(e).length === 0)
     return { outputSchema: void 0, wrapped: !1 };
   const t = e;
@@ -1366,144 +1650,145 @@ function Zt(e) {
     wrapped: !0
   };
 }
-function er(e, t) {
+function jn(e, t) {
   return e ? { result: t } : t && typeof t == "object" && !Array.isArray(t) ? t : void 0;
 }
-const pt = 4, lt = 32;
-function U(e) {
-  return de(e) ? e : e instanceof Error ? new A("internal", e.message) : e;
+const St = 4, Mt = 32;
+function q(e) {
+  return je(e) ? e : e instanceof Error ? new I("internal", e.message) : e;
 }
-function dt(e, t) {
+function Tt(e, t) {
   if (e === "serial" || e === "chained")
     return 1;
-  const r = t ?? pt;
-  return !Number.isFinite(r) || r < 1 ? 1 : Math.min(Math.floor(r), lt);
+  const n = t ?? St;
+  return !Number.isFinite(n) || n < 1 ? 1 : Math.min(Math.floor(n), Mt);
 }
-function yt() {
+function Pt() {
 }
-function mt(e, t) {
+function Dt(e, t) {
   var i;
   if (!e && !t)
-    return { signal: void 0, dispose: yt };
-  const r = new AbortController(), n = () => {
-    r.abort(e == null ? void 0 : e.reason);
+    return { signal: void 0, dispose: Pt };
+  const n = new AbortController(), r = () => {
+    n.abort(e == null ? void 0 : e.reason);
   };
-  e && (e.aborted ? r.abort(e.reason) : e.addEventListener("abort", n, { once: !0 }));
+  e && (e.aborted ? n.abort(e.reason) : e.addEventListener("abort", r, { once: !0 }));
   let o;
-  return t !== void 0 && !r.signal.aborted && (o = setTimeout(() => {
-    r.abort(
+  return t !== void 0 && !n.signal.aborted && (o = setTimeout(() => {
+    n.abort(
       new DOMException(
         `apigen/invokeBatch: item timed out after ${t}ms`,
         "TimeoutError"
       )
     );
   }, t), (i = o.unref) == null || i.call(o)), {
-    signal: r.signal,
+    signal: n.signal,
     dispose() {
-      e && e.removeEventListener("abort", n), o && clearTimeout(o);
+      e && e.removeEventListener("abort", r), o && clearTimeout(o);
     }
   };
 }
-async function ne(e, t, r, n, o, i) {
-  const s = mt(n.signal, i);
+async function fe(e, t, n, r, o, i) {
+  const s = Dt(r.signal, i);
   try {
-    const a = s.signal ? { ...n, signal: s.signal } : n, f = await e(t, a, o);
-    if (Ze(f)) {
-      const c = await Qe(f);
-      if (c.ok)
-        return { index: r, status: "fulfilled", chunks: c.chunks };
-      const u = c.carrier;
+    const a = s.signal ? { ...r, signal: s.signal } : r, f = await e(t, a, o);
+    if (vt(f)) {
+      const u = await bt(f);
+      if (u.ok)
+        return { index: n, status: "fulfilled", chunks: u.chunks };
+      const c = u.carrier;
       return {
-        index: r,
+        index: n,
         status: "rejected",
-        reason: U(u.error),
-        ...u.phase === "after-first-chunk" ? { chunksDelivered: u.chunksDelivered } : {}
+        reason: q(c.error),
+        ...c.phase === "after-first-chunk" ? { chunksDelivered: c.chunksDelivered } : {}
       };
     }
-    return { index: r, status: "fulfilled", value: f };
+    return { index: n, status: "fulfilled", value: f };
   } catch (a) {
-    return { index: r, status: "rejected", reason: U(a) };
+    return { index: n, status: "rejected", reason: q(a) };
   } finally {
     s.dispose();
   }
 }
-async function tr(e, t, r, n, o = {}) {
-  const i = o.mode ?? "parallel", s = o.onItemError ?? "continue", a = dt(i, o.concurrency), f = new Array(r.length), c = (l) => ({
-    index: l,
+async function On(e, t, n, r, o = {}) {
+  const i = o.mode ?? "parallel", s = o.onItemError ?? "continue", a = Tt(i, o.concurrency), f = new Array(n.length), u = (d) => ({
+    index: d,
     status: "rejected",
-    reason: U(
+    reason: q(
       new Error(
         "apigen/invokeBatch: not attempted — an earlier item failed and " + (i === "chained" ? 'mode is "chained"' : 'onItemError is "abort"')
       )
     )
   });
   if (i === "serial" || i === "chained") {
-    let l = !1;
-    for (let y = 0; y < r.length; y++) {
-      if (l) {
-        f[y] = c(y);
+    let d = !1;
+    for (let m = 0; m < n.length; m++) {
+      if (d) {
+        f[m] = u(m);
         continue;
       }
-      const h = await ne(
+      const h = await fe(
         e,
         t,
-        y,
-        r[y],
-        n,
+        m,
+        n[m],
+        r,
         o.itemTimeoutMs
       );
-      f[y] = h, h.status === "rejected" && (i === "chained" || s === "abort") && (l = !0);
+      f[m] = h, h.status === "rejected" && (i === "chained" || s === "abort") && (d = !0);
     }
     return f;
   }
-  let u = 0, p = !1;
-  const d = Math.max(1, Math.min(a, r.length)), m = Array.from({ length: d }, async () => {
+  let c = 0, l = !1;
+  const p = Math.max(1, Math.min(a, n.length)), y = Array.from({ length: p }, async () => {
     for (; ; ) {
-      const l = u++;
-      if (l >= r.length)
+      const d = c++;
+      if (d >= n.length)
         return;
-      if (p) {
-        f[l] = c(l);
+      if (l) {
+        f[d] = u(d);
         continue;
       }
-      const y = await ne(
+      const m = await fe(
         e,
         t,
-        l,
-        r[l],
-        n,
+        d,
+        n[d],
+        r,
         o.itemTimeoutMs
       );
-      f[l] = y, y.status === "rejected" && s === "abort" && (p = !0);
+      f[d] = m, m.status === "rejected" && s === "abort" && (l = !0);
     }
   });
-  return await Promise.all(m), f;
+  return await Promise.all(y), f;
 }
-const oe = /* @__PURE__ */ new Set(["string", "number", "boolean", "integer"]);
-function ht(e) {
+he(import.meta.url);
+const le = /* @__PURE__ */ new Set(["string", "number", "boolean", "integer"]);
+function Ut(e) {
   if (typeof e != "object" || e === null)
     return !1;
   const t = e;
   if (t.$ref !== void 0 || t.oneOf || t.anyOf || t.allOf)
     return !1;
-  const { type: r } = t;
-  return typeof r == "string" ? oe.has(r) : Array.isArray(r) ? r.every((n) => oe.has(n) || n === "null") : Array.isArray(t.enum) && t.enum.length > 0 ? t.enum.every((n) => ["string", "number", "boolean"].includes(typeof n)) : !1;
+  const { type: n } = t;
+  return typeof n == "string" ? le.has(n) : Array.isArray(n) ? n.every((r) => le.has(r) || r === "null") : Array.isArray(t.enum) && t.enum.length > 0 ? t.enum.every((r) => ["string", "number", "boolean"].includes(typeof r)) : !1;
 }
-function gt(e) {
+function Rt(e) {
   if (!e || typeof e != "object")
     return !1;
   const t = e.properties;
   return t === void 0 || typeof t != "object" || t === null ? !1 : Object.values(t).every(
-    ht
+    Ut
   );
 }
-const wt = {
+const Lt = {
   "decimal.js": "Decimal"
 };
-function bt(e) {
+function Bt(e) {
   return e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-Object.entries(wt).map(([e, t]) => ({
+Object.entries(Lt).map(([e, t]) => ({
   // Matches: import("...{modSpec}...").<anyMemberName>  (single or double quotes)
   // The module specifier appears inside an absolute path, so we allow any
   // characters between the quote and the specifier, and between the specifier
@@ -1511,136 +1796,137 @@ Object.entries(wt).map(([e, t]) => ({
   // …) is matched generically (`\w+`) rather than anchored to one spelling —
   // see the doc comment above for why.
   pattern: new RegExp(
-    `import\\(["'][^"']*${bt(e)}[^"']*["']\\)\\.\\w+`,
+    `import\\(["'][^"']*${Bt(e)}[^"']*["']\\)\\.\\w+`,
     "g"
   ),
   key: t
 }));
-function ie(e) {
+function pe(e) {
   return e.words.join("-");
 }
-function se(e) {
-  return e.words.map(Ot).join("");
+function de(e) {
+  return e.words.map(Kt).join("");
 }
-function ae(e) {
+function ye(e) {
   return e.words.join("_");
 }
-function vt(e, t = {}) {
-  var r, n;
-  const o = [e.namespace, ...e.path], i = e.safe || gt(e.input) ? "GET" : "POST", s = ((n = (r = t.http) == null ? void 0 : r.verb) == null ? void 0 : n[e.id]) ?? i, a = "/" + o.map((m) => ie(m)).join("/"), f = o.map((m) => ae(m)).join("_"), c = o.map((m) => ae(m)).slice(0, -1).join("."), u = se(o[o.length - 2] ?? o[0]), p = se(o[o.length - 1]), d = o.map((m) => ie(m));
+function qt(e, t = {}) {
+  var n, r;
+  const o = [e.namespace, ...e.path], i = e.safe || Rt(e.input) ? "GET" : "POST", s = ((r = (n = t.http) == null ? void 0 : n.verb) == null ? void 0 : r[e.id]) ?? i, a = "/" + o.map((y) => pe(y)).join("/"), f = o.map((y) => ye(y)).join("_"), u = o.map((y) => ye(y)).slice(0, -1).join("."), c = de(o[o.length - 2] ?? o[0]), l = de(o[o.length - 1]), p = o.map((y) => pe(y));
   return {
     http: { verb: s, route: a },
     mcp: { name: f },
-    grpc: { package: c, service: u, method: p },
-    cli: { path: d }
+    grpc: { package: u, service: c, method: l },
+    cli: { path: p }
   };
 }
-function $t(e, t) {
+function Ft(e, t) {
   return `x-${e}-${t}`;
 }
-function jt(e, t) {
+function Vt(e, t) {
   return `--${e}-${t}`;
 }
-function Nt(e, t) {
-  const r = (n) => n.toUpperCase().replace(/-/g, "_");
-  return e === "adhd" ? `APIGEN_${r(t)}` : `APIGEN_${r(e)}_${r(t)}`;
+function Ht(e, t) {
+  const n = (r) => r.toUpperCase().replace(/-/g, "_");
+  return e === "adhd" ? `APIGEN_${n(t)}` : `APIGEN_${n(e)}_${n(t)}`;
 }
-function Ot(e) {
+function Kt(e) {
   return e.length === 0 ? e : e[0].toUpperCase() + e.slice(1);
 }
-function V(e) {
+function Y(e) {
   return e.anyOf ?? e.oneOf;
 }
-function At(e) {
+function zt(e) {
   if (!e)
     return !1;
   if (e.type === "array" || e.type === "object")
     return !0;
-  const t = V(e);
+  const t = Y(e);
   if (t) {
-    const r = t.filter((n) => n.type !== "null");
-    return r.length > 0 && r.every((n) => n.type === "array" || n.type === "object");
+    const n = t.filter((r) => r.type !== "null");
+    return n.length > 0 && n.every((r) => r.type === "array" || r.type === "object");
   }
   return !1;
 }
-function _t(e) {
+function Jt(e) {
   if (!e)
     return !1;
   if (e.type === "boolean")
     return !0;
-  const t = V(e);
+  const t = Y(e);
   if (t) {
-    const r = t.filter((n) => n.type !== "null");
-    return r.length > 0 && r.every((n) => n.type === "boolean");
+    const n = t.filter((r) => r.type !== "null");
+    return n.length > 0 && n.every((r) => r.type === "boolean");
   }
   return !1;
 }
-function Et(e) {
+function Wt(e) {
   if (!e)
     return !1;
   if (e.type === "number" || e.type === "integer")
     return !0;
-  const t = V(e);
+  const t = Y(e);
   if (t) {
-    const r = t.filter((n) => n.type !== "null");
-    return r.length > 0 && r.every((n) => n.type === "number" || n.type === "integer");
+    const n = t.filter((r) => r.type !== "null");
+    return n.length > 0 && n.every((r) => r.type === "number" || r.type === "integer");
   }
   return !1;
 }
-function kt(e) {
+function Gt(e) {
   return e.replace(/[A-Z]/g, (t) => "-" + t.toLowerCase());
 }
-function It(e) {
+function Yt(e) {
   var o, i;
-  const t = (i = (o = e.input) == null ? void 0 : o.properties) == null ? void 0 : i.data, r = (t == null ? void 0 : t.properties) ?? {}, n = (t == null ? void 0 : t.required) ?? [];
-  return { props: r, required: n };
+  const t = (i = (o = e.input) == null ? void 0 : o.properties) == null ? void 0 : i.data, n = (t == null ? void 0 : t.properties) ?? {}, r = (t == null ? void 0 : t.required) ?? [];
+  return { props: n, required: r };
 }
-function ce(e) {
+function me(e) {
   return typeof e.handler == "function";
 }
-function Ct(e) {
+function Zt(e) {
   var o;
-  const t = ((o = e.input) == null ? void 0 : o.properties) ?? {}, r = e["x-apigen-envelope"], n = [];
+  const t = ((o = e.input) == null ? void 0 : o.properties) ?? {}, n = e["x-apigen-envelope"], r = [];
   for (const i of Object.keys(t)) {
     if (i === "data")
       continue;
-    const s = (r == null ? void 0 : r[i]) ?? "adhd", a = $t(s, i);
-    n.push({
+    const s = (n == null ? void 0 : n[i]) ?? "adhd", a = Ft(s, i);
+    r.push({
       field: i,
       pluginId: s,
       httpHeader: a,
       mcpMetaKey: a,
-      cliFlag: jt(s, i),
-      envVar: Nt(s, i)
+      cliFlag: Vt(s, i),
+      envVar: Ht(s, i)
     });
   }
-  return n;
+  return r;
 }
-function St(e, t) {
-  const r = /* @__PURE__ */ new Map(), { props: n } = It(e);
-  for (const [o, i] of Object.entries(n)) {
+function Qt(e, t, n, r) {
+  t === n || e.has(t) || e.set(t, { ...r, aliasOf: n });
+}
+function Xt(e, t) {
+  const n = /* @__PURE__ */ new Map(), { props: r } = Yt(e);
+  for (const [o, i] of Object.entries(r)) {
     let s = "string";
-    _t(i) ? s = "boolean" : (At(i) || Et(i)) && (s = "json"), r.set(kt(o), {
-      camelKey: o,
-      kind: "domain",
-      valueKind: s
-    });
+    Jt(i) ? s = "boolean" : (zt(i) || Wt(i)) && (s = "json");
+    const a = Gt(o), f = { camelKey: o, kind: "domain", valueKind: s };
+    n.set(a, f), Qt(n, o, a, f);
   }
   for (const o of t) {
-    const i = o.cliFlag.replace(/^--/, "");
-    r.set(i, {
+    const i = o.cliFlag.replace(/^--/, ""), s = {
       camelKey: o.field,
       kind: "envelope",
       valueKind: "string",
       envVar: o.envVar
-    });
+    };
+    n.set(i, s);
   }
-  return r;
+  return n;
 }
-function rr(e) {
-  const { op: t, schema: r, transport: n, projection: o } = e, i = vt(t, o), s = r ? Ct(r) : [], a = r ? St(r, s) : /* @__PURE__ */ new Map(), f = r ? Ve(r).params : void 0, c = {
+function Nn(e) {
+  const { op: t, schema: n, transport: r, projection: o } = e, i = qt(t, o), s = n ? Zt(n) : [], a = n ? Xt(n, s) : /* @__PURE__ */ new Map(), f = n ? pt(n).params : void 0, u = {
     op: t,
-    transport: n,
+    transport: r,
     http: i.http,
     mcp: i.mcp,
     cli: i.cli,
@@ -1649,58 +1935,62 @@ function rr(e) {
     envelope: s,
     cliFlags: a,
     streaming: t.streaming,
-    isMount: ce(t)
+    isMount: me(t)
   };
-  if (ce(t)) {
-    const u = t.handler;
-    c.mountHandler = async (p) => u(p);
+  if (me(t)) {
+    const c = t.handler;
+    u.mountHandler = async (l) => c(l);
   }
-  return c;
+  return u;
 }
-function nr(e) {
+function En(e) {
   const t = e.usePlugins;
   return Array.isArray(t) ? t : [];
 }
-function or(e) {
+function _n(e) {
+  const t = e.exitCode;
+  return typeof t == "function" ? t : void 0;
+}
+function kn(e) {
   const t = e.useOptions;
   return t && typeof t == "object" ? t : {};
 }
-function xt(e) {
-  return async function(r, n) {
-    const o = Object.assign(r, { data: r.domainArgs });
-    return await e.layer(o, n);
+function en(e) {
+  return async function(n, r) {
+    const o = Object.assign(n, { data: n.domainArgs });
+    return await e.layer(o, r);
   };
 }
-function ir(e, t) {
-  var n;
-  const r = [];
+function In(e, t) {
+  var r;
+  const n = [];
   for (const o of t) {
-    const i = (n = o.capabilities) == null ? void 0 : n.layer;
-    i && r.push(xt(i));
+    const i = (r = o.capabilities) == null ? void 0 : r.layer;
+    i && n.push(en(i));
   }
-  return r.push(Ye(e)), Me(r);
+  return n.push(gt(e)), Ge(n);
 }
-function Mt() {
+function tn() {
   const e = /* @__PURE__ */ new Map();
   return {
     get: (t) => e.get(t),
-    set: (t, r) => {
-      e.set(t, r);
+    set: (t, n) => {
+      e.set(t, n);
     }
   };
 }
-const Tt = {
+const nn = {
   input: {
     type: "object",
     properties: { data: { type: "object", properties: {} } }
   },
   output: {}
 };
-async function sr(e, t, r, n) {
+async function Cn(e, t, n, r) {
   const o = {
-    ...r,
+    ...n,
     operation: { id: e.op.id },
-    ctx: new xe()
+    ctx: new We()
   };
   if (e.isMount) {
     const i = e.mountHandler;
@@ -1710,58 +2000,59 @@ async function sr(e, t, r, n) {
       );
     const s = {
       operation: e.op,
-      data: r.domainArgs,
-      envelope: r.envelope,
-      ctx: Mt(),
+      data: n.domainArgs,
+      envelope: n.envelope,
+      ctx: tn(),
       transport: e.transport,
-      signal: r.signal ?? new AbortController().signal
+      signal: n.signal ?? new AbortController().signal
     }, a = {
-      ...n,
+      ...r,
       fns: { [e.op.id]: () => i(s) },
-      schemas: { [e.op.id]: Tt }
+      schemas: { [e.op.id]: nn }
     };
     return t(e.op.id, o, a);
   }
-  return t(e.op.id, o, n);
+  return t(e.op.id, o, r);
 }
 export {
-  pt as BATCH_DEFAULT_CONCURRENCY,
-  lt as BATCH_MAX_CONCURRENCY,
-  Te as EventBus,
-  Gt as InstanceRegistry,
-  xe as LayerContext,
+  St as BATCH_DEFAULT_CONCURRENCY,
+  Mt as BATCH_MAX_CONCURRENCY,
+  Ye as EventBus,
+  gn as InstanceRegistry,
+  We as LayerContext,
   g as UnionCodecError,
-  Je as ValidateSchemasToken,
-  at as WELL_KNOWN_TS_CODECS,
-  xt as adaptCoreLayer,
-  ze as assertNoSelfSubscription,
-  Ue as buildContext,
-  Vt as buildFnTable,
-  Zt as buildMcpOutputSchema,
-  rr as buildOpPlan,
-  Qt as buildToolDescription,
-  zt as coerceQueryParams,
-  Qe as collectWithPhase,
-  Ht as createApiPackage,
-  Me as createInvoker,
-  qt as createLogger,
-  ir as createPackageInvoker,
-  Jt as createStream,
-  rt as createUnionCodec,
-  ke as dataParamNames,
-  Kt as defineMiddleware,
-  Ve as describeParams,
-  Se as dispatch,
-  sr as dispatchForPlan,
-  Yt as drainStream,
-  tr as invokeBatch,
-  Ze as isApiStream,
-  Ye as makeValidateLayer,
-  Ee as needsEnvelopeField,
-  or as readUseOptions,
-  nr as readUsePlugins,
-  Xt as tsHostBinding,
-  Wt as validateLayer,
-  De as wireObservers,
-  er as wrapMcpStructuredContent
+  ht as ValidateSchemasToken,
+  kt as WELL_KNOWN_TS_CODECS,
+  en as adaptCoreLayer,
+  at as assertNoSelfSubscription,
+  Xe as buildContext,
+  mn as buildFnTable,
+  An as buildMcpOutputSchema,
+  Nn as buildOpPlan,
+  $n as buildToolDescription,
+  yn as coerceQueryParams,
+  bt as collectWithPhase,
+  pn as createApiPackage,
+  Ge as createInvoker,
+  dn as createLogger,
+  In as createPackageInvoker,
+  wn as createStream,
+  jt as createUnionCodec,
+  He as dataParamNames,
+  ln as defineMiddleware,
+  pt as describeParams,
+  Je as dispatch,
+  Cn as dispatchForPlan,
+  bn as drainStream,
+  On as invokeBatch,
+  vt as isApiStream,
+  gt as makeValidateLayer,
+  Ve as needsEnvelopeField,
+  _n as readExitCodeHook,
+  kn as readUseOptions,
+  En as readUsePlugins,
+  vn as tsHostBinding,
+  hn as validateLayer,
+  Qe as wireObservers,
+  jn as wrapMcpStructuredContent
 };