@adhd/apigen-core-client 0.2.2 → 0.3.1

package/index.mjs

@@ -1,277 +1,306 @@
-import { Project as te, Scope as L } from "ts-morph";
-import Ne from "node:fs";
-import * as Oe from "node:path";
-import Y from "node:path";
-import { createParser as ke, createFormatter as Ee, SchemaGenerator as Ce, AnnotatedType as ne, StringType as re } from "ts-json-schema-generator";
-function oe(e) {
+import De from "node:fs";
+import { createRequire as qe } from "node:module";
+import * as Be from "node:path";
+import ce from "node:path";
+function ge(e) {
   return {
     raw: e,
     words: e.split(/(?=[A-Z])|[-_]/).map((t) => t.toLowerCase()).filter(Boolean)
   };
 }
-function Ie(e, t, n = {}) {
+function We(e, t, r = {}) {
   const o = e.split("/");
-  if (o.length < 2 || o.some((l) => l.length === 0))
+  if (o.length < 2 || o.some((u) => u.length === 0))
     throw new Error(
       `syntheticOp: id "${e}" must be "<namespace>/<path...>" with non-empty segments`
     );
-  const [r, ...i] = o, s = r.replace(/^_+/, ""), a = n.kind ?? "action", c = {
+  const [n, ...i] = o, s = n.replace(/^_+/, ""), a = r.kind ?? "action", c = {
     id: e,
     host: t.host,
-    namespace: oe(s),
-    path: i.map(oe),
+    namespace: ge(s),
+    path: i.map(ge),
     kind: a,
-    async: n.async ?? !1,
-    streaming: n.streaming ?? !1,
-    safe: n.safe ?? a === "query",
-    input: n.input ?? {},
-    output: n.output ?? {},
-    envelope: n.envelope ?? {},
-    typeText: n.typeText ?? null
+    async: r.async ?? !1,
+    streaming: r.streaming ?? !1,
+    safe: r.safe ?? a === "query",
+    input: r.input ?? {},
+    output: r.output ?? {},
+    envelope: r.envelope ?? {},
+    typeText: r.typeText ?? null
   };
-  return n.hasCtx !== void 0 && (c.hasCtx = n.hasCtx), n.transports !== void 0 && (c.transports = n.transports), c;
+  return r.hasCtx !== void 0 && (c.hasCtx = r.hasCtx), r.transports !== void 0 && (c.transports = r.transports), c;
 }
-const ge = Symbol.for("adhd.apigen.extraction-session");
-function de(e, t) {
-  const n = [
+const N = qe(import.meta.url);
+let z;
+function Ne() {
+  return z || (z = N("ts-morph").Project, z);
+}
+const Oe = Symbol.for("adhd.apigen.extraction-session");
+function ue(e, t) {
+  const r = [
     ...e.getImportDeclarations().map((o) => o.getModuleSpecifierSourceFile()),
     ...e.getExportDeclarations().map((o) => o.getModuleSpecifierSourceFile())
   ];
-  for (const o of n) {
+  for (const o of r) {
     if (!o)
       continue;
-    const r = o.getFilePath();
-    if (!r.includes("/node_modules/") && !t.has(r)) {
-      t.add(r);
+    const n = o.getFilePath();
+    if (!n.includes("/node_modules/") && !t.has(n)) {
+      t.add(n);
       try {
         o.refreshFromFileSystemSync();
       } catch {
       }
-      de(o, t);
+      ue(o, t);
     }
   }
 }
-function ye(e) {
+function ke(e) {
   try {
-    const t = Ne.statSync(e);
+    const t = De.statSync(e);
     return `${t.mtimeMs}:${t.size}`;
   } catch {
     return "nostat";
   }
 }
-const F = /* @__PURE__ */ new Map(), Z = /* @__PURE__ */ new Map();
-function Fe(e, t, n) {
-  const o = t ?? "", r = F.get(o);
-  let i = n;
-  if (r && r.fileVersions.size > 0) {
-    const c = [n], l = [...r.fileVersions.entries()].sort(
-      ([u], [f]) => u.localeCompare(f)
+const M = /* @__PURE__ */ new Map(), ne = /* @__PURE__ */ new Map();
+function Ue(e, t, r) {
+  const o = t ?? "", n = M.get(o);
+  let i = r;
+  if (n && n.fileVersions.size > 0) {
+    const c = [r], u = [...n.fileVersions.entries()].sort(
+      ([l], [f]) => l.localeCompare(f)
     );
-    for (const [u, f] of l)
-      u !== e && c.push(`${u}:${f}`);
+    for (const [l, f] of u)
+      l !== e && c.push(`${l}:${f}`);
     i = c.join("|");
   }
   const s = `${e}\0${t ?? ""}`;
-  let a = Z.get(s);
-  return (!a || a.version !== i) && (a = { version: i, schemas: /* @__PURE__ */ new Map() }, Z.set(s, a)), a.schemas;
+  let a = ne.get(s);
+  return (!a || a.version !== i) && (a = { version: i, schemas: /* @__PURE__ */ new Map() }, ne.set(s, a)), a.schemas;
+}
+function Qt() {
+  M.clear(), ne.clear(), G = void 0;
+}
+let G;
+function Ge() {
+  if (!G) {
+    const e = Ne();
+    G = new e({
+      skipAddingFilesFromTsConfig: !0,
+      compilerOptions: { noLib: !0 }
+    });
+  }
+  return G;
 }
-function Ft() {
-  F.clear(), Z.clear();
+function Xt(e) {
+  const t = Ge(), r = t.getSourceFile(e), o = r ?? t.addSourceFileAtPath(e);
+  if (r)
+    try {
+      r.refreshFromFileSystemSync();
+    } catch {
+    }
+  const n = /* @__PURE__ */ new Set([e]);
+  return ue(o, n), [...n].sort();
 }
-function he() {
+function Ee() {
   const e = {
     projectsBuilt: 0,
     generatorsBuilt: 0,
     schemaCacheHits: 0,
     schemaCacheMisses: 0
   }, t = /* @__PURE__ */ new Map();
-  let n = !1;
+  let r = !1;
   return {
-    [ge]: !0,
+    [Oe]: !0,
     stats: e,
     schemaCache: /* @__PURE__ */ new Map(),
     aliasCache: /* @__PURE__ */ new WeakMap(),
     zodImportCache: /* @__PURE__ */ new WeakMap(),
     generatorCache: /* @__PURE__ */ new Map(),
-    projectFor(r) {
-      if (n)
+    projectFor(n) {
+      if (r)
         throw new Error("apigen-core: ExtractionSession used after dispose()");
-      const i = r ?? "", s = r ? this.statVersion(r) : "";
-      let a = F.get(i);
-      return a && a.tsconfigVersion !== s && (a = void 0), a || (a = { project: r ? new te({
-        tsConfigFilePath: r,
-        skipAddingFilesFromTsConfig: !0
-      }) : new te({ skipAddingFilesFromTsConfig: !0 }), tsconfigVersion: s, fileVersions: /* @__PURE__ */ new Map() }, F.set(i, a), e.projectsBuilt++), a.project;
+      const i = n ?? "", s = n ? this.statVersion(n) : "";
+      let a = M.get(i);
+      if (a && a.tsconfigVersion !== s && (a = void 0), !a) {
+        const c = Ne();
+        a = { project: n ? new c({
+          tsConfigFilePath: n,
+          skipAddingFilesFromTsConfig: !0
+        }) : new c({ skipAddingFilesFromTsConfig: !0 }), tsconfigVersion: s, fileVersions: /* @__PURE__ */ new Map() }, M.set(i, a), e.projectsBuilt++;
+      }
+      return a.project;
     },
-    sourceFileFor(r, i) {
-      const s = this.projectFor(i), a = F.get(i ?? ""), c = this.statVersion(r);
-      let l = s.getSourceFile(r);
-      if (l === void 0 ? l = s.addSourceFileAtPath(r) : a && a.fileVersions.get(r) !== c && l.refreshFromFileSystemSync(), a == null || a.fileVersions.set(r, c), a) {
-        const u = /* @__PURE__ */ new Set([r]);
-        de(l, u);
-        for (const f of u)
-          f !== r && a.fileVersions.set(f, this.statVersion(f));
+    sourceFileFor(n, i) {
+      const s = this.projectFor(i), a = M.get(i ?? ""), c = this.statVersion(n);
+      let u = s.getSourceFile(n);
+      if (u === void 0 ? u = s.addSourceFileAtPath(n) : a && a.fileVersions.get(n) !== c && u.refreshFromFileSystemSync(), a == null || a.fileVersions.set(n, c), a) {
+        const l = /* @__PURE__ */ new Set([n]);
+        ue(u, l);
+        for (const f of l)
+          f !== n && a.fileVersions.set(f, this.statVersion(f));
       }
-      return l;
+      return u;
     },
-    statVersion(r) {
-      let i = t.get(r);
-      return i === void 0 && (i = ye(r), t.set(r, i)), i;
+    statVersion(n) {
+      let i = t.get(n);
+      return i === void 0 && (i = ke(n), t.set(n, i)), i;
     },
     dispose() {
-      n = !0, this.schemaCache.clear(), this.generatorCache.clear(), t.clear();
+      r = !0, this.schemaCache.clear(), this.generatorCache.clear(), t.clear();
     }
   };
 }
-function Te(e) {
+function Ie(e) {
   const t = e;
-  if (t[ge] !== !0)
+  if (t[Oe] !== !0)
     throw new Error(
       "apigen-core: unknown ExtractionSession implementation — create sessions with createExtractionSession()"
     );
   return t;
 }
-const K = "x-apigen-logical";
-function ie(e, t) {
-  const n = /* @__PURE__ */ new Set(), o = [e];
+const Z = "x-apigen-logical";
+function ye(e, t) {
+  const r = /* @__PURE__ */ new Set(), o = [e];
   for (; o.length > 0; ) {
-    const r = o.pop();
-    if (!r || n.has(r))
+    const n = o.pop();
+    if (!n || r.has(n))
       continue;
-    n.add(r);
-    const i = r.$ref;
+    r.add(n);
+    const i = n.$ref;
     if (typeof i == "string") {
       if (t) {
         const f = t[i];
         if (!f) {
-          const p = Object.keys(t).join(", ") || "(none)";
+          const m = Object.keys(t).join(", ") || "(none)";
           throw new Error(
-            `[apigen-logical] $ref "${i}" cannot be resolved. Available $defs: ${p}`
+            `[apigen-logical] $ref "${i}" cannot be resolved. Available $defs: ${m}`
           );
         }
         o.push(f);
       }
       continue;
     }
-    const s = r.oneOf;
+    const s = n.oneOf;
     if (Array.isArray(s))
       for (const f of s)
         typeof f == "object" && f !== null && o.push(f);
-    const a = r.properties;
+    const a = n.properties;
     if (a)
       for (const f of Object.values(a))
         o.push(f);
-    const c = r.items;
+    const c = n.items;
     if (Array.isArray(c))
       for (const f of c)
         typeof f == "object" && f !== null && o.push(f);
     else
       typeof c == "object" && c !== null && o.push(c);
-    const l = r.additionalProperties;
-    typeof l == "object" && l !== null && o.push(l);
-    const u = r.propertyNames;
+    const u = n.additionalProperties;
     typeof u == "object" && u !== null && o.push(u);
+    const l = n.propertyNames;
+    typeof l == "object" && l !== null && o.push(l);
   }
 }
-const se = /* @__PURE__ */ new Set(["string", "number", "boolean", "integer"]);
-function Re(e) {
+const he = /* @__PURE__ */ new Set(["string", "number", "boolean", "integer"]);
+function He(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: n } = t;
-  return typeof n == "string" ? se.has(n) : Array.isArray(n) ? n.every((o) => se.has(o) || o === "null") : Array.isArray(t.enum) && t.enum.length > 0 ? t.enum.every((o) => ["string", "number", "boolean"].includes(typeof o)) : !1;
+  const { type: r } = t;
+  return typeof r == "string" ? he.has(r) : Array.isArray(r) ? r.every((o) => he.has(o) || o === "null") : Array.isArray(t.enum) && t.enum.length > 0 ? t.enum.every((o) => ["string", "number", "boolean"].includes(typeof o)) : !1;
 }
-function _e(e) {
+function Je(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(
-    Re
+    He
   );
 }
-function Rt(e) {
-  var n, o;
+function Yt(e) {
+  var r, o;
   const t = [];
-  for (const r of e) {
+  for (const n of e) {
     const i = {
-      ...(n = r.capabilities.layer) == null ? void 0 : n.envelopeFields,
-      ...(o = r.capabilities.envelope) == null ? void 0 : o.request
+      ...(r = n.capabilities.layer) == null ? void 0 : r.envelopeFields,
+      ...(o = n.capabilities.envelope) == null ? void 0 : o.request
     };
-    Object.keys(i).length > 0 && t.push({ id: r.id, envelope: i });
+    Object.keys(i).length > 0 && t.push({ id: n.id, envelope: i });
   }
   return t;
 }
-function Le(e) {
-  const t = {}, n = (o) => {
-    for (const r of ["definitions", "$defs"]) {
-      const i = o[r];
+function Ze(e) {
+  const t = {}, r = (o) => {
+    for (const n of ["definitions", "$defs"]) {
+      const i = o[n];
       if (i)
         for (const [s, a] of Object.entries(i)) {
-          const c = s.startsWith("#/") ? s : `#/${r}/${s}`;
+          const c = s.startsWith("#/") ? s : `#/${n}/${s}`;
           t[c] = a;
         }
     }
   };
   for (const o of Object.values(e.schemas))
-    n(o.input), n(o.output);
+    r(o.input), r(o.output);
   if (Object.keys(t).length !== 0)
-    for (const [o, r] of Object.entries(e.schemas))
+    for (const [o, n] of Object.entries(e.schemas))
       try {
-        ie(r.input, t), ie(r.output, t);
+        ye(n.input, t), ye(n.output, t);
       } catch (i) {
         throw new Error(
           `[apigen-core-client] Schema validation failed for function "${o}": ${i.message}`
         );
       }
 }
-function Me(e, t) {
-  const n = [
+function Qe(e, t) {
+  const r = [
     '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 && n.push(
+  return e.length > 0 && r.push(
     `Field(s) ${e.map((o) => `"${o}"`).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(" ");
+  ), r.join(" ");
 }
-function _t(e, t, n) {
-  Le(e);
+function en(e, t, r) {
+  Ze(e);
   const o = {};
-  for (const [r, i] of Object.entries(e.schemas)) {
-    const s = (n == null ? void 0 : n[r]) ?? {}, a = i.input.properties ?? {}, c = i.input.required ?? [], l = {}, u = [], f = {};
-    for (const b of t)
-      if (b.envelope && s[b.id] !== !1)
-        for (const [y, h] of Object.entries(b.envelope))
-          l[y] = h, f[y] = b.id, u.includes(y) || u.push(y);
-    const p = {
+  for (const [n, i] of Object.entries(e.schemas)) {
+    const s = (r == null ? void 0 : r[n]) ?? {}, a = i.input.properties ?? {}, c = i.input.required ?? [], u = {}, l = [], f = {};
+    for (const g of t)
+      if (g.envelope && s[g.id] !== !1)
+        for (const [x, p] of Object.entries(g.envelope))
+          u[x] = p, f[x] = g.id, l.includes(x) || l.push(x);
+    const m = {
       type: "object",
       properties: a,
       additionalProperties: !1,
       ...c.length > 0 ? { required: c } : {}
-    }, T = i.safe === !0 || _e(i.input), d = i.input.definitions, m = i.input.$defs;
-    o[r] = {
+    }, h = i.safe === !0 || Je(i.input), y = i.input.definitions, d = i.input.$defs;
+    o[n] = {
       input: {
         type: "object",
-        properties: { ...l, data: p },
+        properties: { ...u, data: m },
         required: [
-          ...u,
+          ...l,
           ...c.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: Me(
-          Object.keys(l),
+        description: Qe(
+          Object.keys(u),
           Object.keys(a).length > 0
         ),
-        ...d ? { definitions: d } : {},
-        ...m ? { $defs: m } : {}
+        ...y ? { definitions: y } : {},
+        ...d ? { $defs: d } : {}
       },
       output: i.output,
       // Carry the ctx-param flag through to dispatch (BUG-APIGEN-001).
       ...i.hasCtx ? { hasCtx: !0 } : {},
-      "x-apigen-safe": T,
+      "x-apigen-safe": h,
       // 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
@@ -281,8 +310,8 @@ function _t(e, t, n) {
   }
   return o;
 }
-const Ve = 8;
-function qe(e, t) {
+const Xe = 8;
+function Ye(e, t) {
   try {
     return t ? e.getText(t) : e.getText();
   } catch {
@@ -293,12 +322,12 @@ function qe(e, t) {
     }
   }
 }
-let ze = 0;
-async function Ke(e, t, n, o) {
-  const r = `__ApigenProbe_${process.pid}_${ze++}`;
+let et = 0;
+async function tt(e, t, r, o) {
+  const n = `__ApigenProbe_${process.pid}_${et++}`;
   let i;
   try {
-    i = t.addTypeAlias({ name: r, type: n });
+    i = t.addTypeAlias({ name: n, type: r });
     const s = i.getType();
     return await o(s);
   } catch {
@@ -310,8 +339,8 @@ async function Ke(e, t, n, o) {
     }
   }
 }
-async function be(e, t, n) {
-  if (n > Ve)
+async function Fe(e, t, r) {
+  if (r > Xe)
     return {};
   if (e.isString() || e.isStringLiteral())
     return e.isStringLiteral() ? { type: "string", enum: [e.getLiteralValue()] } : { type: "string" };
@@ -336,12 +365,12 @@ async function be(e, t, n) {
         enum: o.map((c) => c.getLiteralValue())
       };
     const s = await Promise.all(
-      o.map((c) => be(c, t, n + 1))
-    ), a = D(s);
+      o.map((c) => Fe(c, t, r + 1))
+    ), a = Q(s);
     return {
       oneOf: s,
       ...a ? { discriminator: a } : {},
-      [K]: "union"
+      [Z]: "union"
     };
   }
   if (e.isArray()) {
@@ -349,80 +378,100 @@ async function be(e, t, n) {
     return { type: "array", items: o ? await t(o.getText()) : {} };
   }
   if (e.isTuple()) {
-    const o = e.getTupleElements(), r = await Promise.all(
+    const o = e.getTupleElements(), n = await Promise.all(
       o.map((i) => t(i.getText()))
     );
     return {
       type: "array",
-      items: r,
-      minItems: r.length,
-      maxItems: r.length
+      items: n,
+      minItems: n.length,
+      maxItems: n.length
     };
   }
   if (e.isObject()) {
-    const o = e.getStringIndexType(), r = e.getNumberIndexType(), i = o ?? r, s = e.getProperties();
+    const o = e.getStringIndexType(), n = e.getNumberIndexType(), i = o ?? n, s = e.getProperties();
     if (i && s.length === 0)
       return { type: "object", additionalProperties: await t(i.getText()) };
     const a = {}, c = [];
-    for (const l of s) {
-      const u = l.getName(), p = l.getDeclarations()[0];
-      let T;
-      if (p)
+    for (const u of s) {
+      const l = u.getName(), m = u.getDeclarations()[0];
+      let h;
+      if (m)
         try {
-          T = l.getTypeAtLocation(p);
+          h = u.getTypeAtLocation(m);
         } catch {
-          T = void 0;
+          h = void 0;
         }
-      if (T !== void 0 && T.getCallSignatures().length > 0)
+      if (h !== void 0 && h.getCallSignatures().length > 0)
         continue;
-      const d = T !== void 0 ? qe(T, p) : void 0;
-      a[u] = d !== void 0 ? await t(d) : {}, l.isOptional() || c.push(u);
+      const y = h !== void 0 ? Ye(h, m) : void 0;
+      a[l] = y !== void 0 ? await t(y) : {}, u.isOptional() || c.push(l);
     }
-    return Object.keys(a).length > 0 ? {
-      type: "object",
-      properties: a,
-      // Match ts-json-schema-generator's own convention: omit `required`
-      // entirely when no property is required, rather than emitting `[]`.
-      ...c.length > 0 ? { required: c } : {}
-    } : {};
+    if (Object.keys(a).length > 0) {
+      const u = i ? await t(i.getText()) : !1;
+      return {
+        type: "object",
+        properties: a,
+        // Match ts-json-schema-generator's own convention: omit `required`
+        // entirely when no property is required, rather than emitting `[]`.
+        ...c.length > 0 ? { required: c } : {},
+        // BUG-APIGEN-017 (nested case): mirror compose-schemas.ts's top-level
+        // additionalProperties:false so Ajv rejects unknown keys on THIS
+        // interface-derived nested object too, not only at the envelope/data
+        // wrapper. Without this, an unrecognized key nested inside a domain
+        // param object (e.g. a typo'd flag on a query-options interface)
+        // validates successfully and is then silently discarded by
+        // `decodeNode`'s object branch (runtime.ts) instead of erroring —
+        // confirmed as BUG-BACKLOG-QUERY-001's actual mechanism: `full`/
+        // `view`-shaped optional keys on a nested options object were
+        // accepted-and-ignored rather than rejected.
+        // Index-signature aware: an interface WITH a string/number index
+        // signature legitimately accepts extra keys, so closing it with a
+        // hardcoded `false` would reject valid input. `indexValue ? <resolved>
+        // : false` keeps the BUG-APIGEN-017 closure above as the default and
+        // only opens the schema where the TYPE itself declares it open.
+        additionalProperties: u
+      };
+    }
+    return {};
   }
   return {};
 }
-function D(e) {
+function Q(e) {
   if (e.length < 2)
     return;
   const t = [];
   for (const o of e) {
     if (o.type !== "object")
       return;
-    const r = o.properties;
-    if (!r || typeof r != "object")
+    const n = o.properties;
+    if (!n || typeof n != "object")
       return;
-    t.push(r);
+    t.push(n);
   }
-  const n = Object.keys(t[0]).filter(
-    (o) => t.every((r) => Object.prototype.hasOwnProperty.call(r, o))
+  const r = Object.keys(t[0]).filter(
+    (o) => t.every((n) => Object.prototype.hasOwnProperty.call(n, o))
   );
-  for (const o of n) {
-    const r = [];
+  for (const o of r) {
+    const n = [];
     let i = !0;
     for (const a of t) {
-      const c = a[o], l = c && (c.type === "string" || c.type === "number"), u = c == null ? void 0 : c.enum;
-      if (!l || !Array.isArray(u) || u.length !== 1) {
+      const c = a[o], u = c && (c.type === "string" || c.type === "number"), l = c == null ? void 0 : c.enum;
+      if (!u || !Array.isArray(l) || l.length !== 1) {
         i = !1;
         break;
       }
-      r.push(String(u[0]));
+      n.push(String(l[0]));
     }
-    if (!i || new Set(r).size !== r.length)
+    if (!i || new Set(n).size !== n.length)
       continue;
     const s = {};
-    return r.forEach((a, c) => {
+    return n.forEach((a, c) => {
       s[a] = `#/oneOf/${c}`;
     }), { propertyName: o, mapping: s };
   }
 }
-function q(e, t, n) {
+function H(e, t, r) {
   if (t > 6)
     return {};
   const o = e.trim();
@@ -436,13 +485,13 @@ function q(e, t, n) {
     return { type: "null" };
   if (o === "undefined")
     return { type: "null" };
-  const r = H[o];
-  if (r !== void 0)
-    return r;
-  if (n != null && n.size) {
-    const i = n.get(o);
+  const n = re[o];
+  if (n !== void 0)
+    return n;
+  if (r != null && r.size) {
+    const i = r.get(o);
     if (i !== void 0) {
-      const s = H[i];
+      const s = re[i];
       if (s !== void 0)
         return s;
     }
@@ -450,59 +499,59 @@ function q(e, t, n) {
   if (o.endsWith("[]"))
     return {
       type: "array",
-      items: q(o.slice(0, -2), t + 1, n)
+      items: H(o.slice(0, -2), t + 1, r)
     };
   if (o.includes("|")) {
     const i = o.split("|").map((c) => c.trim());
     if (i.every((c) => c.startsWith("'")))
       return { type: "string", enum: i.map((c) => c.replace(/'/g, "")) };
-    const s = i.map((c) => q(c, t + 1, n)), a = D(s);
+    const s = i.map((c) => H(c, t + 1, r)), a = Q(s);
     return {
       oneOf: s,
       ...a ? { discriminator: a } : {},
-      [K]: "union"
+      [Z]: "union"
     };
   }
   if (o.startsWith("{") && o.endsWith("}")) {
     const i = o.slice(1, -1).trim(), s = {};
     for (const a of i.split(";").filter(Boolean)) {
-      const [c, l] = a.split(":").map((u) => u.trim());
-      c && l && (s[c.replace("?", "")] = q(l, t + 1, n));
+      const [c, u] = a.split(":").map((l) => l.trim());
+      c && u && (s[c.replace("?", "")] = H(u, t + 1, r));
     }
     return { type: "object", properties: s };
   }
   return {};
 }
-function Se(e) {
+function Ce(e) {
   const t = [];
-  let n = 0, o = 0;
+  let r = 0, o = 0;
   for (let i = 0; i < e.length; i++) {
     const s = e[i];
-    s === "<" || s === "[" || s === "{" || s === "(" ? n++ : s === ">" || s === "]" || s === "}" || s === ")" ? n-- : s === "," && n === 0 && (t.push(e.slice(o, i).trim()), o = i + 1);
+    s === "<" || s === "[" || s === "{" || s === "(" ? r++ : s === ">" || s === "]" || s === "}" || s === ")" ? r-- : s === "," && r === 0 && (t.push(e.slice(o, i).trim()), o = i + 1);
   }
-  const r = e.slice(o).trim();
-  return r.length > 0 && t.push(r), t;
+  const n = e.slice(o).trim();
+  return n.length > 0 && t.push(n), t;
 }
-function De(e) {
+function nt(e) {
   const t = /^(?:Readonly)?Map<(.+)>$/.exec(e);
   return t ? t[1] : void 0;
 }
-function Be(e) {
+function rt(e) {
   const t = /^(?:Readonly)?Set<(.+)>$/.exec(e);
   return t ? t[1] : void 0;
 }
-function We(e) {
+function ot(e) {
   let t = e.trim();
   if (t.startsWith("readonly ") && (t = t.slice(9).trim()), !t.startsWith("[") || !t.endsWith("]"))
     return;
-  const n = t.slice(1, -1).trim();
-  if (n.length !== 0)
-    return Se(n);
+  const r = t.slice(1, -1).trim();
+  if (r.length !== 0)
+    return Ce(r);
 }
-async function Ue(e, t) {
-  const n = e.trim(), o = De(n);
+async function it(e, t) {
+  const r = e.trim(), o = nt(r);
   if (o !== void 0) {
-    const s = Se(o);
+    const s = Ce(o);
     if (s.length === 2) {
       const [a, c] = await Promise.all([
         t(s[0]),
@@ -519,10 +568,10 @@ async function Ue(e, t) {
       };
     }
   }
-  const r = Be(n);
-  if (r !== void 0)
-    return { type: "array", items: await t(r), uniqueItems: !0 };
-  const i = We(n);
+  const n = rt(r);
+  if (n !== void 0)
+    return { type: "array", items: await t(n), uniqueItems: !0 };
+  const i = ot(r);
   if (i !== void 0) {
     const s = await Promise.all(i.map((a) => t(a)));
     return {
@@ -533,9 +582,9 @@ async function Ue(e, t) {
     };
   }
 }
-const xe = {
+const Re = {
   "decimal.js": "Decimal"
-}, H = {
+}, re = {
   Date: { type: "string", format: "date-time" },
   bigint: { type: "string", format: "int64" },
   Uint8Array: { type: "string", format: "byte" },
@@ -543,16 +592,16 @@ const xe = {
   URL: { type: "string", format: "uri" },
   RegExp: { type: "string", format: "regex" },
   Decimal: { type: "string", format: "decimal" }
-}, ae = {
+}, Te = {
   Uint8Array: "byte",
   Buffer: "byte",
   Decimal: "decimal"
 };
-function ce(e) {
-  var n;
+function Se(e) {
+  var r;
   const t = /* @__PURE__ */ new Map();
   for (const o of e.getImportDeclarations()) {
-    const r = o.getModuleSpecifierValue(), i = xe[r];
+    const n = o.getModuleSpecifierValue(), i = Re[n];
     if (!i)
       continue;
     const s = o.getDefaultImport();
@@ -561,229 +610,234 @@ function ce(e) {
       a !== i && t.set(a, i);
     }
     for (const a of o.getNamedImports()) {
-      const c = ((n = a.getAliasNode()) == null ? void 0 : n.getText()) ?? a.getName();
+      const c = ((r = a.getAliasNode()) == null ? void 0 : r.getText()) ?? a.getName();
       c !== i && t.set(c, i);
     }
   }
   return t;
 }
-function Ge(e, t) {
-  return (n) => {
-    n.addNodeParser({
+function st(e, t) {
+  return (r) => {
+    r.addNodeParser({
       supportsNode(o) {
         var i, s, a;
         if (o.kind !== t)
           return !1;
-        const r = ((i = o.typeName) == null ? void 0 : i.escapedText) ?? ((a = (s = o.typeName) == null ? void 0 : s.right) == null ? void 0 : a.escapedText);
-        return r !== void 0 && Object.prototype.hasOwnProperty.call(ae, r);
+        const n = ((i = o.typeName) == null ? void 0 : i.escapedText) ?? ((a = (s = o.typeName) == null ? void 0 : s.right) == null ? void 0 : a.escapedText);
+        return n !== void 0 && Object.prototype.hasOwnProperty.call(Te, n);
       },
       createType(o) {
-        var i, s, a;
-        const r = ((i = o.typeName) == null ? void 0 : i.escapedText) ?? ((a = (s = o.typeName) == null ? void 0 : s.right) == null ? void 0 : a.escapedText);
-        return new ne(
-          new re(),
-          { format: ae[r] },
+        var a, c, u;
+        const n = ((a = o.typeName) == null ? void 0 : a.escapedText) ?? ((u = (c = o.typeName) == null ? void 0 : c.right) == null ? void 0 : u.escapedText), { AnnotatedType: i, StringType: s } = oe();
+        return new i(
+          new s(),
+          { format: Te[n] },
           !1
         );
       }
-    }), n.addNodeParser({
+    }), r.addNodeParser({
       supportsNode(o) {
         return o.kind === e;
       },
       createType() {
-        return new ne(new re(), { format: "int64" }, !1);
+        const { AnnotatedType: o, StringType: n } = oe();
+        return new o(new n(), { format: "int64" }, !1);
       }
     });
   };
 }
-let C;
-function Ze() {
-  if (C)
-    return C;
+let D;
+function oe() {
+  return D || (D = N("ts-json-schema-generator"), D);
+}
+let _;
+function at() {
+  if (_)
+    return _;
   try {
-    const e = Y.dirname(
-      require.resolve("ts-json-schema-generator/package.json")
+    const e = ce.dirname(
+      N.resolve("ts-json-schema-generator/package.json")
     );
-    C = require(require.resolve("typescript", {
+    _ = N(N.resolve("typescript", {
       paths: [e]
     }));
   } catch {
-    C = require("typescript");
+    _ = N("typescript");
   }
-  return C;
+  return _;
 }
-const k = /* @__PURE__ */ new Map();
-function He() {
+const I = /* @__PURE__ */ new Map();
+function ct() {
   const e = process.env.APIGEN_PROGRAM_CACHE, t = e === void 0 ? NaN : Number(e);
   return Number.isFinite(t) && t >= 0 ? t : 8;
 }
-function Qe(e) {
-  const t = k.get(e);
-  return t && (k.delete(e), k.set(e, t)), t;
+function ut(e) {
+  const t = I.get(e);
+  return t && (I.delete(e), I.set(e, t)), t;
 }
-function Je(e, t) {
-  const n = He();
-  if (n !== 0)
-    for (k.delete(e), k.set(e, t); k.size > n; ) {
-      const o = k.keys().next().value;
-      k.delete(o);
+function lt(e, t) {
+  const r = ct();
+  if (r !== 0)
+    for (I.delete(e), I.set(e, t); I.size > r; ) {
+      const o = I.keys().next().value;
+      I.delete(o);
     }
 }
-function Xe(e, t) {
+function ft(e, t) {
   return `${e}\0${t ?? ""}`;
 }
-const Ye = /* @__PURE__ */ new Set(["zod", /^zod\/./]);
-function et(e) {
+const pt = /* @__PURE__ */ new Set(["zod", /^zod\/./]);
+function mt(e) {
   for (const t of e.getImportDeclarations()) {
-    const n = t.getModuleSpecifierValue();
-    for (const o of Ye)
+    const r = t.getModuleSpecifierValue();
+    for (const o of pt)
       if (typeof o == "string") {
-        if (n === o)
+        if (r === o)
           return !0;
-      } else if (o.test(n))
+      } else if (o.test(r))
         return !0;
   }
   return !1;
 }
-function tt(e) {
+function dt(e) {
   for (const t of ["$defs", "definitions"]) {
-    const n = e[t];
-    if (!n || typeof n != "object")
+    const r = e[t];
+    if (!r || typeof r != "object")
       continue;
-    const o = Object.keys(n);
+    const o = Object.keys(r);
     if (o.length === 0)
       continue;
-    const r = new Set(o.filter((i) => /zod/i.test(i)));
-    for (const [i, s] of Object.entries(n)) {
-      if (r.has(i) || typeof s != "object" || s === null)
+    const n = new Set(o.filter((i) => /zod/i.test(i)));
+    for (const [i, s] of Object.entries(r)) {
+      if (n.has(i) || typeof s != "object" || s === null)
         continue;
       const a = s, c = typeof a.$ref == "string" ? a.$ref : "";
       if (c) {
-        for (const l of r)
-          if (c.includes(l)) {
-            r.add(i);
+        for (const u of n)
+          if (c.includes(u)) {
+            n.add(i);
             break;
           }
       }
     }
-    for (const i of r)
-      delete n[i];
+    for (const i of n)
+      delete r[i];
   }
-  Q(e);
+  ie(e);
 }
-function Q(e, t) {
+function ie(e, t) {
   if (!e || typeof e != "object")
     return;
-  const n = t ?? /* @__PURE__ */ new WeakSet();
-  if (!n.has(e)) {
-    n.add(e);
+  const r = t ?? /* @__PURE__ */ new WeakSet();
+  if (!r.has(e)) {
+    r.add(e);
     for (const o of Object.keys(e))
       if (o === "$ref" && typeof e[o] == "string") {
-        const r = e[o];
-        /zod/i.test(r) && delete e[o];
+        const n = e[o];
+        /zod/i.test(n) && delete e[o];
       }
     for (const [, o] of Object.entries(e))
       if (typeof o == "object" && o !== null)
         if (Array.isArray(o))
-          for (const r of o)
-            typeof r == "object" && r !== null && Q(r, n);
+          for (const n of o)
+            typeof n == "object" && n !== null && ie(n, r);
         else
-          Q(o, n);
+          ie(o, r);
   }
 }
-function nt(e) {
+function gt(e) {
   const t = /* @__PURE__ */ new Set();
   for (const o of ["$defs", "definitions"]) {
-    const r = e[o];
-    if (r && typeof r == "object")
-      for (const i of Object.keys(r))
+    const n = e[o];
+    if (n && typeof n == "object")
+      for (const i of Object.keys(n))
         t.add(i);
   }
-  const n = J(e, t);
-  if (n.length > 0)
+  const r = se(e, t);
+  if (r.length > 0)
     throw new Error(
-      `[apigen-core-client] Generated schema contains ${n.length} unresolvable $ref(s): ${n.join(", ")}. This usually means zod-internal definitions were stripped but $ref references to them remain. Check the source file's imports or the ts-json-schema-generator output.`
+      `[apigen-core-client] Generated schema contains ${r.length} unresolvable $ref(s): ${r.join(", ")}. This usually means zod-internal definitions were stripped but $ref references to them remain. Check the source file's imports or the ts-json-schema-generator output.`
     );
 }
-function J(e, t) {
+function se(e, t) {
   if (!e || typeof e != "object")
     return [];
-  const n = [];
-  for (const [o, r] of Object.entries(e))
-    if (o === "$ref" && typeof r == "string") {
-      const i = r.match(/#\/(?:\$defs|definitions)\/(.+)$/);
-      i && !t.has(i[1]) && n.push(r);
-    } else if (typeof r == "object" && r !== null)
-      if (Array.isArray(r))
-        for (const i of r)
-          typeof i == "object" && i !== null && n.push(
-            ...J(i, t)
+  const r = [];
+  for (const [o, n] of Object.entries(e))
+    if (o === "$ref" && typeof n == "string") {
+      const i = n.match(/#\/(?:\$defs|definitions)\/(.+)$/);
+      i && !t.has(i[1]) && r.push(n);
+    } else if (typeof n == "object" && n !== null)
+      if (Array.isArray(n))
+        for (const i of n)
+          typeof i == "object" && i !== null && r.push(
+            ...se(i, t)
           );
       else
-        n.push(
-          ...J(r, t)
+        r.push(
+          ...se(n, t)
         );
-  return n;
+  return r;
 }
-function rt(e) {
+function yt(e) {
   const t = e.anyOf;
   if (!Array.isArray(t) || t.length < 2)
     return e;
-  const n = t, o = D(n), r = { ...e };
-  return delete r.anyOf, {
-    ...r,
-    oneOf: n,
+  const r = t, o = Q(r), n = { ...e };
+  return delete n.anyOf, {
+    ...n,
+    oneOf: r,
     ...o ? { discriminator: o } : {},
-    [K]: r[K] ?? "union"
+    [Z]: n[Z] ?? "union"
   };
 }
-function ot(e, t, n) {
-  const { DEFAULT_CONFIG: o } = require("ts-json-schema-generator/dist/src/Config.js"), r = { ...o, ...e }, i = r.path, s = Xe(i, r.tsconfig);
+function ht(e, t, r) {
+  const { DEFAULT_CONFIG: o } = N("ts-json-schema-generator/dist/src/Config.js"), n = { ...o, ...e }, i = n.path, s = ft(i, n.tsconfig);
   let a;
-  a = n ? n.statVersion(i) : ye(i);
+  a = r ? r.statVersion(i) : ke(i);
   let c;
   if (s !== void 0) {
-    const u = (n == null ? void 0 : n.generatorCache.get(s)) ?? Qe(s);
-    u && u.version === a && (c = u.gen);
+    const l = (r == null ? void 0 : r.generatorCache.get(s)) ?? ut(s);
+    l && l.version === a && (c = l.gen);
   }
   if (!c) {
-    const { createProgram: u } = require("ts-json-schema-generator/dist/factory/program.js"), f = Ze(), p = Ge(
-      f.SyntaxKind.BigIntKeyword,
-      f.SyntaxKind.TypeReference
-    ), T = u(r), d = ke(
-      T,
-      r,
-      p
-    ), m = Ee(r);
-    if (c = new Ce(
-      T,
-      d,
-      m,
-      r
-    ), n && n.stats.generatorsBuilt++, s !== void 0 && a !== void 0) {
-      const b = { version: a, gen: c };
-      Je(s, b), n == null || n.generatorCache.set(s, b);
+    const { createProgram: l } = N("ts-json-schema-generator/dist/factory/program.js"), { createParser: f, createFormatter: m, SchemaGenerator: h } = oe(), y = at(), d = st(
+      y.SyntaxKind.BigIntKeyword,
+      y.SyntaxKind.TypeReference
+    ), g = l(n), x = f(
+      g,
+      n,
+      d
+    ), p = m(n);
+    if (c = new h(
+      g,
+      x,
+      p,
+      n
+    ), r && r.stats.generatorsBuilt++, s !== void 0 && a !== void 0) {
+      const T = { version: a, gen: c };
+      lt(s, T), r == null || r.generatorCache.set(s, T);
     }
   }
-  const l = c.createSchema(r.type);
-  return tt(l), nt(l), l;
-}
-function it(e, t) {
-  let n = e.trim();
-  if (n = we(n), t != null && t.size) {
-    const r = t.get(n);
-    if (r !== void 0)
-      return r;
+  const u = c.createSchema(n.type);
+  return dt(u), gt(u), u;
+}
+function Tt(e, t) {
+  let r = e.trim();
+  if (r = Le(r), t != null && t.size) {
+    const n = t.get(r);
+    if (n !== void 0)
+      return n;
   }
-  const o = n.match(/^ReadonlyArray<(.+)>$/);
-  for (o && (n = `${o[1].trim()}[]`); n.startsWith("readonly "); )
-    n = n.slice(9).trim();
-  return n;
+  const o = r.match(/^ReadonlyArray<(.+)>$/);
+  for (o && (r = `${o[1].trim()}[]`); r.startsWith("readonly "); )
+    r = r.slice(9).trim();
+  return r;
 }
-function ve(e) {
+function _e(e) {
   return e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-const st = Object.entries(xe).map(([e, t]) => ({
+const St = Object.entries(Re).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
@@ -791,88 +845,88 @@ const st = Object.entries(xe).map(([e, t]) => ({
   // …) is matched generically (`\w+`) rather than anchored to one spelling —
   // see the doc comment above for why.
   pattern: new RegExp(
-    `import\\(["'][^"']*${ve(e)}[^"']*["']\\)\\.\\w+`,
+    `import\\(["'][^"']*${_e(e)}[^"']*["']\\)\\.\\w+`,
     "g"
   ),
   key: t
 }));
-function we(e) {
+function Le(e) {
   let t = e;
-  for (const { pattern: n, key: o } of st)
-    t = t.replace(n, o);
+  for (const { pattern: r, key: o } of St)
+    t = t.replace(r, o);
   return t;
 }
-function at(e, t) {
-  let n = we(e);
-  for (const [o, r] of t)
-    n = n.replace(
-      new RegExp(`\\b${ve(o)}\\b`, "g"),
-      r
+function bt(e, t) {
+  let r = Le(e);
+  for (const [o, n] of t)
+    r = r.replace(
+      new RegExp(`\\b${_e(o)}\\b`, "g"),
+      n
     );
-  return n;
+  return r;
 }
-async function A(e, t, n, o, r, i) {
-  const s = t.getFilePath(), a = `${s}\0${o ?? ""}\0${n}`, c = i ?? /* @__PURE__ */ new Set();
+async function O(e, t, r, o, n, i) {
+  const s = t.getFilePath(), a = `${s}\0${o ?? ""}\0${r}`, c = i ?? /* @__PURE__ */ new Set();
   if (c.has(a))
     return {};
-  if (!r) {
-    const d = new Set(c);
-    return d.add(a), ue(
+  if (!n) {
+    const y = new Set(c);
+    return y.add(a), be(
       e,
       t,
-      n,
+      r,
       o,
       void 0,
-      d
+      y
     );
   }
-  const l = r.schemaCache.get(a);
-  if (l !== void 0)
-    return r.stats.schemaCacheHits++, l;
-  const u = Fe(
+  const u = n.schemaCache.get(a);
+  if (u !== void 0)
+    return n.stats.schemaCacheHits++, u;
+  const l = Ue(
     s,
     o,
-    r.statVersion(s)
-  ), f = u.get(n);
+    n.statVersion(s)
+  ), f = l.get(r);
   if (f !== void 0)
-    return r.stats.schemaCacheHits++, r.schemaCache.set(a, Promise.resolve(f)), f;
-  r.stats.schemaCacheMisses++;
-  const p = new Set(c);
-  p.add(a);
-  const T = ue(
+    return n.stats.schemaCacheHits++, n.schemaCache.set(a, Promise.resolve(f)), f;
+  n.stats.schemaCacheMisses++;
+  const m = new Set(c);
+  m.add(a);
+  const h = be(
     e,
     t,
-    n,
-    o,
     r,
-    p
-  ).then((d) => (u.set(n, d), d)).catch((d) => {
-    throw r.schemaCache.delete(a), d;
+    o,
+    n,
+    m
+  ).then((y) => (l.set(r, y), y)).catch((y) => {
+    throw n.schemaCache.delete(a), y;
   });
-  return r.schemaCache.set(a, T), T;
+  return n.schemaCache.set(a, h), h;
 }
-async function ue(e, t, n, o, r, i) {
-  if (["void", "undefined", "null", "Promise<void>"].includes(n))
+async function be(e, t, r, o, n, i) {
+  if (["void", "undefined", "null", "Promise<void>"].includes(r))
     return { type: "null" };
   let s;
-  if (r) {
-    const p = r.aliasCache.get(t);
-    s = p ?? ce(t), p || r.aliasCache.set(t, s);
+  if (n) {
+    const m = n.aliasCache.get(t);
+    s = m ?? Se(t), m || n.aliasCache.set(t, s);
   } else
-    s = ce(t);
-  const a = it(n, s), c = H[a];
+    s = Se(t);
+  const a = Tt(r, s), c = re[a];
   if (c !== void 0)
     return c;
-  const l = await Ue(
+  const u = await it(
     a,
-    (p) => A(e, t, p, o, r, i)
+    (m) => O(e, t, m, o, n, i)
   );
-  if (l !== void 0)
-    return l;
-  const u = (r == null ? void 0 : r.zodImportCache.get(t)) ?? et(t);
-  if (r && r.zodImportCache.set(t, u), !u)
+  if (u !== void 0)
+    return u;
+  const l = (n == null ? void 0 : n.zodImportCache.get(t)) ?? mt(t);
+  if (n && n.zodImportCache.set(t, l), !l)
     try {
-      const p = {
+      const m = {
         path: t.getFilePath(),
         type: a,
         skipTypeCheck: !0,
@@ -899,52 +953,52 @@ async function ue(e, t, n, o, r, i) {
         // dereference/hoist pass and is tracked separately, unresolved, in
         // BUG-APIGEN-026's BACKLOG entry.
         topRef: !1
-      }, T = ot(p, !0, r);
-      return rt(T);
+      }, h = ht(m, !0, n);
+      return yt(h);
     } catch {
     }
   try {
-    const p = await Ke(
+    const m = await tt(
       e,
       t,
       a,
-      (T) => be(
-        T,
-        (d) => A(e, t, d, o, r, i),
+      (h) => Fe(
+        h,
+        (y) => O(e, t, y, o, n, i),
         0
       )
     );
-    if (p !== void 0)
-      return p;
+    if (m !== void 0)
+      return m;
   } catch {
   }
-  const f = at(a, s);
-  return q(f, 0, s);
+  const f = bt(a, s);
+  return H(f, 0, s);
 }
-function ee(e, t, n) {
+function le(e, t, r) {
   if (e != null && e.hasInitializer()) {
     const o = e.getInitializer();
     if (o)
       return o.getText();
   }
-  return ct(n, t);
+  return vt(r, t);
 }
-function ct(e, t) {
+function vt(e, t) {
   var s;
-  const n = e, o = ((s = n == null ? void 0 : n.getJsDocs) == null ? void 0 : s.call(n)) ?? [], r = t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), i = new RegExp(`\\[\\s*${r}\\s*=\\s*([^\\]]+)\\]`);
+  const r = e, o = ((s = r == null ? void 0 : r.getJsDocs) == null ? void 0 : s.call(r)) ?? [], n = t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), i = new RegExp(`\\[\\s*${n}\\s*=\\s*([^\\]]+)\\]`);
   for (const a of o)
     for (const c of a.getTags()) {
       if (c.getTagName() !== "param")
         continue;
-      const l = c.getText().match(i);
-      if (l)
-        return l[1].trim();
+      const u = c.getText().match(i);
+      if (u)
+        return u[1].trim();
     }
 }
-function ut(e) {
-  const t = e.trim(), n = t.match(/^(['"`])([\s\S]*)\1$/);
-  if (n)
-    return n[2];
+function xt(e) {
+  const t = e.trim(), r = t.match(/^(['"`])([\s\S]*)\1$/);
+  if (r)
+    return r[2];
   if (t === "true")
     return !0;
   if (t === "false")
@@ -961,302 +1015,420 @@ function ut(e) {
     }
   }
 }
-function lt(e, t) {
-  const n = ut(t);
-  if (n === void 0)
+function wt(e, t) {
+  const r = xt(t);
+  if (r === void 0)
     return;
-  e.default = n;
-  const o = typeof n == "string" ? n : JSON.stringify(n), r = typeof e.description == "string" ? e.description : void 0;
-  e.description = r ? `${r} (default: ${o})` : `(default: ${o})`;
+  e.default = r;
+  const o = typeof r == "string" ? r : JSON.stringify(r), n = typeof e.description == "string" ? e.description : void 0;
+  e.description = n ? `${n} (default: ${o})` : `(default: ${o})`;
+}
+let q;
+function jt() {
+  return q || (q = N("ts-morph").SyntaxKind, q);
 }
-async function Lt(e) {
-  const t = e.session === void 0, n = Te(e.session ?? he());
+function X(e) {
   try {
-    return await ft(e, n);
+    if (!e)
+      return;
+    const t = jt();
+    if (e.getKind() !== t.TypeReference)
+      return;
+    const r = e;
+    if (r.getTypeArguments().length > 0)
+      return;
+    const o = r.getTypeName();
+    if (o.getKind() !== t.Identifier)
+      return;
+    const i = o.getSymbol();
+    if (!i)
+      return;
+    const s = i.getDeclarations().find((f) => f.getKindName() === "TypeAliasDeclaration");
+    if (!s)
+      return;
+    const a = s, c = a.getType();
+    if (!(c.isString() || c.isNumber() || c.isBoolean()))
+      return;
+    const l = a.getJsDocs();
+    for (const f of l)
+      for (const m of f.getTags())
+        if (m.getTagName() === "format") {
+          const h = m.getCommentText();
+          if (h !== void 0)
+            return h.trim();
+        }
+    return;
+  } catch {
+    return;
+  }
+}
+const At = /* @__PURE__ */ new Set([
+  "AsyncGenerator",
+  "AsyncIterableIterator",
+  "AsyncIterable",
+  "Generator",
+  "IterableIterator",
+  "Iterable",
+  // Project-specific: `@adhd/apigen-engine-runtime`'s `ApiStream<T>` — a type
+  // alias for `AsyncIterable<T>` (see that package's `stream.ts`). Aliases
+  // used directly (not structurally decomposed) are NOT expanded by
+  // `getText()`, so this wrapper never surfaces as `AsyncIterable<T>` and
+  // must be recognized by its own name.
+  "ApiStream"
+]);
+function $t(e) {
+  const t = [];
+  let r = 0, o = "";
+  for (const n of e)
+    n === "<" || n === "(" || n === "[" || n === "{" ? r++ : (n === ">" || n === ")" || n === "]" || n === "}") && r--, n === "," && r === 0 ? (t.push(o.trim()), o = "") : o += n;
+  return o.trim().length > 0 && t.push(o.trim()), t;
+}
+function fe(e) {
+  const t = e.trim(), r = t.indexOf("<");
+  if (r === -1 || !t.endsWith(">"))
+    return null;
+  const o = t.slice(0, r), n = o.includes(".") ? o.slice(o.lastIndexOf(".") + 1) : o;
+  if (!At.has(n))
+    return null;
+  let i = 0;
+  for (let c = r; c < t.length; c++) {
+    const u = t[c];
+    if (u === "<")
+      i++;
+    else if (u === ">" && (i--, i === 0 && c !== t.length - 1))
+      return null;
+  }
+  if (i !== 0)
+    return null;
+  const s = t.slice(r + 1, -1), a = $t(s);
+  return a.length > 0 ? a[0] : null;
+}
+async function tn(e) {
+  const t = e.session === void 0, r = Ie(e.session ?? Ee());
+  try {
+    return await Pt(e, r);
   } finally {
-    t && n.dispose();
+    t && r.dispose();
   }
 }
-async function ft(e, t) {
+async function Pt(e, t) {
   const {
-    sourceFile: n,
+    sourceFile: r,
     namespace: o = "",
-    dropFileSegment: r = !1,
+    dropFileSegment: n = !1,
     tsconfig: i
-  } = e, s = t.projectFor(i), a = t.sourceFileFor(n, i), c = Y.basename(n), l = N(gt(c)), u = r ? null : l, f = N(o), p = [];
-  for (const [m, b] of a.getExportedDeclarations()) {
-    if (m === "default" || V(m))
+  } = e, s = t.projectFor(i), a = t.sourceFileFor(r, i), c = ce.basename(r), u = k(Ot(c)), l = n ? null : u, f = k(o), m = [];
+  for (const [d, g] of a.getExportedDeclarations()) {
+    if (d === "default" || W(d))
       continue;
-    const y = yt(b);
-    if (y) {
-      const S = y.getSignature(), v = le(S, y), w = S.getReturnType().getText();
-      p.push(
-        await M(
+    const x = Et(g);
+    if (x) {
+      const S = x.getSignature(), j = we(S, x), b = S.getReturnType().getText(), A = C(S);
+      m.push(
+        await B(
           s,
           a,
           f,
-          u,
-          m,
-          v,
-          w,
-          y.isAsync(),
+          l,
+          d,
+          j,
+          b,
+          x.isAsync(),
           i,
-          t
+          t,
+          A
         )
       );
       continue;
     }
-    const h = b.find(
+    const p = g.find(
       (S) => S.getKindName() === "VariableDeclaration"
     );
-    if (!h)
+    if (!p)
       continue;
-    const g = h.getInitializer(), x = g == null ? void 0 : g.getKindName();
-    if (g && ["ArrowFunction", "FunctionExpression"].includes(x ?? "")) {
-      const v = h.getType().getCallSignatures();
-      if (v.length === 0)
+    const T = p.getInitializer(), w = T == null ? void 0 : T.getKindName();
+    if (T && ["ArrowFunction", "FunctionExpression"].includes(w ?? "")) {
+      const j = p.getType().getCallSignatures();
+      if (j.length === 0)
         continue;
-      const w = v[0], $ = fe(
-        w,
-        h,
-        h.getVariableStatement()
-      ), j = w.getReturnType().getText(), P = g.isAsync();
-      p.push(
-        await M(
+      const b = j[0], A = je(
+        b,
+        p,
+        p.getVariableStatement()
+      ), $ = b.getReturnType().getText(), v = C(b), P = T.isAsync();
+      m.push(
+        await B(
           s,
           a,
           f,
-          u,
-          m,
+          l,
+          d,
+          A,
           $,
-          j,
           P,
           i,
-          t
+          t,
+          v
         )
       );
-    } else if (x === "ObjectLiteralExpression") {
-      const S = h.getType();
-      for (const v of S.getProperties()) {
-        const w = v.getName();
-        if (V(w))
+    } else if (w === "ObjectLiteralExpression") {
+      const S = p.getType();
+      for (const j of S.getProperties()) {
+        const b = j.getName();
+        if (W(b))
           continue;
-        const j = v.getTypeAtLocation(h).getCallSignatures();
-        if (j.length === 0)
+        const $ = j.getTypeAtLocation(p).getCallSignatures();
+        if ($.length === 0)
           continue;
-        const P = j[0], B = fe(
-          P,
-          h,
-          h.getVariableStatement()
-        ), R = P.getReturnType().getText(), _ = [
-          ...u ? [u] : [],
-          N(m),
-          N(w)
+        const v = $[0], P = je(
+          v,
+          p,
+          p.getVariableStatement()
+        ), F = v.getReturnType().getText(), K = C(v), V = [
+          ...l ? [l] : [],
+          k(d),
+          k(b)
         ];
-        p.push(
-          await z(
+        m.push(
+          await J(
             s,
             a,
             f,
-            _,
-            w,
-            B,
-            R,
+            V,
+            b,
+            P,
+            F,
             !1,
             i,
-            t
+            t,
+            K
           )
         );
       }
     } else {
-      const S = h.getType(), v = S.getText();
-      if (E(S, h)) {
-        const w = await A(
+      const S = p.getType(), j = S.getText();
+      if (R(S, p)) {
+        const b = await O(
           s,
           a,
-          v,
+          j,
           i,
           t
         );
-        p.push(
-          mt(f, u, m, w)
+        m.push(
+          Nt(f, l, d, b)
         );
       } else
         console.warn(
-          `[apigen-core] Skipping non-callable, non-serializable export: ${m}`
+          `[apigen-core] Skipping non-callable, non-serializable export: ${d}`
         );
     }
   }
-  const T = a.getDefaultExportSymbol();
-  if (T) {
-    const m = a.getExportAssignment((b) => !b.isExportEquals());
-    if (m) {
-      const b = m.getExpression(), y = b.getKindName();
-      if (["ArrowFunction", "FunctionExpression"].includes(y)) {
-        const g = b.getType().getCallSignatures();
-        if (g.length > 0) {
-          const x = g[0], S = W(x, m), v = x.getReturnType().getText(), w = b.isAsync();
-          p.push(
-            await M(
+  const h = a.getDefaultExportSymbol();
+  if (h) {
+    const d = a.getExportAssignment((g) => !g.isExportEquals());
+    if (d) {
+      const g = d.getExpression(), x = g.getKindName();
+      if (["ArrowFunction", "FunctionExpression"].includes(x)) {
+        const T = g.getType().getCallSignatures();
+        if (T.length > 0) {
+          const w = T[0], S = Y(w, d), j = w.getReturnType().getText(), b = C(w), A = g.isAsync();
+          m.push(
+            await B(
               s,
               a,
               f,
-              u,
+              l,
               "default",
               S,
-              v,
-              w,
+              j,
+              A,
               i,
-              t
+              t,
+              b
             )
           );
         }
       } else {
-        const h = b.getType();
-        for (const g of h.getProperties()) {
-          const x = g.getName();
-          if (V(x))
+        const p = g.getType();
+        for (const T of p.getProperties()) {
+          const w = T.getName();
+          if (W(w))
             continue;
-          const v = g.getTypeAtLocation(m).getCallSignatures();
-          if (v.length === 0)
+          const j = T.getTypeAtLocation(d).getCallSignatures();
+          if (j.length === 0)
             continue;
-          const w = v[0], $ = W(w, m), j = w.getReturnType().getText(), P = [
-            ...u ? [u] : [],
-            N("default"),
-            N(x)
+          const b = j[0], A = Y(b, d), $ = b.getReturnType().getText(), v = C(b), P = [
+            ...l ? [l] : [],
+            k("default"),
+            k(w)
           ];
-          p.push(
-            await z(
+          m.push(
+            await J(
               s,
               a,
               f,
               P,
-              x,
+              w,
+              A,
               $,
-              j,
               !1,
               i,
-              t
+              t,
+              v
             )
           );
         }
       }
     } else {
-      const b = T.getDeclarations();
-      for (const y of b) {
-        if (y.getKindName() !== "FunctionDeclaration")
+      const g = h.getDeclarations();
+      for (const x of g) {
+        if (x.getKindName() !== "FunctionDeclaration")
           continue;
-        const h = y, g = h.getName(), x = g && g.length > 0 ? g : "default", S = h.getSignature(), v = le(S, h), w = S.getReturnType().getText();
-        p.push(
-          await M(
+        const p = x, T = p.getName(), w = T && T.length > 0 ? T : "default", S = p.getSignature(), j = we(S, p), b = S.getReturnType().getText(), A = C(S);
+        m.push(
+          await B(
             s,
             a,
             f,
-            u,
-            x,
-            v,
+            l,
             w,
-            h.isAsync(),
+            j,
+            b,
+            p.isAsync(),
             i,
-            t
+            t,
+            A
           )
         );
       }
     }
   }
-  const d = dt(a);
-  if (d.length > 0)
-    for (const { name: m, sig: b } of d) {
-      if (V(m))
+  const y = kt(a);
+  if (y.length > 0)
+    for (const { name: d, sig: g } of y) {
+      if (W(d))
         continue;
-      const y = W(b), h = b.getReturnType().getText(), g = [
-        ...u ? [u] : [],
-        N(m)
+      const x = Y(g), p = g.getReturnType().getText(), T = C(g), w = [
+        ...l ? [l] : [],
+        k(d)
       ];
-      p.push(
-        await z(
+      m.push(
+        await J(
           s,
           a,
           f,
-          g,
-          m,
-          y,
-          h,
+          w,
+          d,
+          x,
+          p,
           !1,
           i,
-          t
+          t,
+          T
         )
       );
     }
-  return p;
+  return m;
 }
-function pt(e, t, n, o) {
-  const r = /* @__PURE__ */ new Set(), i = (s) => {
+function ve(e, t, r, o) {
+  const n = /* @__PURE__ */ new Set(), i = (s) => {
     if (Array.isArray(s))
       return s.map(i);
-    if (!s || typeof s != "object" || r.has(s))
+    if (!s || typeof s != "object" || n.has(s))
       return s;
-    r.add(s);
+    n.add(s);
     try {
       const a = s, c = {};
-      for (const [l, u] of Object.entries(a)) {
-        if (l === "definitions" || l === "$defs") {
-          const f = l, p = t[f];
-          for (const [T, d] of Object.entries(
-            u
+      for (const [u, l] of Object.entries(a)) {
+        if (u === "definitions" || u === "$defs") {
+          const f = u, m = t[f];
+          for (const [h, y] of Object.entries(
+            l
           )) {
-            const m = i(d), b = p[T];
-            if (b !== void 0 && JSON.stringify(b) !== JSON.stringify(m))
+            const d = i(y), g = m[h];
+            if (g !== void 0 && JSON.stringify(g) !== JSON.stringify(d))
               throw new Error(
-                `[apigen-core-client] Function "${n}": param "${o}" contributes a "${f}.${T}" definition that conflicts with an identically-named definition already hoisted from another param/output in the same function. Two structurally different types share the same generated definition key, so apigen cannot safely merge them into one function-level schema.`
+                `[apigen-core-client] Function "${r}": param "${o}" contributes a "${f}.${h}" definition that conflicts with an identically-named definition already hoisted from another param/output in the same function. Two structurally different types share the same generated definition key, so apigen cannot safely merge them into one function-level schema.`
               );
-            p[T] = m;
+            m[h] = d;
           }
           continue;
         }
-        c[l] = i(u);
+        c[u] = i(l);
       }
       return c;
     } finally {
-      r.delete(s);
+      n.delete(s);
     }
   };
   return i(e);
 }
-async function M(e, t, n, o, r, i, s, a, c, l) {
-  const u = N(r);
-  return z(
+function xe(e, t) {
+  if (!t || e.format !== void 0 || "$ref" in e || "properties" in e || "items" in e)
+    return;
+  const r = e.type;
+  (r === "string" || r === "number" || r === "integer" || r === "boolean") && (e.format = t);
+}
+function C(e) {
+  var t;
+  try {
+    return X((t = e.getDeclaration()) == null ? void 0 : t.getReturnTypeNode());
+  } catch {
+    return;
+  }
+}
+async function B(e, t, r, o, n, i, s, a, c, u, l) {
+  const f = k(n);
+  return J(
     e,
     t,
-    n,
-    o ? [o, u] : [u],
     r,
+    o ? [o, f] : [f],
+    n,
     i,
     s,
     a,
     c,
+    u,
     l
   );
 }
-async function z(e, t, n, o, r, i, s, a, c, l) {
-  const u = i.length > 0 && i[0].name === "ctx", f = i.filter((g) => g.name !== "ctx"), p = f.filter((g) => !g.optional).map((g) => g.name), T = {}, d = {
+async function J(e, t, r, o, n, i, s, a, c, u, l) {
+  const f = i.length > 0 && i[0].name === "ctx", m = i.filter((v) => v.name !== "ctx"), h = m.filter((v) => !v.optional).map((v) => v.name), y = {}, d = {
     definitions: {},
     $defs: {}
   };
-  for (const g of f) {
-    const x = await A(e, t, g.type, c, l), S = pt(x, d, r, g.name);
-    g.defaultValue !== void 0 && lt(S, g.defaultValue), T[g.name] = S;
+  for (const v of m) {
+    const P = await O(e, t, v.type, c, u), F = ve(P, d, n, v.name);
+    v.defaultValue !== void 0 && wt(F, v.defaultValue), xe(F, v.format), y[v.name] = F;
   }
-  const m = s.replace(/^Promise<(.+)>$/, "$1").trim(), b = await A(
+  const g = s.replace(/^Promise<(.+)>$/, "$1").trim(), x = fe(g), p = x !== null, T = p ? x : g, w = await O(
     e,
     t,
-    m,
+    T,
     c,
-    l
-  ), y = {
+    u
+  ), S = {
+    definitions: {},
+    $defs: {}
+  }, j = ve(
+    w,
+    S,
+    n,
+    "<return>"
+  ), b = l ? { ...j } : j;
+  xe(b, l), Object.keys(S.definitions).length > 0 && (b.definitions = {
+    ...b.definitions,
+    ...S.definitions
+  }), Object.keys(S.$defs).length > 0 && (b.$defs = {
+    ...b.$defs,
+    ...S.$defs
+  });
+  const A = {
     type: "object",
-    properties: T,
-    required: p,
+    properties: y,
+    required: h,
     // BUG-APIGEN-029: hoisted definitions from param fragments — see
     // hoistNestedDefs. Only attached when non-empty so the common
     // (no-recursive-type) case's schema shape is unchanged.
@@ -1264,30 +1436,30 @@ async function z(e, t, n, o, r, i, s, a, c, l) {
     ...Object.keys(d.$defs).length > 0 ? { $defs: d.$defs } : {}
   };
   return {
-    id: je(n, o),
+    id: Me(r, o),
     host: "ts",
-    namespace: n,
+    namespace: r,
     path: o,
     kind: "action",
     async: a,
-    streaming: !1,
+    streaming: p,
     safe: !1,
     // action → false per §4
-    input: y,
+    input: A,
     output: b,
     envelope: {},
     typeText: {
       lang: "ts",
-      input: ht(i),
-      output: m
+      input: It(i),
+      output: T
     },
-    ...u ? { hasCtx: !0 } : {}
+    ...f ? { hasCtx: !0 } : {}
   };
 }
-function mt(e, t, n, o) {
-  const r = N(n), i = t ? [t, r] : [r];
+function Nt(e, t, r, o) {
+  const n = k(r), i = t ? [t, n] : [n];
   return {
-    id: je(e, i),
+    id: Me(e, i),
     host: "ts",
     namespace: e,
     path: i,
@@ -1302,10 +1474,10 @@ function mt(e, t, n, o) {
     typeText: null
   };
 }
-function je(e, t) {
+function Me(e, t) {
   return (e.raw ? [e, ...t] : t).map((o) => o.words.join("-")).join("/");
 }
-function $e(e) {
+function Ke(e) {
   return e.split(/[-_.]+/).flatMap(
     (t) => (
       // Then split PascalCase / camelCase transitions
@@ -1313,196 +1485,220 @@ function $e(e) {
     )
   ).map((t) => t.toLowerCase()).filter(Boolean);
 }
-function N(e) {
-  return { raw: e, words: $e(e) };
+function k(e) {
+  return { raw: e, words: Ke(e) };
 }
-function gt(e) {
+function Ot(e) {
   return e.replace(/\.[^.]+$/, "").replace(/[._]+/g, "-");
 }
-function dt(e) {
+function kt(e) {
   const t = [];
-  for (const n of e.getStatements()) {
-    if (n.getKindName() !== "ExpressionStatement")
+  for (const r of e.getStatements()) {
+    if (r.getKindName() !== "ExpressionStatement")
       continue;
-    const o = n.getExpression();
+    const o = r.getExpression();
     if (o.getKindName() !== "BinaryExpression")
       continue;
-    const r = o;
-    if (r.getLeft().getText().trim() !== "module.exports" || r.getOperatorToken().getKindName() !== "EqualsToken")
+    const n = o;
+    if (n.getLeft().getText().trim() !== "module.exports" || n.getOperatorToken().getKindName() !== "EqualsToken")
       continue;
-    const s = r.getRight(), a = s.getType();
+    const s = n.getRight(), a = s.getType();
     for (const c of a.getProperties()) {
-      const u = c.getTypeAtLocation(s).getCallSignatures();
-      u.length !== 0 && t.push({ name: c.getName(), sig: u[0] });
+      const l = c.getTypeAtLocation(s).getCallSignatures();
+      l.length !== 0 && t.push({ name: c.getName(), sig: l[0] });
     }
   }
   return t;
 }
-function yt(e) {
+function Et(e) {
   let t;
-  for (const n of e) {
-    if (n.getKindName() !== "FunctionDeclaration")
+  for (const r of e) {
+    if (r.getKindName() !== "FunctionDeclaration")
       continue;
-    const o = n;
+    const o = r;
     if (t || (t = o), o.getBody())
       return o;
   }
   return t;
 }
-function le(e, t) {
-  return e.getParameters().map((n) => {
+function we(e, t) {
+  return e.getParameters().map((r) => {
     var s;
-    const o = n.getDeclarations(), r = o.length > 0 && o[0].getKindName() === "Parameter" ? o[0] : null, i = n.isOptional() || ((r == null ? void 0 : r.hasInitializer()) ?? !1) || (((s = r == null ? void 0 : r.hasQuestionToken) == null ? void 0 : s.call(r)) ?? !1);
+    const o = r.getDeclarations(), n = o.length > 0 && o[0].getKindName() === "Parameter" ? o[0] : null, i = r.isOptional() || ((n == null ? void 0 : n.hasInitializer()) ?? !1) || (((s = n == null ? void 0 : n.hasQuestionToken) == null ? void 0 : s.call(n)) ?? !1);
     return {
-      name: n.getName(),
-      type: n.getTypeAtLocation(e.getDeclaration()).getText(),
+      name: r.getName(),
+      type: r.getTypeAtLocation(e.getDeclaration()).getText(),
       optional: i,
-      defaultValue: ee(r, n.getName(), t)
+      defaultValue: le(n, r.getName(), t),
+      format: X(n == null ? void 0 : n.getTypeNode())
     };
   });
 }
-function fe(e, t, n) {
+function je(e, t, r) {
   return e.getParameters().map((o) => {
     var a;
-    const r = o.getDeclarations(), i = r.length > 0 && r[0].getKindName() === "Parameter" ? r[0] : null, s = o.isOptional() || ((i == null ? void 0 : i.hasInitializer()) ?? !1) || (((a = i == null ? void 0 : i.hasQuestionToken) == null ? void 0 : a.call(i)) ?? !1);
+    const n = o.getDeclarations(), i = n.length > 0 && n[0].getKindName() === "Parameter" ? n[0] : null, s = o.isOptional() || ((i == null ? void 0 : i.hasInitializer()) ?? !1) || (((a = i == null ? void 0 : i.hasQuestionToken) == null ? void 0 : a.call(i)) ?? !1);
     return {
       name: o.getName(),
       type: o.getTypeAtLocation(t).getText(),
       optional: s,
-      defaultValue: ee(
+      defaultValue: le(
         i,
         o.getName(),
-        n ?? t
-      )
+        r ?? t
+      ),
+      format: X(i == null ? void 0 : i.getTypeNode())
     };
   });
 }
-function W(e, t) {
-  return e.getParameters().map((n) => {
+function Y(e, t) {
+  return e.getParameters().map((r) => {
     var s, a, c;
-    const o = n.getDeclarations(), r = o.length > 0 && o[0].getKindName() === "Parameter" ? o[0] : null, i = n.isOptional() || ((r == null ? void 0 : r.hasInitializer()) ?? !1) || (((s = r == null ? void 0 : r.hasQuestionToken) == null ? void 0 : s.call(r)) ?? !1);
+    const o = r.getDeclarations(), n = o.length > 0 && o[0].getKindName() === "Parameter" ? o[0] : null, i = r.isOptional() || ((n == null ? void 0 : n.hasInitializer()) ?? !1) || (((s = n == null ? void 0 : n.hasQuestionToken) == null ? void 0 : s.call(n)) ?? !1);
     return {
-      name: n.getName(),
-      type: r ? r.getType().getText() : ((c = (a = n.getValueDeclaration()) == null ? void 0 : a.getType()) == null ? void 0 : c.getText()) ?? "unknown",
+      name: r.getName(),
+      type: n ? n.getType().getText() : ((c = (a = r.getValueDeclaration()) == null ? void 0 : a.getType()) == null ? void 0 : c.getText()) ?? "unknown",
       optional: i,
-      defaultValue: ee(r, n.getName(), t)
+      defaultValue: le(n, r.getName(), t),
+      format: X(n == null ? void 0 : n.getTypeNode())
     };
   });
 }
-function ht(e) {
-  const t = e.filter((n) => n.name !== "ctx");
-  return t.length === 0 ? "()" : "(" + t.map((n) => `${n.name}${n.optional ? "?" : ""}: ${n.type}`).join(", ") + ")";
+function It(e) {
+  const t = e.filter((r) => r.name !== "ctx");
+  return t.length === 0 ? "()" : "(" + t.map((r) => `${r.name}${r.optional ? "?" : ""}: ${r.type}`).join(", ") + ")";
 }
-function V(e) {
+function W(e) {
   return !!(e === "__samples__" || e.startsWith("__"));
 }
-function E(e, t, n = /* @__PURE__ */ new Set()) {
+function R(e, t, r = /* @__PURE__ */ new Set()) {
   if (e.getCallSignatures().length > 0 || e.getConstructSignatures().length > 0)
     return !1;
   if (e.isString() || e.isNumber() || e.isBoolean() || e.isNull() || e.isUndefined() || e.isStringLiteral() || e.isNumberLiteral() || e.isBooleanLiteral() || e.isEnumLiteral())
     return !0;
   if (e.isArray() || e.isReadonlyArray()) {
     const o = e.getArrayElementType();
-    return o ? E(o, t, n) : !1;
+    return o ? R(o, t, r) : !1;
   }
   if (e.isTuple())
-    return e.getTupleElements().every((o) => E(o, t, n));
+    return e.getTupleElements().every((o) => R(o, t, r));
   if (e.isUnion())
-    return e.getUnionTypes().every((o) => E(o, t, n));
+    return e.getUnionTypes().every((o) => R(o, t, r));
   if (e.isIntersection())
-    return e.getIntersectionTypes().every((o) => E(o, t, n));
+    return e.getIntersectionTypes().every((o) => R(o, t, r));
   if (e.isObject()) {
     const o = e.getText(t);
-    if (n.has(o))
+    if (r.has(o))
       return !0;
-    n.add(o);
-    const r = e.getStringIndexType(), i = e.getNumberIndexType();
-    if (r || i)
-      return [r, i].every(
-        (a) => !a || E(a, t, n)
+    r.add(o);
+    const n = e.getStringIndexType(), i = e.getNumberIndexType();
+    if (n || i)
+      return [n, i].every(
+        (a) => !a || R(a, t, r)
       );
     const s = e.getProperties();
     return s.length === 0 ? !0 : s.every((a) => {
       const c = a.getTypeAtLocation(t);
-      return E(c, t, n);
+      return R(c, t, r);
     });
   }
   return !1;
 }
-async function Mt(e) {
-  const t = e.session === void 0, n = Te(e.session ?? he());
+function Ft(e, t) {
+  return async (r) => {
+    let o = () => t(r);
+    for (let n = e.length - 1; n >= 0; n--) {
+      const i = e[n], s = o;
+      o = () => i(r, s);
+    }
+    return o();
+  };
+}
+function Ct(e, t) {
+  return Ft(e, t);
+}
+function nn(e, t, r = {}) {
+  const o = e.map((n) => n.capabilities.extractLayer).filter((n) => !!n).map((n) => n.createLayer ? n.createLayer(r) : n.layer).filter((n) => !!n);
+  return Ct(o, t);
+}
+let U;
+function Rt() {
+  return U || (U = N("ts-morph").Scope, U);
+}
+async function rn(e) {
+  const t = e.session === void 0, r = Ie(e.session ?? Ee());
   try {
-    return await Tt(e, n);
+    return await _t(e, r);
   } finally {
-    t && n.dispose();
+    t && r.dispose();
   }
 }
-async function Tt(e, t) {
+async function _t(e, t) {
   const {
-    sourceFile: n,
+    sourceFile: r,
     namespace: o = "",
-    tsconfig: r,
+    tsconfig: n,
     includeInstances: i = !1
-  } = e, s = t.projectFor(r), a = t.sourceFileFor(n, r), c = Y.basename(n), l = I(St(c)), u = I(o), f = [];
-  for (const [p, T] of a.getExportedDeclarations()) {
-    const d = T.find(
-      (y) => y.getKindName() === "ClassDeclaration"
+  } = e, s = t.projectFor(n), a = t.sourceFileFor(r, n), c = ce.basename(r), u = L(Mt(c)), l = L(o), f = [];
+  for (const [m, h] of a.getExportedDeclarations()) {
+    const y = h.find(
+      (p) => p.getKindName() === "ClassDeclaration"
     );
-    if (!d)
+    if (!y)
       continue;
-    const m = p === "default" ? d.getName() : p;
-    if (!m || G(m))
+    const d = m === "default" ? y.getName() : m;
+    if (!d || te(d))
       continue;
-    const b = I(m);
-    for (const y of d.getStaticMethods()) {
-      const h = y.getName();
-      if (G(h))
+    const g = L(d), x = Rt();
+    for (const p of y.getStaticMethods()) {
+      const T = p.getName();
+      if (te(T))
         continue;
-      const g = y.getScope();
-      if (g === L.Private || g === L.Protected)
+      const w = p.getScope();
+      if (w === x.Private || w === x.Protected)
         continue;
-      const x = y.getSignature(), S = U(x, y), v = x.getReturnType().getText(), w = y.isAsync(), $ = [l, b, I(h)];
+      const S = p.getSignature(), j = ee(S, p), b = S.getReturnType().getText(), A = p.isAsync(), $ = [u, g, L(T)];
       f.push(
-        await bt(
+        await Lt(
           s,
           a,
-          u,
+          l,
           $,
-          S,
-          v,
-          w,
-          r,
+          j,
+          b,
+          A,
+          n,
           t
         )
       );
     }
     if (i) {
       {
-        const h = d.getConstructors()[0] ?? null;
-        let g = [];
-        if (h) {
-          const j = h.getSignature();
-          g = U(j, h);
+        const T = y.getConstructors()[0] ?? null;
+        let w = [];
+        if (T) {
+          const v = T.getSignature();
+          w = ee(v, T);
         }
-        const x = [l, b], S = X(u, x), v = g.filter((j) => j.name !== "ctx"), w = v.filter((j) => !j.optional).map((j) => j.name), $ = {};
-        for (const j of v)
-          $[j.name] = await A(
+        const S = [u, g], j = ae(l, S), b = w.filter((v) => v.name !== "ctx"), A = b.filter((v) => !v.optional).map((v) => v.name), $ = {};
+        for (const v of b)
+          $[v.name] = await O(
             s,
             a,
-            j.type,
-            r,
+            v.type,
+            n,
             t
           );
         f.push({
-          id: S,
+          id: j,
           host: "ts",
-          namespace: u,
-          path: x,
+          namespace: l,
+          path: S,
           kind: "constructor",
           async: !1,
           streaming: !1,
           safe: !1,
-          input: { type: "object", properties: $, required: w },
+          input: { type: "object", properties: $, required: A },
           output: {
             type: "object",
             properties: { instanceId: { type: "string" } },
@@ -1511,45 +1707,45 @@ async function Tt(e, t) {
           envelope: {},
           typeText: {
             lang: "ts",
-            input: xt(g),
+            input: Kt(w),
             output: "{ instanceId: string }"
           }
         });
       }
-      for (const y of d.getInstanceMethods()) {
-        const h = y.getName();
-        if (G(h))
+      for (const p of y.getInstanceMethods()) {
+        const T = p.getName();
+        if (te(T))
           continue;
-        const g = y.getScope();
-        if (g === L.Private || g === L.Protected)
+        const w = p.getScope();
+        if (w === x.Private || w === x.Protected)
           continue;
-        const x = y.getSignature(), S = U(x, y), v = x.getReturnType().getText(), w = y.isAsync(), $ = [l, b, I(h)], j = X(u, $), P = S.filter((O) => O.name !== "ctx"), B = P.filter((O) => !O.optional).map((O) => O.name), R = {};
-        for (const O of P)
-          R[O.name] = await A(
+        const S = p.getSignature(), j = ee(S, p), b = S.getReturnType().getText(), A = p.isAsync(), $ = [u, g, L(T)], v = ae(l, $), P = j.filter((E) => E.name !== "ctx"), F = P.filter((E) => !E.optional).map((E) => E.name), K = {};
+        for (const E of P)
+          K[E.name] = await O(
             s,
             a,
-            O.type,
-            r,
+            E.type,
+            n,
             t
           );
-        const _ = v.replace(/^Promise<(.+)>$/, "$1").trim(), Pe = await A(
+        const V = b.replace(/^Promise<(.+)>$/, "$1").trim(), pe = fe(V), me = pe !== null, de = me ? pe : V, ze = await O(
           s,
           a,
-          _,
-          r,
+          de,
+          n,
           t
         );
         f.push({
-          id: j,
+          id: v,
           host: "ts",
-          namespace: u,
+          namespace: l,
           path: $,
           kind: "instance-method",
-          async: w,
-          streaming: !1,
+          async: A,
+          streaming: me,
           safe: !1,
-          input: { type: "object", properties: R, required: B },
-          output: Pe,
+          input: { type: "object", properties: K, required: F },
+          output: ze,
           envelope: {
             type: "object",
             properties: { instanceId: { type: "string" } },
@@ -1557,8 +1753,8 @@ async function Tt(e, t) {
           },
           typeText: {
             lang: "ts",
-            input: Ae(S),
-            output: _
+            input: Ve(j),
+            output: de
           }
         });
       }
@@ -1566,74 +1762,74 @@ async function Tt(e, t) {
   }
   return f;
 }
-async function bt(e, t, n, o, r, i, s, a, c) {
-  const l = r.filter((m) => m.name !== "ctx"), u = l.filter((m) => !m.optional).map((m) => m.name), f = {};
-  for (const m of l)
-    f[m.name] = await A(
+async function Lt(e, t, r, o, n, i, s, a, c) {
+  const u = n.filter((p) => p.name !== "ctx"), l = u.filter((p) => !p.optional).map((p) => p.name), f = {};
+  for (const p of u)
+    f[p.name] = await O(
       e,
       t,
-      m.type,
+      p.type,
       a,
       c
     );
-  const p = i.replace(/^Promise<(.+)>$/, "$1").trim(), T = await A(
+  const m = i.replace(/^Promise<(.+)>$/, "$1").trim(), h = fe(m), y = h !== null, d = y ? h : m, g = await O(
     e,
     t,
-    p,
+    d,
     a,
     c
   );
   return {
-    id: X(n, o),
+    id: ae(r, o),
     host: "ts",
-    namespace: n,
+    namespace: r,
     path: o,
     kind: "action",
     async: s,
-    streaming: !1,
+    streaming: y,
     safe: !1,
     // action → false per §4
-    input: { type: "object", properties: f, required: u },
-    output: T,
+    input: { type: "object", properties: f, required: l },
+    output: g,
     envelope: {},
     typeText: {
       lang: "ts",
-      input: Ae(r),
-      output: p
+      input: Ve(n),
+      output: d
     }
   };
 }
-function X(e, t) {
+function ae(e, t) {
   return (e.raw ? [e, ...t] : t).map((o) => o.words.join("-")).join("/");
 }
-function I(e) {
-  return { raw: e, words: $e(e) };
+function L(e) {
+  return { raw: e, words: Ke(e) };
 }
-function St(e) {
+function Mt(e) {
   return e.replace(/\.[^.]+$/, "").replace(/[._]+/g, "-");
 }
-function U(e, t) {
-  return e.getParameters().map((n) => {
+function ee(e, t) {
+  return e.getParameters().map((r) => {
     var s;
-    const o = n.getDeclarations(), r = o.length > 0 && o[0].getKindName() === "Parameter" ? o[0] : null, i = n.isOptional() || ((r == null ? void 0 : r.hasInitializer()) ?? !1) || (((s = r == null ? void 0 : r.hasQuestionToken) == null ? void 0 : s.call(r)) ?? !1);
+    const o = r.getDeclarations(), n = o.length > 0 && o[0].getKindName() === "Parameter" ? o[0] : null, i = r.isOptional() || ((n == null ? void 0 : n.hasInitializer()) ?? !1) || (((s = n == null ? void 0 : n.hasQuestionToken) == null ? void 0 : s.call(n)) ?? !1);
     return {
-      name: n.getName(),
-      type: n.getTypeAtLocation(t).getText(),
+      name: r.getName(),
+      type: r.getTypeAtLocation(t).getText(),
       optional: i
     };
   });
 }
-function Ae(e) {
-  const t = e.filter((n) => n.name !== "ctx");
-  return t.length === 0 ? "()" : "(" + t.map((n) => `${n.name}${n.optional ? "?" : ""}: ${n.type}`).join(", ") + ")";
+function Ve(e) {
+  const t = e.filter((r) => r.name !== "ctx");
+  return t.length === 0 ? "()" : "(" + t.map((r) => `${r.name}${r.optional ? "?" : ""}: ${r.type}`).join(", ") + ")";
 }
-function xt(e) {
+function Kt(e) {
   return e.length === 0 ? "()" : "(" + e.map((t) => `${t.name}${t.optional ? "?" : ""}: ${t.type}`).join(", ") + ")";
 }
-function G(e) {
+function te(e) {
   return !!(e === "__samples__" || e.startsWith("__") || e.startsWith("_"));
 }
-const vt = /* @__PURE__ */ new Map([
+const Vt = /* @__PURE__ */ new Map([
   // TypeScript variants
   [".ts", "ts"],
   [".tsx", "ts"],
@@ -1648,21 +1844,21 @@ const vt = /* @__PURE__ */ new Map([
   // Java / Kotlin (both are JVM host languages for the purposes of routing)
   [".java", "java"]
 ]);
-function wt(e) {
-  const t = Oe.extname(e).toLowerCase();
-  return vt.get(t);
+function zt(e) {
+  const t = Be.extname(e).toLowerCase();
+  return Vt.get(t);
 }
-function jt(e) {
+function Dt(e) {
   return e.language ?? "ts";
 }
-function $t(e, t) {
-  const n = wt(t);
-  return n === void 0 ? !1 : n === jt(e);
+function qt(e, t) {
+  const r = zt(t);
+  return r === void 0 ? !1 : r === Dt(e);
 }
-function Vt(e, t) {
-  return t.filter((n) => $t(e, n));
+function on(e, t) {
+  return t.filter((r) => qt(e, r));
 }
-function At(e) {
+function Bt(e) {
   return {
     oneOf: [
       {
@@ -1696,103 +1892,145 @@ function At(e) {
     ]
   };
 }
-function Pt(e) {
+function Wt(e) {
   return {
     operationConst: e.id,
     itemsSchema: e.input,
-    resultSchema: At(e.output)
+    resultSchema: Bt(e.output)
   };
 }
-function Nt(e, t = {}) {
-  const n = new Set(t.exclude ?? []), o = /* @__PURE__ */ new Map();
-  for (const r of e) {
-    if (n.has(r.id))
+function Ut(e, t = {}) {
+  const r = new Set(t.exclude ?? []), o = /* @__PURE__ */ new Map();
+  for (const n of e) {
+    if (r.has(n.id))
       continue;
-    const i = o.get(r.kind);
-    i ? i.push(r) : o.set(r.kind, [r]);
+    const i = o.get(n.kind);
+    i ? i.push(n) : o.set(n.kind, [n]);
   }
   return o;
 }
-function pe(e) {
+function Ae(e) {
   return { type: "string", enum: [e] };
 }
-function me(e, t) {
+function $e(e, t) {
   return {
     type: "object",
-    required: ["operation", "items"],
+    required: ["input"],
     properties: {
-      operation: t,
-      items: { type: "array", items: e.itemsSchema },
-      concurrency: { type: "number" },
-      mode: { type: "string", enum: ["parallel", "serial", "chained"] },
-      onItemError: { type: "string", enum: ["continue", "abort"] },
-      itemTimeoutMs: { type: "number" }
+      input: {
+        type: "object",
+        required: ["operation", "items"],
+        properties: {
+          operation: t,
+          items: { type: "array", items: e.itemsSchema },
+          concurrency: { type: "number" },
+          mode: { type: "string", enum: ["parallel", "serial", "chained"] },
+          onItemError: { type: "string", enum: ["continue", "abort"] },
+          itemTimeoutMs: { type: "number" }
+        },
+        // Additive-forward-compat (§7 open-question 3): a future `batchId`
+        // control-plane field must be addable without a breaking change, so
+        // this branch object must never be a closed schema.
+        additionalProperties: !0
+      }
     },
-    // Additive-forward-compat (§7 open-question 3): a future `batchId`
-    // control-plane field must be addable without a breaking change, so this
-    // branch object must never be a closed schema.
-    additionalProperties: !0
+    // The outer wrapper IS a closed shape — `input` is the only sanctioned
+    // top-level key for a `_batch/<kind>` mount call, mirroring
+    // `compose-schemas.ts`'s BUG-APIGEN-017 top-level `additionalProperties:
+    // false` for every extracted source op's envelope+data wrapper.
+    additionalProperties: !1
   };
 }
-function Ot(e) {
+function Pe(e, t) {
+  const r = {}, o = {}, n = [
+    ["definitions", r],
+    ["$defs", o]
+  ];
+  for (const i of e) {
+    const s = t(i);
+    for (const [a, c] of n) {
+      const u = s[a];
+      if (u)
+        for (const [l, f] of Object.entries(u)) {
+          const m = c[l];
+          if (m !== void 0 && JSON.stringify(m) !== JSON.stringify(f))
+            throw new Error(
+              `[apigen-core-client] _batch mount: operation "${i.id}" contributes a "${a}.${l}" definition that conflicts with an identically-named definition already hoisted from another batched operation. Two structurally different types share the same generated definition key, so apigen cannot safely merge them into one _batch/<kind> schema.`
+            );
+          c[l] = f;
+        }
+    }
+  }
+  return {
+    ...Object.keys(r).length > 0 ? { definitions: r } : {},
+    ...Object.keys(o).length > 0 ? { $defs: o } : {}
+  };
+}
+function Gt(e) {
   if (e.length === 0)
     throw new Error("buildBatchKindSchema: at least one operation is required");
-  const t = e.map(Pt);
+  const t = e.map(Wt), r = Pe(e, (s) => s.input), o = Pe(e, (s) => s.output);
   if (e.length === 1) {
-    const [r] = e, [i] = t;
+    const [s] = e, [a] = t;
     return {
-      input: me(i, pe(r.id)),
-      output: { type: "array", items: i.resultSchema }
+      input: { ...$e(a, Ae(s.id)), ...r },
+      output: { type: "array", items: a.resultSchema, ...o }
     };
   }
   const n = e.map(
-    (r, i) => me(t[i], pe(r.id))
-  ), o = D(
+    (s, a) => $e(t[a], Ae(s.id))
+  ), i = Q(
     n
   );
   return {
     input: {
       oneOf: n,
-      ...o ? { discriminator: o } : {}
+      ...i ? { discriminator: i } : {},
+      ...r
     },
     output: {
-      oneOf: t.map((r) => ({ type: "array", items: r.resultSchema }))
+      oneOf: t.map((s) => ({ type: "array", items: s.resultSchema })),
+      ...o
     },
-    ...o ? { discriminator: o } : {}
+    ...i ? { discriminator: i } : {}
   };
 }
-function qt(e, t = {}) {
-  const n = Nt(e.operations, t), o = [];
-  for (const [r, i] of n) {
-    const { input: s, output: a } = Ot(i), c = Ie(`_batch/${r}`, e, {
-      kind: r,
-      safe: r === "query",
+function sn(e, t = {}) {
+  const r = Ut(e.operations, t), o = [];
+  for (const [n, i] of r) {
+    const { input: s, output: a } = Gt(i), c = We(`_batch/${n}`, e, {
+      kind: n,
+      safe: n === "query",
       input: s,
       output: a
     });
     o.push({
       ...c,
-      operationIds: i.map((l) => l.id)
+      operationIds: i.map((u) => u.id)
     });
   }
   return o;
 }
 export {
-  Ot as buildBatchKindSchema,
-  qt as buildBatchMountedOperations,
-  Ft as clearPersistentProjectCache,
-  _t as composeSchemas,
-  he as createExtractionSession,
-  Pt as deriveBatchOperationBranch,
-  jt as effectiveLanguage,
-  Lt as extract,
-  Mt as extractClasses,
-  Nt as groupBatchableOperationsByKind,
-  _e as isPrimitiveOnlyInputSchema,
-  wt as languageOfSource,
-  $t as pluginConsumesSource,
-  Rt as pluginsToEnvelopeMiddlewares,
-  Vt as sourcesForPlugin,
-  Ie as syntheticOp,
-  $e as tokenize
+  Gt as buildBatchKindSchema,
+  sn as buildBatchMountedOperations,
+  Qt as clearPersistentProjectCache,
+  Xt as collectLocalImportPaths,
+  Ft as composeOnion,
+  en as composeSchemas,
+  Ct as createExtractInvoker,
+  nn as createExtractInvokerFromPlugins,
+  Ee as createExtractionSession,
+  Wt as deriveBatchOperationBranch,
+  Dt as effectiveLanguage,
+  tn as extract,
+  rn as extractClasses,
+  Ut as groupBatchableOperationsByKind,
+  Je as isPrimitiveOnlyInputSchema,
+  zt as languageOfSource,
+  qt as pluginConsumesSource,
+  Yt as pluginsToEnvelopeMiddlewares,
+  on as sourcesForPlugin,
+  We as syntheticOp,
+  Ke as tokenize
 };