@adhd/apigen-engine-runtime 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -1,3 +1,20 @@
+## 0.2.2 (2026-07-30)
+
+
+### 🚀 Features
+
+- **apigen:** generic batch/bulk fan-out operations (FEAT-APIGEN-BULK-OPS-001)
+
+
+### 🩹 Fixes
+
+- **apigen:** schema extraction required-array + CLI mount/discriminated-union gaps
+
+
+### ❤️  Thank You
+
+- pseudosky
+
 ## 0.2.1 (2026-07-28)
 
 This was a version bump only for apigen-engine-runtime to align it with other projects, there were no code changes.

package/index.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("ts-morph");require("node:fs");require("node:path");require("ts-json-schema-generator");const N=require("pino"),Ue=require("ajv"),De=require("ajv-formats"),I="$apigen";class z extends Error{constructor(t){super(t),this.code="E_DUP_CODEC",this.name="CodecRegistryError"}}function Le(e){const t=new Map;return{register(r,n){if(t.has(r.id)&&!(n!=null&&n.override))throw new z(`E_DUP_CODEC: a codec is already registered for id "${r.id}"`);t.set(r.id,r)},resolve(r){for(const n of t.values())if(n.matches(r))return n},get(r){return t.get(r)},ids(){return[...t.keys()]},freeze(){const r=new Map(t),n={register(){throw new z("E_DUP_CODEC: registry is frozen and cannot accept new codecs")},resolve(o){for(const i of r.values())if(i.matches(o))return i},get(o){return r.get(o)},ids(){return[...r.keys()]},freeze(){return n}};return n}}}const L="x-apigen-logical",R="x-apigen-codec",S="x-apigen-ctor",x="x-apigen-tojson",Re="0.1.0";function V(e,t){return{registry:e,resolve:r=>{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.`)},seen:new WeakSet,path:"",mode:"strict",...t}}function v(e,t,r){const n=r.registry.resolve(t);if(n)return n.encode(e,t,r);const o=t.$ref;if(typeof o=="string"){const a=r.resolve(o);return v(e,a,r)}const i=t.oneOf;if(Array.isArray(i)){const a=ce(e,i,t);return v(e,a,r)}const s=t.type;if(s==="array"){if(!Array.isArray(e))return _(e,t,r);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 d=a[u];return d===void 0?w(c):v(c,d,{...r,path:`${f}/${u}`})}):e.map((c,u)=>v(c,a,{...r,path:`${f}/${u}`}))}if(s==="object"){if(e===null||typeof e!="object"||Array.isArray(e))return _(e,t,r);const a=t.properties;if(!a)return w(e);const f=r.path,c={};for(const[u,d]of Object.entries(a)){const l=e[u];l!==void 0&&(c[u]=v(l,d,{...r,path:`${f}/${u}`}))}return c}return s==null?_(e,t,r):w(e)}function $(e,t,r){const n=r.registry.resolve(t);if(n)return n.decode(e,t,r);const o=t.$ref;if(typeof o=="string"){const a=r.resolve(o);return $(e,a,r)}const i=t.oneOf;if(Array.isArray(i)){const a=ce(e,i,t);return $(e,a,r)}const s=t.type;if(s==="array"){if(!Array.isArray(e))return e;const a=t.items;if(!a)return e;const f=r.path;return Array.isArray(a)?e.map((c,u)=>{const d=a[u];return d===void 0?c:$(c,d,{...r,path:`${f}/${u}`})}):e.map((c,u)=>$(c,a,{...r,path:`${f}/${u}`}))}if(s==="object"){if(e===null||typeof e!="object"||Array.isArray(e))return e;const a=t.properties;if(!a)return e;const f=r.path,c={};for(const[u,d]of Object.entries(a)){const l=e[u];l!==void 0&&(c[u]=$(l,d,{...r,path:`${f}/${u}`}))}return c}return s==null?Be(e,r):e}function ce(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 t[0]??{}}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{[I]:n,v:i}}catch{}}return w(e)}function Be(e,t){if(e!==null&&typeof e=="object"&&!Array.isArray(e)&&I in e){const r=e,n=r[I],o=t.registry.get(n);if(o)return o.decode(r.v,o.schema,t)}return e}function w(e){if(e===null||typeof e=="string"||typeof e=="number"||typeof e=="boolean")return e;if(Array.isArray(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));return t}return null}function Fe(e){return{encode(t,r,n){const o=V(e,n);return v(t,r,o)},decode(t,r,n){const o=V(e,n);return $(t,r,o)}}}const B={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){return e.toISOString()},decode(e,t,r){if(typeof e!="string"){if(r.mode==="strict")throw new TypeError(`[date-time] expected a string on the wire at "${r.path}", got ${typeof e}`);return new Date(String(e))}if(r.mode==="strict"&&Number.isNaN(new Date(e).getTime()))throw new TypeError(`[date-time] invalid date-time string at "${r.path}": ${JSON.stringify(e)}`);return new Date(e)}},F={id:"int64",kind:"scalar",schema:{type:"string",format:"int64"},matches(e){return e.type==="string"&&e.format==="int64"},encode(e,t,r){return String(e)},decode(e,t,r){if(typeof e!="string"){if(r.mode==="strict")throw new TypeError(`[int64] expected a string on the wire at "${r.path}", got ${typeof e}`);try{return BigInt(Math.trunc(Number(e)))}catch{return BigInt(0)}}if(r.mode==="strict")return BigInt(e);if(/^-?\d+$/.test(e))try{return BigInt(e)}catch{return BigInt(0)}return BigInt(0)}},q={id:"decimal",kind:"scalar",schema:{type:"string",format:"decimal"},matches(e){return e.type==="string"&&e.format==="decimal"},encode(e,t,r){return e},decode(e,t,r){if(typeof e!="string"){if(r.mode==="strict")throw new TypeError(`[decimal] expected a string on the wire at "${r.path}", got ${typeof e}`);return String(e)}if(r.mode==="strict"&&!/^-?\d+(\.\d+)?$/.test(e))throw new TypeError(`[decimal] wire value "${e}" at "${r.path}" is not a valid decimal string`);return e}},H={id:"byte",kind:"scalar",schema:{type:"string",format:"byte"},matches(e){return e.type==="string"&&e.format==="byte"},encode(e,t,r){return Buffer.from(e).toString("base64")},decode(e,t,r){if(typeof e!="string"){if(r.mode==="strict")throw new TypeError(`[byte] expected a base64 string on the wire at "${r.path}", got ${typeof e}`);return new Uint8Array(0)}if(r.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}"`);return new Uint8Array(Buffer.from(e,"base64"))}},qe=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/,K={id:"uuid",kind:"scalar",schema:{type:"string",format:"uuid"},matches(e){return e.type==="string"&&e.format==="uuid"},encode(e,t,r){return e.toLowerCase()},decode(e,t,r){if(typeof e!="string"){if(r.mode==="strict")throw new TypeError(`[uuid] expected a string on the wire at "${r.path}", got ${typeof e}`);return String(e).toLowerCase()}if(r.mode==="strict"&&!qe.test(e))throw new TypeError(`[uuid] wire value "${e}" at "${r.path}" is not a lowercase-hyphenated RFC 4122 UUID`);return e}},M="NaN",T="Infinity",P="-Infinity",He=new Set([M,T,P]),W={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},decode(e,t,r){if(typeof e=="number")return e;if(typeof e=="string"){if(e===M)return NaN;if(e===T)return 1/0;if(e===P)return-1/0;const n=Number(e);if(!Number.isNaN(n))return n}if(r.mode==="strict")throw new TypeError(`[number-special] unrecognized wire value at "${r.path}": ${JSON.stringify(e)}. Expected a number or one of ${[...He].join(", ")}.`);return NaN}},Ke=[B,F,q,H,K,W];function We(e,t={}){for(const r of Ke)e.register(r,{override:t.override??!1})}B.id,F.id,q.id,H.id,K.id,W.id;const ue=Le();We(ue);const fe=Fe(ue.freeze());function de(e,t){var n;const r=((n=e.input)==null?void 0:n.properties)??{};return t in r}function pe(e){var r,n;const t=(n=(r=e.input)==null?void 0:r.properties)==null?void 0:n.data;return Object.keys((t==null?void 0:t.properties)??{})}function ze(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}function Ve(e,t){return t===void 0||e===void 0?e:fe.decode(e,t)}function E(e,t){const r=t.output;return!r||Object.keys(r).length===0?e:fe.encode(e,r)}async function le(e,t,r,n,o,i){const a=pe(r).map(c=>Ve(i[c],ze(r,c)));if(de(r,"session")&&t){const c=await t({session:o.session}),u=await e[n](c,...a);return E(u,r)}if(r.hasCtx){const c=t?await t(o):void 0,u=await e[n](c,...a);return E(u,r)}const f=await e[n](...a);return E(f,r)}class ye{constructor(){this._map=new Map}set(t,r){this._map.set(t,r)}get(t){return this._map.get(t)}has(t){return this._map.has(t)}}function me(e=[]){return async function(r,n,o){const i=o.schemas[r];if(!i)throw new Error(`apigen/invoke: no schema found for operation "${r}"`);const s=()=>le(o.fns,o.createClient,i,r,n.envelope,n.domainArgs);return e.reduceRight((f,c)=>()=>c(n,f),s)()}}function Ge(e){return e}class he{constructor(){this.handlers=new Map}on(t,r){const n=this.handlers.get(t)??[];return this.handlers.set(t,[...n,r]),()=>this.off(t,r)}off(t,r){const n=this.handlers.get(t);if(!n)return;const o=n.filter(i=>i!==r);o.length===0?this.handlers.delete(t):this.handlers.set(t,o)}clear(){this.handlers.clear()}async emit(t){for(const[r,n]of this.handlers)if(Je(r,t))for(const o of n)await o(t)}}function Je(e,t){const[r,n,o]=e.split(":");return!(r!=="*"&&r!==t.module||n&&n!=="*"&&n!==t.method||o&&o!=="*"&&o!==t.lifecycle)}function ge(e,t){for(const r of e)if(r.eventMapping)for(const[n,o]of Object.entries(r.eventMapping))t.on(n,o)}async function we(e,t,r){let n={...t};for(const o of e)if(o.createContext){await r.emit({module:o.id,method:"createContext",lifecycle:"start",ctx:n});try{const i=await o.createContext(n);n={...n,...i},await r.emit({module:o.id,method:"createContext",lifecycle:"complete",ctx:n})}catch(i){throw await r.emit({module:o.id,method:"createContext",lifecycle:"error",ctx:n,error:i}),i}}return n}function G(e,t){const r=new Set,n=[e];for(;n.length>0;){const o=n.pop();if(!o||r.has(o))continue;r.add(o);const i=o.$ref;if(typeof i=="string"){if(t){const d=t[i];if(!d){const l=Object.keys(t).join(", ")||"(none)";throw new Error(`[apigen-logical] $ref "${i}" cannot be resolved. Available $defs: ${l}`)}n.push(d)}continue}const s=o.oneOf;if(Array.isArray(s))for(const d of s)typeof d=="object"&&d!==null&&n.push(d);const a=o.properties;if(a)for(const d of Object.values(a))n.push(d);const f=o.items;if(Array.isArray(f))for(const d of f)typeof d=="object"&&d!==null&&n.push(d);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)}}const J=new Set(["string","number","boolean","integer"]);function Ye(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"?J.has(r):Array.isArray(r)?r.every(n=>J.has(n)||n==="null"):Array.isArray(t.enum)&&t.enum.length>0?t.enum.every(n=>["string","number","boolean"].includes(typeof n)):!1}function Xe(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(Ye)}function Qe(e){const t={},r=n=>{for(const o of["definitions","$defs"]){const i=n[o];if(i)for(const[s,a]of Object.entries(i)){const f=s.startsWith("#/")?s:`#/${o}/${s}`;t[f]=a}}};for(const n of Object.values(e.schemas))r(n.input),r(n.output);if(Object.keys(t).length!==0)for(const[n,o]of Object.entries(e.schemas))try{G(o.input,t),G(o.output,t)}catch(i){throw new Error(`[apigen-core-client] Schema validation failed for function "${n}": ${i.message}`)}}function Ze(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&&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(" ")}function et(e,t,r){Qe(e);const n={};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=[],d={};for(const h of t)if(h.envelope&&s[h.id]!==!1)for(const[b,Pe]of Object.entries(h.envelope))c[b]=Pe,d[b]=h.id,u.includes(b)||u.push(b);const l={type:"object",properties:a,additionalProperties:!1,...f.length>0?{required:f}:{}},m=i.safe===!0||Xe(i.input),p=i.input.definitions,y=i.input.$defs;n[o]={input:{type:"object",properties:{...c,data:l},required:[...u,...f.length>0?["data"]:[]],additionalProperties:!1,description:Ze(Object.keys(c),Object.keys(a).length>0),...p?{definitions:p}:{},...y?{$defs:y}:{}},output:i.output,...i.hasCtx?{hasCtx:!0}:{},"x-apigen-safe":m,...Object.keys(d).length>0?{"x-apigen-envelope":d}:{}}}return n}const tt={"decimal.js":"Decimal"};function rt(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}Object.entries(tt).map(([e,t])=>({pattern:new RegExp(`import\\(["'][^"']*${rt(e)}[^"']*["']\\)\\.\\w+`,"g"),key:t}));class U extends Error{constructor(t){super(t),this.name="ConfigurationError"}}function be(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 U(`Middleware "${t.id}" subscribes to its own events via "${r}". This would cause infinite recursion.`)}}function nt(e){const{domainSchemas:t,middlewares:r,overrides:n={},strict:o=!1}=e;be(r);for(const c of Object.keys(n))if(!(c in t.schemas)){const u=`Override key "${c}" not found in domain schemas.`;if(o)throw new U(u);console.warn("[apigen-runtime]",u)}const i=new Set(r.map(c=>c.id));for(const[c,u]of Object.entries(n))for(const d of Object.keys(u??{}))if(!i.has(d)){const l=`Override key "${c}.${d}" does not match any declared middleware id.`;if(o)throw new U(l);console.warn("[apigen-runtime]",l)}const s=et(t,r,n),a=new he;return ge(r,a),{schemas:s,createClient:async c=>we(r,c,a),dispose:()=>a.clear()}}function ot(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};if(o==="pretty")return i.transport={target:"pino-pretty",options:{colorize:!r,translateTime:"SYS:HH:MM:ss.l",ignore:"pid,hostname",...r?{destination:e.destination,mkdir:!0}:{destination:2}}},N(i);const s=r?N.destination({dest:e.destination,mkdir:!0,sync:!0}):N.destination(2);return N(i,s)}function ve(e){return e?e.type==="array"?`${ve(e.items)}[]`:e.enum?"enum":e.$ref?String(e.$ref).split("/").pop()||"object":e.anyOf||e.oneOf?"union":e.type??"object":"unknown"}function $e(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])=>({name:f,type:ve(c),required:o.has(f)})),s=i.map(f=>`${f.name}${f.required?"":"?"}: ${f.type}`).join(", ");return{params:i,text:s}}function it(e){let t;return Array.isArray(e)?t=e:e?t=[e]:t=[],t.find(r=>r==="number"||r==="integer"||r==="boolean")}function st(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")continue;const u=it(f==null?void 0:f.type);if(u==="number"||u==="integer"){const d=Number(c);!Number.isNaN(d)&&c.trim()!==""&&(o[a]=d)}else u==="boolean"&&(c==="true"?o[a]=!0:c==="false"&&(o[a]=!1))}return o}const Y=new Set(["default","module.exports","__esModule"]);function at(e){const t={},r=(n,o)=>{for(const[i,s]of Object.entries(n))if(typeof s=="function"){!Y.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&&Y.has(i)&&r(s,o+1)};return r(e,0),t}const ct=["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)}toJSON(){const t={code:this.code,message:this.message};return this.details!==void 0&&(t.details=this.details),t}}function Oe(e){return typeof e=="object"&&e!==null&&e.name==="ApiError"&&ct.includes(e.code)&&typeof e.toJSON=="function"}function X(e,t,r=0){return e==="before-first-chunk"?{phase:e,error:t}:{phase:e,error:t,chunksDelivered:r}}const O=new Ue({allErrors:!0});De(O);for(const e of[L,R,S,x,"discriminator"])O.addKeyword({keyword:e,valid:!0});O.addFormat("decimal",/^[+-]?(?:\d+(?:\.\d+)?|\.\d+)$/);function Ne(e){return e.map(t=>`${t.instancePath||"(root)"} ${t.message??"failed schema check"}`).join("; ")}const ut=async(e,t)=>{const r=e.ctx.get(je);if(r===void 0)return t();const n=e.operation.id,o=r[n];if(o===void 0)return t();const i={data:e.domainArgs,...e.envelope},s=O.compile(o.input);if(!s(i)){const f=s.errors??[];throw new A("invalid_argument",`Validation failed: ${Ne(f)}`,f)}return t()},je=Symbol("ValidateSchemasToken");function Ae(e){return async function(r,n){const o=r.operation.id,i=e[o];if(i===void 0)return n();const s={data:r.domainArgs,...r.envelope},a=O.compile(i.input);if(!a(s)){const c=a.errors??[];throw new A("invalid_argument",`Validation failed: ${Ne(c)}`,c)}return n()}}function ft(){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 dt{constructor(t={}){var n,o;this._store=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))}create(t,r=[],n){const o=new t(...r),i=ft(),s=n??this._defaultTtlMs,a=s!==void 0?Date.now()+s:null;return this._store.set(i,{instance:o,expiresAt:a}),{instanceId:i}}get(t){const r=this._store.get(t);if(!r)throw new Error(`[instance-registry] Unknown instanceId: "${t}"`);if(r.expiresAt!==null&&Date.now()>r.expiresAt)throw this._evict(t,r),new Error(`[instance-registry] Instance "${t}" has expired`);return r.instance}async dispatch(t,r,n=[]){const o=this.get(t),i=o[r];if(typeof i!="function")throw new Error(`[instance-registry] Method "${r}" not found on instance "${t}"`);return i.call(o,...n)}async dispose(t){const r=this._store.get(t);r&&(this._store.delete(t),await C(r.instance))}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])=>C(r.instance)))}get size(){return this._store.size}_sweep(){const t=Date.now();for(const[r,n]of this._store)n.expiresAt!==null&&t>n.expiresAt&&this._evict(r,n)}_evict(t,r){this._store.delete(t),C(r.instance)}}async function C(e){if(e!==null&&typeof e=="object"&&"dispose"in e){const t=e.dispose;typeof t=="function"&&await t.call(e)}}function pt(e){const{produce:t,signal:r}=e,n=r??new AbortController().signal;return{[Symbol.asyncIterator](){const o=t(n);return{async next(){return n.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}},async throw(i){return await o.throw(i),{done:!0,value:void 0}}}}}}async function lt(e){const t=[];for await(const r of e)t.push(r);return t}async function _e(e){const t=[];try{for await(const r of e)t.push(r);return{ok:!0,chunks:t}}catch(r){const n=Oe(r)?r:new A("internal",r instanceof Error?r.message:String(r));return t.length===0?{ok:!1,carrier:X("before-first-chunk",n)}:{ok:!1,carrier:X("after-first-chunk",n,t.length)}}}function Ee(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}}function k(e){const t=e.discriminator;if(t===null||typeof t!="object"||Array.isArray(t))return;const r=t;if(typeof r.propertyName!="string")return;const n=r.mapping;if(!(n===null||typeof n!="object"||Array.isArray(n)))return{propertyName:r.propertyName,mapping:n}}function Ce(e,t){const r=e[R];if(typeof r=="string"){const n=t.registry.get(r);if(n)return n}return t.registry.resolve(e)}function yt(e,t,r){const n=Ce(t,r);return n?n.encode(e,t,r):e}function mt(e,t,r){const n=Ce(t,r);return n?n.decode(e,t,r):e}function ke(e){const{id:t,schema:r}=e;return{id:t,kind:"union",schema:r,matches(n){if(n[L]==="union")return!0;const o=n.oneOf;return!Array.isArray(o)||o.length===0?!1:k(n)!==void 0},encode(n,o,i){const s=k(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)throw new g("E_UNION_NO_DISCRIMINATOR",`[${t}] value at "${i.path}" is missing the discriminator property "${a}".`);const u=String(c),d=f[u];if(!d)throw new g("E_UNION_UNKNOWN_TAG",`[${t}] discriminator tag "${u}" at "${i.path}" is not in the mapping (known: ${Object.keys(f).join(", ")}).`);const l=i.resolve(d);return yt(n,l,{...i,path:`${i.path}[${u}]`})},decode(n,o,i){if(n===null||typeof n!="object"||Array.isArray(n)){let p;throw n===null?p="null":Array.isArray(n)?p="array":p=typeof n,new g("E_UNION_INVALID_WIRE",`[${t}] expected a JSON object on the wire at "${i.path}", got ${p}.`)}const s=n,a=k(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)throw new g("E_UNION_NO_DISCRIMINATOR",`[${t}] wire object at "${i.path}" is missing the discriminator property "${f}".`);const d=String(u),l=c[d];if(!l)throw new g("E_UNION_UNKNOWN_TAG",`[${t}] discriminator tag "${d}" on the wire at "${i.path}" is not in the mapping (known: ${Object.keys(c).join(", ")}).`);const m=i.resolve(l);return mt(n,m,{...i,path:`${i.path}[${d}]`})}}}const ht="x-apigen-instances";class j extends Error{constructor(t,r){super(r),this.name="NominalCodecError",this.code=t}}function Q(e){const t=e.properties;return t&&typeof t=="object"&&!Array.isArray(t)?t:{}}function gt(e){const t=e.required;return Array.isArray(t)?t.filter(r=>typeof r=="string"):[]}function Z(e,t,r){if(t){const n=r.registry.resolve(t);if(n)return n.encode(e,t,r)}return e}function wt(e,t,r){if(t){const n=r.registry.resolve(t);if(n)return n.decode(e,t,r)}return e}function bt(e){const{id:t,schema:r,ctor:n}=e;return{id:t,kind:"nominal",schema:r,matches(o){return o[L]==="nominal"?!0:o[R]===t},encode(o,i,s){if(o===null||typeof o!="object")return o;if(s.seen.has(o)){if(s.mode==="strict")throw new j("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.`);return null}s.seen.add(o);try{const a=Q(i),f=typeof i[x]=="string"?i[x]:"toJSON",c=o[f];if(typeof c=="function"){const p=c.call(o);if(p!==null&&typeof p=="object"&&!Array.isArray(p)){const y={};for(const[h,b]of Object.entries(p))y[h]=Z(b,a[h],{...s,path:`${s.path}/${h}`});return y}return p}const u={},d=Object.keys(a),l=o,m=d.length>0?d:Object.keys(l);for(const p of m){const y=l[p];y!==void 0&&(u[p]=Z(y,a[p],{...s,path:`${s.path}/${p}`}))}return u}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 j("E_NOMINAL_INVALID_WIRE",`[${t}] expected a JSON object on the wire at "${s.path}", got ${u}.`)}const a=o;for(const u of gt(i))if(!(u in a))throw new j("E_NOMINAL_INVALID_WIRE",`[${t}] required field "${u}" missing on the wire at "${s.path}".`);if(i[ht]===!1)throw new j("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=Q(i),c={};for(const[u,d]of Object.entries(a))c[u]=wt(d,f[u],{...s,path:`${s.path}/${u}`});if(n){const u=typeof i[S]=="string"?i[S]:"fromJSON",d=n[u];if(typeof d=="function")return d.call(n,c);const l=n;return new l(c)}return c}}}const Ie=[B,F,q,H,K,W],vt={type:"object","x-apigen-logical":"nominal","x-apigen-codec":"ts.NominalSentinel"},ee=bt({id:"ts.NominalSentinel",schema:vt}),$t={oneOf:[],discriminator:{propertyName:"kind",mapping:{}},"x-apigen-logical":"union","x-apigen-codec":"ts.UnionSentinel"},te=ke({id:"ts.UnionSentinel",schema:$t});function Ot(){const e=[...Ie.map(t=>[t.id,t]),[ee.id,ee],[te.id,te]];return Object.freeze(new Map(e))}const Nt=Object.freeze({host:"ts",logicalTypeVersion:Re,codecs:Ot()});function jt(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);return o.length>0?o.join(" — "):e}function At(e){if(!e||typeof e!="object"||Array.isArray(e)||Object.keys(e).length===0)return{outputSchema:void 0,wrapped:!1};const t=e;return t.type==="object"?{outputSchema:t,wrapped:!1}:{outputSchema:{type:"object",properties:{result:t},required:["result"]},wrapped:!0}}function _t(e,t){return e?{result:t}:t&&typeof t=="object"&&!Array.isArray(t)?t:void 0}const Se=4,xe=32;function D(e){return Oe(e)?e:e instanceof Error?new A("internal",e.message):e}function Et(e,t){if(e==="serial"||e==="chained")return 1;const r=t??Se;return!Number.isFinite(r)||r<1?1:Math.min(Math.floor(r),xe)}function Ct(){}function kt(e,t){var i;if(!e&&!t)return{signal:void 0,dispose:Ct};const r=new AbortController,n=()=>{r.abort(e==null?void 0:e.reason)};e&&(e.aborted?r.abort(e.reason):e.addEventListener("abort",n,{once:!0}));let o;return t!==void 0&&!r.signal.aborted&&(o=setTimeout(()=>{r.abort(new DOMException(`apigen/invokeBatch: item timed out after ${t}ms`,"TimeoutError"))},t),(i=o.unref)==null||i.call(o)),{signal:r.signal,dispose(){e&&e.removeEventListener("abort",n),o&&clearTimeout(o)}}}async function re(e,t,r,n,o,i){const s=kt(n.signal,i);try{const a=s.signal?{...n,signal:s.signal}:n,f=await e(t,a,o);if(Ee(f)){const c=await _e(f);if(c.ok)return{index:r,status:"fulfilled",chunks:c.chunks};const u=c.carrier;return{index:r,status:"rejected",reason:D(u.error),...u.phase==="after-first-chunk"?{chunksDelivered:u.chunksDelivered}:{}}}return{index:r,status:"fulfilled",value:f}}catch(a){return{index:r,status:"rejected",reason:D(a)}}finally{s.dispose()}}async function It(e,t,r,n,o={}){const i=o.mode??"parallel",s=o.onItemError??"continue",a=Et(i,o.concurrency),f=new Array(r.length),c=p=>({index:p,status:"rejected",reason:D(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 p=!1;for(let y=0;y<r.length;y++){if(p){f[y]=c(y);continue}const h=await re(e,t,y,r[y],n,o.itemTimeoutMs);f[y]=h,h.status==="rejected"&&(i==="chained"||s==="abort")&&(p=!0)}return f}let u=0,d=!1;const l=Math.max(1,Math.min(a,r.length)),m=Array.from({length:l},async()=>{for(;;){const p=u++;if(p>=r.length)return;if(d){f[p]=c(p);continue}const y=await re(e,t,p,r[p],n,o.itemTimeoutMs);f[p]=y,y.status==="rejected"&&s==="abort"&&(d=!0)}});return await Promise.all(m),f}const ne=new Set(["string","number","boolean","integer"]);function St(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"?ne.has(r):Array.isArray(r)?r.every(n=>ne.has(n)||n==="null"):Array.isArray(t.enum)&&t.enum.length>0?t.enum.every(n=>["string","number","boolean"].includes(typeof n)):!1}function xt(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(St)}const Mt={"decimal.js":"Decimal"};function Tt(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}Object.entries(Mt).map(([e,t])=>({pattern:new RegExp(`import\\(["'][^"']*${Tt(e)}[^"']*["']\\)\\.\\w+`,"g"),key:t}));function oe(e){return e.words.join("-")}function ie(e){return e.words.map(Rt).join("")}function se(e){return e.words.join("_")}function Pt(e,t={}){var r,n;const o=[e.namespace,...e.path],i=e.safe||xt(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=>oe(m)).join("/"),f=o.map(m=>se(m)).join("_"),c=o.map(m=>se(m)).slice(0,-1).join("."),u=ie(o[o.length-2]??o[0]),d=ie(o[o.length-1]),l=o.map(m=>oe(m));return{http:{verb:s,route:a},mcp:{name:f},grpc:{package:c,service:u,method:d},cli:{path:l}}}function Ut(e,t){return`x-${e}-${t}`}function Dt(e,t){return`--${e}-${t}`}function Lt(e,t){const r=n=>n.toUpperCase().replace(/-/g,"_");return e==="adhd"?`APIGEN_${r(t)}`:`APIGEN_${r(e)}_${r(t)}`}function Rt(e){return e.length===0?e:e[0].toUpperCase()+e.slice(1)}function Me(e){return e.anyOf??e.oneOf}function Bt(e){if(!e)return!1;if(e.type==="array"||e.type==="object")return!0;const t=Me(e);if(t){const r=t.filter(n=>n.type!=="null");return r.length>0&&r.every(n=>n.type==="array"||n.type==="object")}return!1}function Ft(e){if(!e)return!1;if(e.type==="boolean")return!0;const t=Me(e);if(t){const r=t.filter(n=>n.type!=="null");return r.length>0&&r.every(n=>n.type==="boolean")}return!1}function qt(e){return e.replace(/[A-Z]/g,t=>"-"+t.toLowerCase())}function Ht(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}}function ae(e){return typeof e.handler=="function"}function Kt(e){var o;const t=((o=e.input)==null?void 0:o.properties)??{},r=e["x-apigen-envelope"],n=[];for(const i of Object.keys(t)){if(i==="data")continue;const s=(r==null?void 0:r[i])??"adhd",a=Ut(s,i);n.push({field:i,pluginId:s,httpHeader:a,mcpMetaKey:a,cliFlag:Dt(s,i),envVar:Lt(s,i)})}return n}function Wt(e,t){const r=new Map,{props:n}=Ht(e);for(const[o,i]of Object.entries(n)){let s="string";Ft(i)?s="boolean":Bt(i)&&(s="json"),r.set(qt(o),{camelKey:o,kind:"domain",valueKind:s})}for(const o of t){const i=o.cliFlag.replace(/^--/,"");r.set(i,{camelKey:o.field,kind:"envelope",valueKind:"string",envVar:o.envVar})}return r}function zt(e){const{op:t,schema:r,transport:n,projection:o}=e,i=Pt(t,o),s=r?Kt(r):[],a=r?Wt(r,s):new Map,f=r?$e(r).params:void 0,c={op:t,transport:n,http:i.http,mcp:i.mcp,cli:i.cli,grpc:i.grpc,params:f,envelope:s,cliFlags:a,streaming:t.streaming,isMount:ae(t)};if(ae(t)){const u=t.handler;c.mountHandler=async d=>u(d)}return c}function Vt(e){const t=e.usePlugins;return Array.isArray(t)?t:[]}function Gt(e){const t=e.useOptions;return t&&typeof t=="object"?t:{}}function Te(e){return async function(r,n){const o=Object.assign(r,{data:r.domainArgs});return await e.layer(o,n)}}function Jt(e,t){var n;const r=[];for(const o of t){const i=(n=o.capabilities)==null?void 0:n.layer;i&&r.push(Te(i))}return r.push(Ae(e)),me(r)}function Yt(){const e=new Map;return{get:t=>e.get(t),set:(t,r)=>{e.set(t,r)}}}const Xt={input:{type:"object",properties:{data:{type:"object",properties:{}}}},output:{}};async function Qt(e,t,r,n){const o={...r,operation:{id:e.op.id},ctx:new ye};if(e.isMount){const i=e.mountHandler;if(!i)throw new Error(`apigen-engine-runtime/dispatchForPlan: OpPlan for mount op "${e.op.id}" has isMount=true but no mountHandler`);const s={operation:e.op,data:r.domainArgs,envelope:r.envelope,ctx:Yt(),transport:e.transport,signal:r.signal??new AbortController().signal},a={...n,fns:{[e.op.id]:()=>i(s)},schemas:{[e.op.id]:Xt}};return t(e.op.id,o,a)}return t(e.op.id,o,n)}exports.BATCH_DEFAULT_CONCURRENCY=Se;exports.BATCH_MAX_CONCURRENCY=xe;exports.EventBus=he;exports.InstanceRegistry=dt;exports.LayerContext=ye;exports.UnionCodecError=g;exports.ValidateSchemasToken=je;exports.WELL_KNOWN_TS_CODECS=Ie;exports.adaptCoreLayer=Te;exports.assertNoSelfSubscription=be;exports.buildContext=we;exports.buildFnTable=at;exports.buildMcpOutputSchema=At;exports.buildOpPlan=zt;exports.buildToolDescription=jt;exports.coerceQueryParams=st;exports.collectWithPhase=_e;exports.createApiPackage=nt;exports.createInvoker=me;exports.createLogger=ot;exports.createPackageInvoker=Jt;exports.createStream=pt;exports.createUnionCodec=ke;exports.dataParamNames=pe;exports.defineMiddleware=Ge;exports.describeParams=$e;exports.dispatch=le;exports.dispatchForPlan=Qt;exports.drainStream=lt;exports.invokeBatch=It;exports.isApiStream=Ee;exports.makeValidateLayer=Ae;exports.needsEnvelopeField=de;exports.readUseOptions=Gt;exports.readUsePlugins=Vt;exports.tsHostBinding=Nt;exports.validateLayer=ut;exports.wireObservers=ge;exports.wrapMcpStructuredContent=_t;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("ts-morph");require("node:fs");require("node:path");require("ts-json-schema-generator");const O=require("pino"),Ue=require("ajv"),De=require("ajv-formats"),I="$apigen";class V extends Error{constructor(t){super(t),this.code="E_DUP_CODEC",this.name="CodecRegistryError"}}function Le(e){const t=new Map;return{register(r,n){if(t.has(r.id)&&!(n!=null&&n.override))throw new V(`E_DUP_CODEC: a codec is already registered for id "${r.id}"`);t.set(r.id,r)},resolve(r){for(const n of t.values())if(n.matches(r))return n},get(r){return t.get(r)},ids(){return[...t.keys()]},freeze(){const r=new Map(t),n={register(){throw new V("E_DUP_CODEC: registry is frozen and cannot accept new codecs")},resolve(o){for(const i of r.values())if(i.matches(o))return i},get(o){return r.get(o)},ids(){return[...r.keys()]},freeze(){return n}};return n}}}const L="x-apigen-logical",R="x-apigen-codec",S="x-apigen-ctor",x="x-apigen-tojson",Re="0.1.0";function G(e,t){return{registry:e,resolve:r=>{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.`)},seen:new WeakSet,path:"",mode:"strict",...t}}function v(e,t,r){const n=r.registry.resolve(t);if(n)return n.encode(e,t,r);const o=t.$ref;if(typeof o=="string"){const a=r.resolve(o);return v(e,a,r)}const i=t.oneOf;if(Array.isArray(i)){const a=ue(e,i,t);return v(e,a,r)}const s=t.type;if(s==="array"){if(!Array.isArray(e))return _(e,t,r);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 l=a[u];return l===void 0?w(c):v(c,l,{...r,path:`${f}/${u}`})}):e.map((c,u)=>v(c,a,{...r,path:`${f}/${u}`}))}if(s==="object"){if(e===null||typeof e!="object"||Array.isArray(e))return _(e,t,r);const a=t.properties;if(!a)return w(e);const f=r.path,c={};for(const[u,l]of Object.entries(a)){const p=e[u];p!==void 0&&(c[u]=v(p,l,{...r,path:`${f}/${u}`}))}return c}return s==null?_(e,t,r):w(e)}function $(e,t,r){const n=r.registry.resolve(t);if(n)return n.decode(e,t,r);const o=t.$ref;if(typeof o=="string"){const a=r.resolve(o);return $(e,a,r)}const i=t.oneOf;if(Array.isArray(i)){const a=ue(e,i,t);return $(e,a,r)}const s=t.type;if(s==="array"){if(!Array.isArray(e))return e;const a=t.items;if(!a)return e;const f=r.path;return Array.isArray(a)?e.map((c,u)=>{const l=a[u];return l===void 0?c:$(c,l,{...r,path:`${f}/${u}`})}):e.map((c,u)=>$(c,a,{...r,path:`${f}/${u}`}))}if(s==="object"){if(e===null||typeof e!="object"||Array.isArray(e))return e;const a=t.properties;if(!a)return e;const f=r.path,c={};for(const[u,l]of Object.entries(a)){const p=e[u];p!==void 0&&(c[u]=$(p,l,{...r,path:`${f}/${u}`}))}return c}return s==null?Be(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 t[0]??{}}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{[I]:n,v:i}}catch{}}return w(e)}function Be(e,t){if(e!==null&&typeof e=="object"&&!Array.isArray(e)&&I in e){const r=e,n=r[I],o=t.registry.get(n);if(o)return o.decode(r.v,o.schema,t)}return e}function w(e){if(e===null||typeof e=="string"||typeof e=="number"||typeof e=="boolean")return e;if(Array.isArray(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));return t}return null}function Fe(e){return{encode(t,r,n){const o=G(e,n);return v(t,r,o)},decode(t,r,n){const o=G(e,n);return $(t,r,o)}}}const B={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){return e.toISOString()},decode(e,t,r){if(typeof e!="string"){if(r.mode==="strict")throw new TypeError(`[date-time] expected a string on the wire at "${r.path}", got ${typeof e}`);return new Date(String(e))}if(r.mode==="strict"&&Number.isNaN(new Date(e).getTime()))throw new TypeError(`[date-time] invalid date-time string at "${r.path}": ${JSON.stringify(e)}`);return new Date(e)}},F={id:"int64",kind:"scalar",schema:{type:"string",format:"int64"},matches(e){return e.type==="string"&&e.format==="int64"},encode(e,t,r){return String(e)},decode(e,t,r){if(typeof e!="string"){if(r.mode==="strict")throw new TypeError(`[int64] expected a string on the wire at "${r.path}", got ${typeof e}`);try{return BigInt(Math.trunc(Number(e)))}catch{return BigInt(0)}}if(r.mode==="strict")return BigInt(e);if(/^-?\d+$/.test(e))try{return BigInt(e)}catch{return BigInt(0)}return BigInt(0)}},q={id:"decimal",kind:"scalar",schema:{type:"string",format:"decimal"},matches(e){return e.type==="string"&&e.format==="decimal"},encode(e,t,r){return e},decode(e,t,r){if(typeof e!="string"){if(r.mode==="strict")throw new TypeError(`[decimal] expected a string on the wire at "${r.path}", got ${typeof e}`);return String(e)}if(r.mode==="strict"&&!/^-?\d+(\.\d+)?$/.test(e))throw new TypeError(`[decimal] wire value "${e}" at "${r.path}" is not a valid decimal string`);return e}},H={id:"byte",kind:"scalar",schema:{type:"string",format:"byte"},matches(e){return e.type==="string"&&e.format==="byte"},encode(e,t,r){return Buffer.from(e).toString("base64")},decode(e,t,r){if(typeof e!="string"){if(r.mode==="strict")throw new TypeError(`[byte] expected a base64 string on the wire at "${r.path}", got ${typeof e}`);return new Uint8Array(0)}if(r.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}"`);return new Uint8Array(Buffer.from(e,"base64"))}},qe=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/,K={id:"uuid",kind:"scalar",schema:{type:"string",format:"uuid"},matches(e){return e.type==="string"&&e.format==="uuid"},encode(e,t,r){return e.toLowerCase()},decode(e,t,r){if(typeof e!="string"){if(r.mode==="strict")throw new TypeError(`[uuid] expected a string on the wire at "${r.path}", got ${typeof e}`);return String(e).toLowerCase()}if(r.mode==="strict"&&!qe.test(e))throw new TypeError(`[uuid] wire value "${e}" at "${r.path}" is not a lowercase-hyphenated RFC 4122 UUID`);return e}},M="NaN",T="Infinity",P="-Infinity",He=new Set([M,T,P]),W={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},decode(e,t,r){if(typeof e=="number")return e;if(typeof e=="string"){if(e===M)return NaN;if(e===T)return 1/0;if(e===P)return-1/0;const n=Number(e);if(!Number.isNaN(n))return n}if(r.mode==="strict")throw new TypeError(`[number-special] unrecognized wire value at "${r.path}": ${JSON.stringify(e)}. Expected a number or one of ${[...He].join(", ")}.`);return NaN}},Ke=[B,F,q,H,K,W];function We(e,t={}){for(const r of Ke)e.register(r,{override:t.override??!1})}B.id,F.id,q.id,H.id,K.id,W.id;const fe=Le();We(fe);const le=Fe(fe.freeze());function de(e,t){var n;const r=((n=e.input)==null?void 0:n.properties)??{};return t in r}function pe(e){var r,n;const t=(n=(r=e.input)==null?void 0:r.properties)==null?void 0:n.data;return Object.keys((t==null?void 0:t.properties)??{})}function ze(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}function Ve(e,t){return t===void 0||e===void 0?e:le.decode(e,t)}function E(e,t){const r=t.output;return!r||Object.keys(r).length===0?e:le.encode(e,r)}async function ye(e,t,r,n,o,i){const a=pe(r).map(c=>Ve(i[c],ze(r,c)));if(de(r,"session")&&t){const c=await t({session:o.session}),u=await e[n](c,...a);return E(u,r)}if(r.hasCtx){const c=t?await t(o):void 0,u=await e[n](c,...a);return E(u,r)}const f=await e[n](...a);return E(f,r)}class me{constructor(){this._map=new Map}set(t,r){this._map.set(t,r)}get(t){return this._map.get(t)}has(t){return this._map.has(t)}}function he(e=[]){return async function(r,n,o){const i=o.schemas[r];if(!i)throw new Error(`apigen/invoke: no schema found for operation "${r}"`);const s=()=>ye(o.fns,o.createClient,i,r,n.envelope,n.domainArgs);return e.reduceRight((f,c)=>()=>c(n,f),s)()}}function Ge(e){return e}class ge{constructor(){this.handlers=new Map}on(t,r){const n=this.handlers.get(t)??[];return this.handlers.set(t,[...n,r]),()=>this.off(t,r)}off(t,r){const n=this.handlers.get(t);if(!n)return;const o=n.filter(i=>i!==r);o.length===0?this.handlers.delete(t):this.handlers.set(t,o)}clear(){this.handlers.clear()}async emit(t){for(const[r,n]of this.handlers)if(Je(r,t))for(const o of n)await o(t)}}function Je(e,t){const[r,n,o]=e.split(":");return!(r!=="*"&&r!==t.module||n&&n!=="*"&&n!==t.method||o&&o!=="*"&&o!==t.lifecycle)}function we(e,t){for(const r of e)if(r.eventMapping)for(const[n,o]of Object.entries(r.eventMapping))t.on(n,o)}async function be(e,t,r){let n={...t};for(const o of e)if(o.createContext){await r.emit({module:o.id,method:"createContext",lifecycle:"start",ctx:n});try{const i=await o.createContext(n);n={...n,...i},await r.emit({module:o.id,method:"createContext",lifecycle:"complete",ctx:n})}catch(i){throw await r.emit({module:o.id,method:"createContext",lifecycle:"error",ctx:n,error:i}),i}}return n}function J(e,t){const r=new Set,n=[e];for(;n.length>0;){const o=n.pop();if(!o||r.has(o))continue;r.add(o);const i=o.$ref;if(typeof i=="string"){if(t){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: ${p}`)}n.push(l)}continue}const s=o.oneOf;if(Array.isArray(s))for(const l of s)typeof l=="object"&&l!==null&&n.push(l);const a=o.properties;if(a)for(const l of Object.values(a))n.push(l);const f=o.items;if(Array.isArray(f))for(const l of f)typeof l=="object"&&l!==null&&n.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)}}const Y=new Set(["string","number","boolean","integer"]);function Ye(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}function Xe(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(Ye)}function Qe(e){const t={},r=n=>{for(const o of["definitions","$defs"]){const i=n[o];if(i)for(const[s,a]of Object.entries(i)){const f=s.startsWith("#/")?s:`#/${o}/${s}`;t[f]=a}}};for(const n of Object.values(e.schemas))r(n.input),r(n.output);if(Object.keys(t).length!==0)for(const[n,o]of Object.entries(e.schemas))try{J(o.input,t),J(o.output,t)}catch(i){throw new Error(`[apigen-core-client] Schema validation failed for function "${n}": ${i.message}`)}}function Ze(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&&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(" ")}function et(e,t,r){Qe(e);const n={};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=[],l={};for(const h of t)if(h.envelope&&s[h.id]!==!1)for(const[b,Pe]of Object.entries(h.envelope))c[b]=Pe,l[b]=h.id,u.includes(b)||u.push(b);const p={type:"object",properties:a,additionalProperties:!1,...f.length>0?{required:f}:{}},m=i.safe===!0||Xe(i.input),d=i.input.definitions,y=i.input.$defs;n[o]={input:{type:"object",properties:{...c,data:p},required:[...u,...f.length>0?["data"]:[]],additionalProperties:!1,description:Ze(Object.keys(c),Object.keys(a).length>0),...d?{definitions:d}:{},...y?{$defs:y}:{}},output:i.output,...i.hasCtx?{hasCtx:!0}:{},"x-apigen-safe":m,...Object.keys(l).length>0?{"x-apigen-envelope":l}:{}}}return n}const tt={"decimal.js":"Decimal"};function rt(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}Object.entries(tt).map(([e,t])=>({pattern:new RegExp(`import\\(["'][^"']*${rt(e)}[^"']*["']\\)\\.\\w+`,"g"),key:t}));class U extends Error{constructor(t){super(t),this.name="ConfigurationError"}}function ve(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 U(`Middleware "${t.id}" subscribes to its own events via "${r}". This would cause infinite recursion.`)}}function nt(e){const{domainSchemas:t,middlewares:r,overrides:n={},strict:o=!1}=e;ve(r);for(const c of Object.keys(n))if(!(c in t.schemas)){const u=`Override key "${c}" not found in domain schemas.`;if(o)throw new U(u);console.warn("[apigen-runtime]",u)}const i=new Set(r.map(c=>c.id));for(const[c,u]of Object.entries(n))for(const l of Object.keys(u??{}))if(!i.has(l)){const p=`Override key "${c}.${l}" does not match any declared middleware id.`;if(o)throw new U(p);console.warn("[apigen-runtime]",p)}const s=et(t,r,n),a=new ge;return we(r,a),{schemas:s,createClient:async c=>be(r,c,a),dispose:()=>a.clear()}}function ot(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};if(o==="pretty")return i.transport={target:"pino-pretty",options:{colorize:!r,translateTime:"SYS:HH:MM:ss.l",ignore:"pid,hostname",...r?{destination:e.destination,mkdir:!0}:{destination:2}}},O(i);const s=r?O.destination({dest:e.destination,mkdir:!0,sync:!0}):O.destination(2);return O(i,s)}function $e(e){return e?e.type==="array"?`${$e(e.items)}[]`:e.enum?"enum":e.$ref?String(e.$ref).split("/").pop()||"object":e.anyOf||e.oneOf?"union":e.type??"object":"unknown"}function Ne(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])=>({name:f,type:$e(c),required:o.has(f)})),s=i.map(f=>`${f.name}${f.required?"":"?"}: ${f.type}`).join(", ");return{params:i,text:s}}function it(e){let t;return Array.isArray(e)?t=e:e?t=[e]:t=[],t.find(r=>r==="number"||r==="integer"||r==="boolean")}function st(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")continue;const u=it(f==null?void 0:f.type);if(u==="number"||u==="integer"){const l=Number(c);!Number.isNaN(l)&&c.trim()!==""&&(o[a]=l)}else u==="boolean"&&(c==="true"?o[a]=!0:c==="false"&&(o[a]=!1))}return o}const X=new Set(["default","module.exports","__esModule"]);function at(e){const t={},r=(n,o)=>{for(const[i,s]of Object.entries(n))if(typeof s=="function"){!X.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)};return r(e,0),t}const ct=["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)}toJSON(){const t={code:this.code,message:this.message};return this.details!==void 0&&(t.details=this.details),t}}function Oe(e){return typeof e=="object"&&e!==null&&e.name==="ApiError"&&ct.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}}const N=new Ue({allErrors:!0});De(N);for(const e of[L,R,S,x,"discriminator"])N.addKeyword({keyword:e,valid:!0});N.addFormat("decimal",/^[+-]?(?:\d+(?:\.\d+)?|\.\d+)$/);function je(e){return e.map(t=>`${t.instancePath||"(root)"} ${t.message??"failed schema check"}`).join("; ")}const ut=async(e,t)=>{const r=e.ctx.get(Ae);if(r===void 0)return t();const n=e.operation.id,o=r[n];if(o===void 0)return t();const i={data:e.domainArgs,...e.envelope},s=N.compile(o.input);if(!s(i)){const f=s.errors??[];throw new A("invalid_argument",`Validation failed: ${je(f)}`,f)}return t()},Ae=Symbol("ValidateSchemasToken");function _e(e){return async function(r,n){const o=r.operation.id,i=e[o];if(i===void 0)return n();const s={data:r.domainArgs,...r.envelope},a=N.compile(i.input);if(!a(s)){const c=a.errors??[];throw new A("invalid_argument",`Validation failed: ${je(c)}`,c)}return n()}}function ft(){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 lt{constructor(t={}){var n,o;this._store=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))}create(t,r=[],n){const o=new t(...r),i=ft(),s=n??this._defaultTtlMs,a=s!==void 0?Date.now()+s:null;return this._store.set(i,{instance:o,expiresAt:a}),{instanceId:i}}get(t){const r=this._store.get(t);if(!r)throw new Error(`[instance-registry] Unknown instanceId: "${t}"`);if(r.expiresAt!==null&&Date.now()>r.expiresAt)throw this._evict(t,r),new Error(`[instance-registry] Instance "${t}" has expired`);return r.instance}async dispatch(t,r,n=[]){const o=this.get(t),i=o[r];if(typeof i!="function")throw new Error(`[instance-registry] Method "${r}" not found on instance "${t}"`);return i.call(o,...n)}async dispose(t){const r=this._store.get(t);r&&(this._store.delete(t),await C(r.instance))}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])=>C(r.instance)))}get size(){return this._store.size}_sweep(){const t=Date.now();for(const[r,n]of this._store)n.expiresAt!==null&&t>n.expiresAt&&this._evict(r,n)}_evict(t,r){this._store.delete(t),C(r.instance)}}async function C(e){if(e!==null&&typeof e=="object"&&"dispose"in e){const t=e.dispose;typeof t=="function"&&await t.call(e)}}function dt(e){const{produce:t,signal:r}=e,n=r??new AbortController().signal;return{[Symbol.asyncIterator](){const o=t(n);return{async next(){return n.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}},async throw(i){return await o.throw(i),{done:!0,value:void 0}}}}}}async function pt(e){const t=[];for await(const r of e)t.push(r);return t}async function Ee(e){const t=[];try{for await(const r of e)t.push(r);return{ok:!0,chunks:t}}catch(r){const n=Oe(r)?r:new A("internal",r instanceof Error?r.message:String(r));return t.length===0?{ok:!1,carrier:Q("before-first-chunk",n)}:{ok:!1,carrier:Q("after-first-chunk",n,t.length)}}}function Ce(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}}function k(e){const t=e.discriminator;if(t===null||typeof t!="object"||Array.isArray(t))return;const r=t;if(typeof r.propertyName!="string")return;const n=r.mapping;if(!(n===null||typeof n!="object"||Array.isArray(n)))return{propertyName:r.propertyName,mapping:n}}function ke(e,t){const r=e[R];if(typeof r=="string"){const n=t.registry.get(r);if(n)return n}return t.registry.resolve(e)}function yt(e,t,r){const n=ke(t,r);return n?n.encode(e,t,r):e}function mt(e,t,r){const n=ke(t,r);return n?n.decode(e,t,r):e}function Ie(e){const{id:t,schema:r}=e;return{id:t,kind:"union",schema:r,matches(n){if(n[L]==="union")return!0;const o=n.oneOf;return!Array.isArray(o)||o.length===0?!1:k(n)!==void 0},encode(n,o,i){const s=k(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)throw new g("E_UNION_NO_DISCRIMINATOR",`[${t}] value at "${i.path}" is missing the discriminator property "${a}".`);const u=String(c),l=f[u];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(", ")}).`);const p=i.resolve(l);return yt(n,p,{...i,path:`${i.path}[${u}]`})},decode(n,o,i){if(n===null||typeof n!="object"||Array.isArray(n)){let d;throw n===null?d="null":Array.isArray(n)?d="array":d=typeof n,new g("E_UNION_INVALID_WIRE",`[${t}] expected a JSON object on the wire at "${i.path}", got ${d}.`)}const s=n,a=k(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)throw new g("E_UNION_NO_DISCRIMINATOR",`[${t}] wire object at "${i.path}" is missing the discriminator property "${f}".`);const l=String(u),p=c[l];if(!p)throw new g("E_UNION_UNKNOWN_TAG",`[${t}] discriminator tag "${l}" on the wire at "${i.path}" is not in the mapping (known: ${Object.keys(c).join(", ")}).`);const m=i.resolve(p);return mt(n,m,{...i,path:`${i.path}[${l}]`})}}}const ht="x-apigen-instances";class j extends Error{constructor(t,r){super(r),this.name="NominalCodecError",this.code=t}}function Z(e){const t=e.properties;return t&&typeof t=="object"&&!Array.isArray(t)?t:{}}function gt(e){const t=e.required;return Array.isArray(t)?t.filter(r=>typeof r=="string"):[]}function ee(e,t,r){if(t){const n=r.registry.resolve(t);if(n)return n.encode(e,t,r)}return e}function wt(e,t,r){if(t){const n=r.registry.resolve(t);if(n)return n.decode(e,t,r)}return e}function bt(e){const{id:t,schema:r,ctor:n}=e;return{id:t,kind:"nominal",schema:r,matches(o){return o[L]==="nominal"?!0:o[R]===t},encode(o,i,s){if(o===null||typeof o!="object")return o;if(s.seen.has(o)){if(s.mode==="strict")throw new j("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.`);return null}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 d=c.call(o);if(d!==null&&typeof d=="object"&&!Array.isArray(d)){const y={};for(const[h,b]of Object.entries(d))y[h]=ee(b,a[h],{...s,path:`${s.path}/${h}`});return y}return d}const u={},l=Object.keys(a),p=o,m=l.length>0?l:Object.keys(p);for(const d of m){const y=p[d];y!==void 0&&(u[d]=ee(y,a[d],{...s,path:`${s.path}/${d}`}))}return u}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 j("E_NOMINAL_INVALID_WIRE",`[${t}] expected a JSON object on the wire at "${s.path}", got ${u}.`)}const a=o;for(const u of gt(i))if(!(u in a))throw new j("E_NOMINAL_INVALID_WIRE",`[${t}] required field "${u}" missing on the wire at "${s.path}".`);if(i[ht]===!1)throw new j("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,l]of Object.entries(a))c[u]=wt(l,f[u],{...s,path:`${s.path}/${u}`});if(n){const u=typeof i[S]=="string"?i[S]:"fromJSON",l=n[u];if(typeof l=="function")return l.call(n,c);const p=n;return new p(c)}return c}}}const Se=[B,F,q,H,K,W],vt={type:"object","x-apigen-logical":"nominal","x-apigen-codec":"ts.NominalSentinel"},te=bt({id:"ts.NominalSentinel",schema:vt}),$t={oneOf:[],discriminator:{propertyName:"kind",mapping:{}},"x-apigen-logical":"union","x-apigen-codec":"ts.UnionSentinel"},re=Ie({id:"ts.UnionSentinel",schema:$t});function Nt(){const e=[...Se.map(t=>[t.id,t]),[te.id,te],[re.id,re]];return Object.freeze(new Map(e))}const Ot=Object.freeze({host:"ts",logicalTypeVersion:Re,codecs:Nt()});function jt(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);return o.length>0?o.join(" — "):e}function At(e){if(!e||typeof e!="object"||Array.isArray(e)||Object.keys(e).length===0)return{outputSchema:void 0,wrapped:!1};const t=e;return t.type==="object"?{outputSchema:t,wrapped:!1}:{outputSchema:{type:"object",properties:{result:t},required:["result"]},wrapped:!0}}function _t(e,t){return e?{result:t}:t&&typeof t=="object"&&!Array.isArray(t)?t:void 0}const xe=4,Me=32;function D(e){return Oe(e)?e:e instanceof Error?new A("internal",e.message):e}function Et(e,t){if(e==="serial"||e==="chained")return 1;const r=t??xe;return!Number.isFinite(r)||r<1?1:Math.min(Math.floor(r),Me)}function Ct(){}function kt(e,t){var i;if(!e&&!t)return{signal:void 0,dispose:Ct};const r=new AbortController,n=()=>{r.abort(e==null?void 0:e.reason)};e&&(e.aborted?r.abort(e.reason):e.addEventListener("abort",n,{once:!0}));let o;return t!==void 0&&!r.signal.aborted&&(o=setTimeout(()=>{r.abort(new DOMException(`apigen/invokeBatch: item timed out after ${t}ms`,"TimeoutError"))},t),(i=o.unref)==null||i.call(o)),{signal:r.signal,dispose(){e&&e.removeEventListener("abort",n),o&&clearTimeout(o)}}}async function ne(e,t,r,n,o,i){const s=kt(n.signal,i);try{const a=s.signal?{...n,signal:s.signal}:n,f=await e(t,a,o);if(Ce(f)){const c=await Ee(f);if(c.ok)return{index:r,status:"fulfilled",chunks:c.chunks};const u=c.carrier;return{index:r,status:"rejected",reason:D(u.error),...u.phase==="after-first-chunk"?{chunksDelivered:u.chunksDelivered}:{}}}return{index:r,status:"fulfilled",value:f}}catch(a){return{index:r,status:"rejected",reason:D(a)}}finally{s.dispose()}}async function It(e,t,r,n,o={}){const i=o.mode??"parallel",s=o.onItemError??"continue",a=Et(i,o.concurrency),f=new Array(r.length),c=d=>({index:d,status:"rejected",reason:D(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 d=!1;for(let y=0;y<r.length;y++){if(d){f[y]=c(y);continue}const h=await ne(e,t,y,r[y],n,o.itemTimeoutMs);f[y]=h,h.status==="rejected"&&(i==="chained"||s==="abort")&&(d=!0)}return f}let u=0,l=!1;const p=Math.max(1,Math.min(a,r.length)),m=Array.from({length:p},async()=>{for(;;){const d=u++;if(d>=r.length)return;if(l){f[d]=c(d);continue}const y=await ne(e,t,d,r[d],n,o.itemTimeoutMs);f[d]=y,y.status==="rejected"&&s==="abort"&&(l=!0)}});return await Promise.all(m),f}const oe=new Set(["string","number","boolean","integer"]);function St(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}function xt(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(St)}const Mt={"decimal.js":"Decimal"};function Tt(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}Object.entries(Mt).map(([e,t])=>({pattern:new RegExp(`import\\(["'][^"']*${Tt(e)}[^"']*["']\\)\\.\\w+`,"g"),key:t}));function ie(e){return e.words.join("-")}function se(e){return e.words.map(Rt).join("")}function ae(e){return e.words.join("_")}function Pt(e,t={}){var r,n;const o=[e.namespace,...e.path],i=e.safe||xt(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]),l=se(o[o.length-1]),p=o.map(m=>ie(m));return{http:{verb:s,route:a},mcp:{name:f},grpc:{package:c,service:u,method:l},cli:{path:p}}}function Ut(e,t){return`x-${e}-${t}`}function Dt(e,t){return`--${e}-${t}`}function Lt(e,t){const r=n=>n.toUpperCase().replace(/-/g,"_");return e==="adhd"?`APIGEN_${r(t)}`:`APIGEN_${r(e)}_${r(t)}`}function Rt(e){return e.length===0?e:e[0].toUpperCase()+e.slice(1)}function z(e){return e.anyOf??e.oneOf}function Bt(e){if(!e)return!1;if(e.type==="array"||e.type==="object")return!0;const t=z(e);if(t){const r=t.filter(n=>n.type!=="null");return r.length>0&&r.every(n=>n.type==="array"||n.type==="object")}return!1}function Ft(e){if(!e)return!1;if(e.type==="boolean")return!0;const t=z(e);if(t){const r=t.filter(n=>n.type!=="null");return r.length>0&&r.every(n=>n.type==="boolean")}return!1}function qt(e){if(!e)return!1;if(e.type==="number"||e.type==="integer")return!0;const t=z(e);if(t){const r=t.filter(n=>n.type!=="null");return r.length>0&&r.every(n=>n.type==="number"||n.type==="integer")}return!1}function Ht(e){return e.replace(/[A-Z]/g,t=>"-"+t.toLowerCase())}function Kt(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}}function ce(e){return typeof e.handler=="function"}function Wt(e){var o;const t=((o=e.input)==null?void 0:o.properties)??{},r=e["x-apigen-envelope"],n=[];for(const i of Object.keys(t)){if(i==="data")continue;const s=(r==null?void 0:r[i])??"adhd",a=Ut(s,i);n.push({field:i,pluginId:s,httpHeader:a,mcpMetaKey:a,cliFlag:Dt(s,i),envVar:Lt(s,i)})}return n}function zt(e,t){const r=new Map,{props:n}=Kt(e);for(const[o,i]of Object.entries(n)){let s="string";Ft(i)?s="boolean":(Bt(i)||qt(i))&&(s="json"),r.set(Ht(o),{camelKey:o,kind:"domain",valueKind:s})}for(const o of t){const i=o.cliFlag.replace(/^--/,"");r.set(i,{camelKey:o.field,kind:"envelope",valueKind:"string",envVar:o.envVar})}return r}function Vt(e){const{op:t,schema:r,transport:n,projection:o}=e,i=Pt(t,o),s=r?Wt(r):[],a=r?zt(r,s):new Map,f=r?Ne(r).params:void 0,c={op:t,transport:n,http:i.http,mcp:i.mcp,cli:i.cli,grpc:i.grpc,params:f,envelope:s,cliFlags:a,streaming:t.streaming,isMount:ce(t)};if(ce(t)){const u=t.handler;c.mountHandler=async l=>u(l)}return c}function Gt(e){const t=e.usePlugins;return Array.isArray(t)?t:[]}function Jt(e){const t=e.useOptions;return t&&typeof t=="object"?t:{}}function Te(e){return async function(r,n){const o=Object.assign(r,{data:r.domainArgs});return await e.layer(o,n)}}function Yt(e,t){var n;const r=[];for(const o of t){const i=(n=o.capabilities)==null?void 0:n.layer;i&&r.push(Te(i))}return r.push(_e(e)),he(r)}function Xt(){const e=new Map;return{get:t=>e.get(t),set:(t,r)=>{e.set(t,r)}}}const Qt={input:{type:"object",properties:{data:{type:"object",properties:{}}}},output:{}};async function Zt(e,t,r,n){const o={...r,operation:{id:e.op.id},ctx:new me};if(e.isMount){const i=e.mountHandler;if(!i)throw new Error(`apigen-engine-runtime/dispatchForPlan: OpPlan for mount op "${e.op.id}" has isMount=true but no mountHandler`);const s={operation:e.op,data:r.domainArgs,envelope:r.envelope,ctx:Xt(),transport:e.transport,signal:r.signal??new AbortController().signal},a={...n,fns:{[e.op.id]:()=>i(s)},schemas:{[e.op.id]:Qt}};return t(e.op.id,o,a)}return t(e.op.id,o,n)}exports.BATCH_DEFAULT_CONCURRENCY=xe;exports.BATCH_MAX_CONCURRENCY=Me;exports.EventBus=ge;exports.InstanceRegistry=lt;exports.LayerContext=me;exports.UnionCodecError=g;exports.ValidateSchemasToken=Ae;exports.WELL_KNOWN_TS_CODECS=Se;exports.adaptCoreLayer=Te;exports.assertNoSelfSubscription=ve;exports.buildContext=be;exports.buildFnTable=at;exports.buildMcpOutputSchema=At;exports.buildOpPlan=Vt;exports.buildToolDescription=jt;exports.coerceQueryParams=st;exports.collectWithPhase=Ee;exports.createApiPackage=nt;exports.createInvoker=he;exports.createLogger=ot;exports.createPackageInvoker=Yt;exports.createStream=dt;exports.createUnionCodec=Ie;exports.dataParamNames=pe;exports.defineMiddleware=Ge;exports.describeParams=Ne;exports.dispatch=ye;exports.dispatchForPlan=Zt;exports.drainStream=pt;exports.invokeBatch=It;exports.isApiStream=Ce;exports.makeValidateLayer=_e;exports.needsEnvelopeField=de;exports.readUseOptions=Jt;exports.readUsePlugins=Gt;exports.tsHostBinding=Ot;exports.validateLayer=ut;exports.wireObservers=we;exports.wrapMcpStructuredContent=_t;

package/index.mjs

@@ -2,11 +2,11 @@ import "ts-morph";
 import "node:fs";
 import "node:path";
 import "ts-json-schema-generator";
-import O from "pino";
+import N from "pino";
 import ge from "ajv";
 import we from "ajv-formats";
 const C = "$apigen";
-class V extends Error {
+class W extends Error {
   constructor(t) {
     super(t), this.code = "E_DUP_CODEC", this.name = "CodecRegistryError";
   }
@@ -16,7 +16,7 @@ function be(e) {
   return {
     register(r, n) {
       if (t.has(r.id) && !(n != null && n.override))
-        throw new V(
+        throw new W(
           `E_DUP_CODEC: a codec is already registered for id "${r.id}"`
         );
       t.set(r.id, r);
@@ -35,7 +35,7 @@ function be(e) {
     freeze() {
       const r = new Map(t), n = {
         register() {
-          throw new V(
+          throw new W(
             "E_DUP_CODEC: registry is frozen and cannot accept new codecs"
           );
         },
@@ -59,7 +59,7 @@ function be(e) {
   };
 }
 const L = "x-apigen-logical", R = "x-apigen-codec", S = "x-apigen-ctor", x = "x-apigen-tojson", ve = "0.1.0";
-function W(e, t) {
+function G(e, t) {
   return {
     registry: e,
     resolve: (r) => {
@@ -84,7 +84,7 @@ function v(e, t, r) {
   }
   const i = t.oneOf;
   if (Array.isArray(i)) {
-    const a = ce(e, i, t);
+    const a = ue(e, i, t);
     return v(e, a, r);
   }
   const s = t.type;
@@ -110,8 +110,8 @@ function v(e, t, r) {
       return w(e);
     const f = r.path, c = {};
     for (const [u, p] of Object.entries(a)) {
-      const l = e[u];
-      l !== void 0 && (c[u] = v(l, p, {
+      const d = e[u];
+      d !== void 0 && (c[u] = v(d, p, {
         ...r,
         path: `${f}/${u}`
       }));
@@ -131,7 +131,7 @@ function $(e, t, r) {
   }
   const i = t.oneOf;
   if (Array.isArray(i)) {
-    const a = ce(e, i, t);
+    const a = ue(e, i, t);
     return $(e, a, r);
   }
   const s = t.type;
@@ -157,8 +157,8 @@ function $(e, t, r) {
       return e;
     const f = r.path, c = {};
     for (const [u, p] of Object.entries(a)) {
-      const l = e[u];
-      l !== void 0 && (c[u] = $(l, p, {
+      const d = e[u];
+      d !== void 0 && (c[u] = $(d, p, {
         ...r,
         path: `${f}/${u}`
       }));
@@ -167,7 +167,7 @@ function $(e, t, r) {
   }
   return s == null ? $e(e, r) : e;
 }
-function ce(e, t, r, n) {
+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;
@@ -218,11 +218,11 @@ function w(e) {
 function je(e) {
   return {
     encode(t, r, n) {
-      const o = W(e, n);
+      const o = G(e, n);
       return v(t, r, o);
     },
     decode(t, r, n) {
-      const o = W(e, n);
+      const o = G(e, n);
       return $(t, r, o);
     }
   };
@@ -331,7 +331,7 @@ const B = {
       );
     return new Uint8Array(Buffer.from(e, "base64"));
   }
-}, Oe = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/, q = {
+}, Ne = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/, q = {
   id: "uuid",
   kind: "scalar",
   schema: { type: "string", format: "uuid" },
@@ -349,13 +349,13 @@ const B = {
         );
       return String(e).toLowerCase();
     }
-    if (r.mode === "strict" && !Oe.test(e))
+    if (r.mode === "strict" && !Ne.test(e))
       throw new TypeError(
         `[uuid] wire value "${e}" at "${r.path}" is not a lowercase-hyphenated RFC 4122 UUID`
       );
     return e;
   }
-}, M = "NaN", T = "Infinity", P = "-Infinity", Ne = /* @__PURE__ */ new Set([
+}, M = "NaN", T = "Infinity", P = "-Infinity", Oe = /* @__PURE__ */ new Set([
   M,
   T,
   P
@@ -385,7 +385,7 @@ const B = {
     }
     if (r.mode === "strict")
       throw new TypeError(
-        `[number-special] unrecognized wire value at "${r.path}": ${JSON.stringify(e)}. Expected a number or one of ${[...Ne].join(", ")}.`
+        `[number-special] unrecognized wire value at "${r.path}": ${JSON.stringify(e)}. Expected a number or one of ${[...Oe].join(", ")}.`
       );
     return NaN;
   }
@@ -407,9 +407,9 @@ K.id, // 'decimal'
 H.id, // 'byte'
 q.id, // 'uuid'
 z.id;
-const ue = be();
-_e(ue);
-const fe = je(ue.freeze());
+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) ?? {};
@@ -426,11 +426,11 @@ function Ie(e, t) {
   return n !== void 0 ? n : void 0;
 }
 function Ce(e, t) {
-  return t === void 0 || e === void 0 ? e : fe.decode(e, t);
+  return t === void 0 || e === void 0 ? e : pe.decode(e, t);
 }
 function E(e, t) {
   const r = t.output;
-  return !r || Object.keys(r).length === 0 ? e : fe.encode(e, r);
+  return !r || Object.keys(r).length === 0 ? e : pe.encode(e, r);
 }
 async function Se(e, t, r, n, o, i) {
   const a = ke(r).map(
@@ -483,7 +483,7 @@ function Me(e = []) {
     )();
   };
 }
-function Ft(e) {
+function Kt(e) {
   return e;
 }
 class Te {
@@ -558,7 +558,7 @@ async function Ue(e, t, r) {
     }
   return n;
 }
-function G(e, t) {
+function J(e, t) {
   const r = /* @__PURE__ */ new Set(), n = [e];
   for (; n.length > 0; ) {
     const o = n.pop();
@@ -570,9 +570,9 @@ function G(e, t) {
       if (t) {
         const p = t[i];
         if (!p) {
-          const l = Object.keys(t).join(", ") || "(none)";
+          const d = Object.keys(t).join(", ") || "(none)";
           throw new Error(
-            `[apigen-logical] $ref "${i}" cannot be resolved. Available $defs: ${l}`
+            `[apigen-logical] $ref "${i}" cannot be resolved. Available $defs: ${d}`
           );
         }
         n.push(p);
@@ -599,7 +599,7 @@ function G(e, t) {
     typeof u == "object" && u !== null && n.push(u);
   }
 }
-const J = /* @__PURE__ */ new Set(["string", "number", "boolean", "integer"]);
+const Y = /* @__PURE__ */ new Set(["string", "number", "boolean", "integer"]);
 function Le(e) {
   if (typeof e != "object" || e === null)
     return !1;
@@ -607,7 +607,7 @@ function Le(e) {
   if (t.$ref !== void 0 || t.oneOf || t.anyOf || t.allOf)
     return !1;
   const { type: r } = t;
-  return typeof r == "string" ? J.has(r) : Array.isArray(r) ? r.every((n) => J.has(n) || n === "null") : Array.isArray(t.enum) && t.enum.length > 0 ? t.enum.every((n) => ["string", "number", "boolean"].includes(typeof n)) : !1;
+  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;
 }
 function Re(e) {
   if (!e || typeof e != "object")
@@ -633,7 +633,7 @@ function Be(e) {
   if (Object.keys(t).length !== 0)
     for (const [n, o] of Object.entries(e.schemas))
       try {
-        G(o.input, t), G(o.output, t);
+        J(o.input, t), J(o.output, t);
       } catch (i) {
         throw new Error(
           `[apigen-core-client] Schema validation failed for function "${n}": ${i.message}`
@@ -657,16 +657,16 @@ function Ke(e, t, r) {
       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 l = {
+    const d = {
       type: "object",
       properties: a,
       additionalProperties: !1,
       ...f.length > 0 ? { required: f } : {}
-    }, m = i.safe === !0 || Re(i.input), d = i.input.definitions, y = i.input.$defs;
+    }, m = i.safe === !0 || Re(i.input), l = i.input.definitions, y = i.input.$defs;
     n[o] = {
       input: {
         type: "object",
-        properties: { ...c, data: l },
+        properties: { ...c, data: d },
         required: [
           ...u,
           ...f.length > 0 ? ["data"] : []
@@ -679,7 +679,7 @@ function Ke(e, t, r) {
           Object.keys(c),
           Object.keys(a).length > 0
         ),
-        ...d ? { definitions: d } : {},
+        ...l ? { definitions: l } : {},
         ...y ? { $defs: y } : {}
       },
       output: i.output,
@@ -729,7 +729,7 @@ function ze(e) {
         );
     }
 }
-function Kt(e) {
+function Ht(e) {
   const {
     domainSchemas: t,
     middlewares: r,
@@ -748,10 +748,10 @@ function Kt(e) {
   for (const [c, u] of Object.entries(n))
     for (const p of Object.keys(u ?? {}))
       if (!i.has(p)) {
-        const l = `Override key "${c}.${p}" does not match any declared middleware id.`;
+        const d = `Override key "${c}.${p}" does not match any declared middleware id.`;
         if (o)
-          throw new D(l);
-        console.warn("[apigen-runtime]", l);
+          throw new D(d);
+        console.warn("[apigen-runtime]", d);
       }
   const s = Ke(
     t,
@@ -760,7 +760,7 @@ function Kt(e) {
   ), a = new Te();
   return De(r, a), { schemas: s, createClient: async (c) => Ue(r, c, a), dispose: () => a.clear() };
 }
-function Ht(e = {}) {
+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 };
   if (o === "pretty")
     return i.transport = {
@@ -771,18 +771,18 @@ function Ht(e = {}) {
         ignore: "pid,hostname",
         ...r ? { destination: e.destination, mkdir: !0 } : { destination: 2 }
       }
-    }, O(i);
-  const s = r ? O.destination({ dest: e.destination, mkdir: !0, sync: !0 }) : O.destination(2);
-  return O(i, s);
+    }, N(i);
+  const s = r ? N.destination({ dest: e.destination, mkdir: !0, sync: !0 }) : N.destination(2);
+  return N(i, s);
 }
-function pe(e) {
-  return e ? e.type === "array" ? `${pe(e.items)}[]` : e.enum ? "enum" : e.$ref ? String(e.$ref).split("/").pop() || "object" : e.anyOf || e.oneOf ? "union" : e.type ?? "object" : "unknown";
+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 Ve(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]) => ({
     name: f,
-    type: pe(c),
+    type: le(c),
     required: o.has(f)
   })), s = i.map((f) => `${f.name}${f.required ? "" : "?"}: ${f.type}`).join(", ");
   return { params: i, text: s };
@@ -791,7 +791,7 @@ function We(e) {
   let t;
   return Array.isArray(e) ? t = e : e ? t = [e] : t = [], t.find((r) => r === "number" || r === "integer" || r === "boolean");
 }
-function qt(e, t) {
+function zt(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)) {
@@ -807,16 +807,16 @@ function qt(e, t) {
   }
   return o;
 }
-const Y = /* @__PURE__ */ new Set(["default", "module.exports", "__esModule"]);
-function zt(e) {
+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))
       if (typeof s == "function") {
-        !Y.has(i) && !(i in t) && (t[i] = s);
+        !X.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 && Y.has(i) && r(s, o + 1);
+        s && typeof s == "object" && o < 2 && X.has(i) && r(s, o + 1);
   };
   return r(e, 0), t;
 }
@@ -843,7 +843,7 @@ class A extends Error {
 function de(e) {
   return typeof e == "object" && e !== null && e.name === "ApiError" && Ge.includes(e.code) && typeof e.toJSON == "function";
 }
-function X(e, t, r = 0) {
+function Q(e, t, r = 0) {
   return e === "before-first-chunk" ? { phase: e, error: t } : { phase: e, error: t, chunksDelivered: r };
 }
 const j = new ge({ allErrors: !0 });
@@ -857,12 +857,12 @@ for (const e of [
 ])
   j.addKeyword({ keyword: e, valid: !0 });
 j.addFormat("decimal", /^[+-]?(?:\d+(?:\.\d+)?|\.\d+)$/);
-function le(e) {
+function ye(e) {
   return e.map(
     (t) => `${t.instancePath || "(root)"} ${t.message ?? "failed schema check"}`
   ).join("; ");
 }
-const Vt = async (e, t) => {
+const Wt = async (e, t) => {
   const r = e.ctx.get(Je);
   if (r === void 0)
     return t();
@@ -877,7 +877,7 @@ const Vt = async (e, t) => {
     const f = s.errors ?? [];
     throw new A(
       "invalid_argument",
-      `Validation failed: ${le(f)}`,
+      `Validation failed: ${ye(f)}`,
       f
     );
   }
@@ -896,7 +896,7 @@ function Ye(e) {
       const c = a.errors ?? [];
       throw new A(
         "invalid_argument",
-        `Validation failed: ${le(c)}`,
+        `Validation failed: ${ye(c)}`,
         c
       );
     }
@@ -909,7 +909,7 @@ function Xe() {
     return (e === "x" ? t : t & 3 | 8).toString(16);
   });
 }
-class Wt {
+class Gt {
   constructor(t = {}) {
     var n, o;
     this._store = /* @__PURE__ */ new Map(), this._sweeper = null, this._defaultTtlMs = t.defaultTtlMs;
@@ -1016,7 +1016,7 @@ async function k(e) {
     typeof t == "function" && await t.call(e);
   }
 }
-function Gt(e) {
+function Jt(e) {
   const { produce: t, signal: r } = e, n = r ?? new AbortController().signal;
   return {
     [Symbol.asyncIterator]() {
@@ -1035,7 +1035,7 @@ function Gt(e) {
     }
   };
 }
-async function Jt(e) {
+async function Yt(e) {
   const t = [];
   for await (const r of e)
     t.push(r);
@@ -1054,10 +1054,10 @@ async function Qe(e) {
     );
     return t.length === 0 ? {
       ok: !1,
-      carrier: X("before-first-chunk", n)
+      carrier: Q("before-first-chunk", n)
     } : {
       ok: !1,
-      carrier: X("after-first-chunk", n, t.length)
+      carrier: Q("after-first-chunk", n, t.length)
     };
   }
 }
@@ -1083,7 +1083,7 @@ function I(e) {
       mapping: n
     };
 }
-function ye(e, t) {
+function me(e, t) {
   const r = e[R];
   if (typeof r == "string") {
     const n = t.registry.get(r);
@@ -1093,11 +1093,11 @@ function ye(e, t) {
   return t.registry.resolve(e);
 }
 function et(e, t, r) {
-  const n = ye(t, r);
+  const n = me(t, r);
   return n ? n.encode(e, t, r) : e;
 }
 function tt(e, t, r) {
-  const n = ye(t, r);
+  const n = me(t, r);
   return n ? n.decode(e, t, r) : e;
 }
 function rt(e) {
@@ -1136,18 +1136,18 @@ function rt(e) {
           "E_UNION_UNKNOWN_TAG",
           `[${t}] discriminator tag "${u}" at "${i.path}" is not in the mapping (known: ${Object.keys(f).join(", ")}).`
         );
-      const l = i.resolve(p);
-      return et(n, l, {
+      const d = i.resolve(p);
+      return et(n, d, {
         ...i,
         path: `${i.path}[${u}]`
       });
     },
     decode(n, o, i) {
       if (n === null || typeof n != "object" || Array.isArray(n)) {
-        let d;
-        throw n === null ? d = "null" : Array.isArray(n) ? d = "array" : d = typeof n, new g(
+        let l;
+        throw n === null ? l = "null" : Array.isArray(n) ? l = "array" : l = typeof n, new g(
           "E_UNION_INVALID_WIRE",
-          `[${t}] expected a JSON object on the wire at "${i.path}", got ${d}.`
+          `[${t}] expected a JSON object on the wire at "${i.path}", got ${l}.`
         );
       }
       const s = n, a = I(o);
@@ -1162,13 +1162,13 @@ function rt(e) {
           "E_UNION_NO_DISCRIMINATOR",
           `[${t}] wire object at "${i.path}" is missing the discriminator property "${f}".`
         );
-      const p = String(u), l = c[p];
-      if (!l)
+      const p = String(u), d = c[p];
+      if (!d)
         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(", ")}).`
         );
-      const m = i.resolve(l);
+      const m = i.resolve(d);
       return tt(n, m, {
         ...i,
         path: `${i.path}[${p}]`
@@ -1177,12 +1177,12 @@ function rt(e) {
   };
 }
 const nt = "x-apigen-instances";
-class N extends Error {
+class O extends Error {
   constructor(t, r) {
     super(r), this.name = "NominalCodecError", this.code = t;
   }
 }
-function Q(e) {
+function Z(e) {
   const t = e.properties;
   return t && typeof t == "object" && !Array.isArray(t) ? t : {};
 }
@@ -1190,7 +1190,7 @@ function ot(e) {
   const t = e.required;
   return Array.isArray(t) ? t.filter((r) => typeof r == "string") : [];
 }
-function Z(e, t, r) {
+function ee(e, t, r) {
   if (t) {
     const n = r.registry.resolve(t);
     if (n)
@@ -1227,7 +1227,7 @@ function st(e) {
         return o;
       if (s.seen.has(o)) {
         if (s.mode === "strict")
-          throw new N(
+          throw new O(
             "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,28 +1235,28 @@ function st(e) {
       }
       s.seen.add(o);
       try {
-        const a = Q(i), f = typeof i[x] == "string" ? i[x] : "toJSON", c = o[f];
+        const a = Z(i), f = typeof i[x] == "string" ? i[x] : "toJSON", c = o[f];
         if (typeof c == "function") {
-          const d = c.call(o);
-          if (d !== null && typeof d == "object" && !Array.isArray(d)) {
+          const l = c.call(o);
+          if (l !== null && typeof l == "object" && !Array.isArray(l)) {
             const y = {};
             for (const [h, b] of Object.entries(
-              d
+              l
             ))
-              y[h] = Z(b, a[h], {
+              y[h] = ee(b, a[h], {
                 ...s,
                 path: `${s.path}/${h}`
               });
             return y;
           }
-          return d;
+          return l;
         }
-        const u = {}, p = Object.keys(a), l = o, m = p.length > 0 ? p : Object.keys(l);
-        for (const d of m) {
-          const y = l[d];
-          y !== void 0 && (u[d] = Z(y, a[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], {
             ...s,
-            path: `${s.path}/${d}`
+            path: `${s.path}/${l}`
           }));
         }
         return u;
@@ -1267,7 +1267,7 @@ function st(e) {
     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 N(
+        throw o === null ? u = "null" : Array.isArray(o) ? u = "array" : u = typeof o, new O(
           "E_NOMINAL_INVALID_WIRE",
           `[${t}] expected a JSON object on the wire at "${s.path}", got ${u}.`
         );
@@ -1275,16 +1275,16 @@ function st(e) {
       const a = o;
       for (const u of ot(i))
         if (!(u in a))
-          throw new N(
+          throw new O(
             "E_NOMINAL_INVALID_WIRE",
             `[${t}] required field "${u}" missing on the wire at "${s.path}".`
           );
       if (i[nt] === !1)
-        throw new N(
+        throw new O(
           "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 = Q(i), c = {};
+      const f = Z(i), c = {};
       for (const [u, p] of Object.entries(a))
         c[u] = it(p, f[u], {
           ...s,
@@ -1297,8 +1297,8 @@ function st(e) {
             n,
             c
           );
-        const l = n;
-        return new l(c);
+        const d = n;
+        return new d(c);
       }
       return c;
     }
@@ -1315,7 +1315,7 @@ const at = [
   type: "object",
   "x-apigen-logical": "nominal",
   "x-apigen-codec": "ts.NominalSentinel"
-}, ee = st({
+}, te = st({
   id: "ts.NominalSentinel",
   schema: ct
 }), ut = {
@@ -1323,7 +1323,7 @@ const at = [
   discriminator: { propertyName: "kind", mapping: {} },
   "x-apigen-logical": "union",
   "x-apigen-codec": "ts.UnionSentinel"
-}, te = rt({
+}, re = rt({
   id: "ts.UnionSentinel",
   schema: ut
 });
@@ -1335,25 +1335,25 @@ function ft() {
       t
     ]),
     // nominal kind sentinel
-    [ee.id, ee],
+    [te.id, te],
     // union kind sentinel
-    [te.id, te]
+    [re.id, re]
   ];
   return Object.freeze(new Map(e));
 }
-const Yt = Object.freeze({
+const Xt = Object.freeze({
   host: "ts",
   logicalTypeVersion: ve,
   codecs: ft()
 });
-function Xt(e, t, r) {
+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
   );
   return o.length > 0 ? o.join(" — ") : e;
 }
-function Qt(e) {
+function Zt(e) {
   if (!e || typeof e != "object" || Array.isArray(e) || Object.keys(e).length === 0)
     return { outputSchema: void 0, wrapped: !1 };
   const t = e;
@@ -1366,18 +1366,18 @@ function Qt(e) {
     wrapped: !0
   };
 }
-function Zt(e, t) {
+function er(e, t) {
   return e ? { result: t } : t && typeof t == "object" && !Array.isArray(t) ? t : void 0;
 }
-const pt = 4, dt = 32;
+const pt = 4, lt = 32;
 function U(e) {
   return de(e) ? e : e instanceof Error ? new A("internal", e.message) : e;
 }
-function lt(e, t) {
+function dt(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), dt);
+  return !Number.isFinite(r) || r < 1 ? 1 : Math.min(Math.floor(r), lt);
 }
 function yt() {
 }
@@ -1404,7 +1404,7 @@ function mt(e, t) {
     }
   };
 }
-async function re(e, t, r, n, o, i) {
+async function ne(e, t, r, n, o, i) {
   const s = mt(n.signal, i);
   try {
     const a = s.signal ? { ...n, signal: s.signal } : n, f = await e(t, a, o);
@@ -1427,9 +1427,9 @@ async function re(e, t, r, n, o, i) {
     s.dispose();
   }
 }
-async function er(e, t, r, n, o = {}) {
-  const i = o.mode ?? "parallel", s = o.onItemError ?? "continue", a = lt(i, o.concurrency), f = new Array(r.length), c = (d) => ({
-    index: d,
+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,
     status: "rejected",
     reason: U(
       new Error(
@@ -1438,13 +1438,13 @@ async function er(e, t, r, n, o = {}) {
     )
   });
   if (i === "serial" || i === "chained") {
-    let d = !1;
+    let l = !1;
     for (let y = 0; y < r.length; y++) {
-      if (d) {
+      if (l) {
         f[y] = c(y);
         continue;
       }
-      const h = await re(
+      const h = await ne(
         e,
         t,
         y,
@@ -1452,34 +1452,34 @@ async function er(e, t, r, n, o = {}) {
         n,
         o.itemTimeoutMs
       );
-      f[y] = h, h.status === "rejected" && (i === "chained" || s === "abort") && (d = !0);
+      f[y] = h, h.status === "rejected" && (i === "chained" || s === "abort") && (l = !0);
     }
     return f;
   }
   let u = 0, p = !1;
-  const l = Math.max(1, Math.min(a, r.length)), m = Array.from({ length: l }, async () => {
+  const d = Math.max(1, Math.min(a, r.length)), m = Array.from({ length: d }, async () => {
     for (; ; ) {
-      const d = u++;
-      if (d >= r.length)
+      const l = u++;
+      if (l >= r.length)
         return;
       if (p) {
-        f[d] = c(d);
+        f[l] = c(l);
         continue;
       }
-      const y = await re(
+      const y = await ne(
         e,
         t,
-        d,
-        r[d],
+        l,
+        r[l],
         n,
         o.itemTimeoutMs
       );
-      f[d] = y, y.status === "rejected" && s === "abort" && (p = !0);
+      f[l] = y, y.status === "rejected" && s === "abort" && (p = !0);
     }
   });
   return await Promise.all(m), f;
 }
-const ne = /* @__PURE__ */ new Set(["string", "number", "boolean", "integer"]);
+const oe = /* @__PURE__ */ new Set(["string", "number", "boolean", "integer"]);
 function ht(e) {
   if (typeof e != "object" || e === null)
     return !1;
@@ -1487,7 +1487,7 @@ function ht(e) {
   if (t.$ref !== void 0 || t.oneOf || t.anyOf || t.allOf)
     return !1;
   const { type: r } = t;
-  return typeof r == "string" ? ne.has(r) : Array.isArray(r) ? r.every((n) => ne.has(n) || n === "null") : Array.isArray(t.enum) && t.enum.length > 0 ? t.enum.every((n) => ["string", "number", "boolean"].includes(typeof n)) : !1;
+  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;
 }
 function gt(e) {
   if (!e || typeof e != "object")
@@ -1516,23 +1516,23 @@ Object.entries(wt).map(([e, t]) => ({
   ),
   key: t
 }));
-function oe(e) {
-  return e.words.join("-");
-}
 function ie(e) {
-  return e.words.map(Nt).join("");
+  return e.words.join("-");
 }
 function se(e) {
+  return e.words.map(Ot).join("");
+}
+function ae(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) => oe(m)).join("/"), f = o.map((m) => se(m)).join("_"), c = o.map((m) => se(m)).slice(0, -1).join("."), u = ie(o[o.length - 2] ?? o[0]), p = ie(o[o.length - 1]), l = o.map((m) => oe(m));
+  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));
   return {
     http: { verb: s, route: a },
     mcp: { name: f },
     grpc: { package: c, service: u, method: p },
-    cli: { path: l }
+    cli: { path: d }
   };
 }
 function $t(e, t) {
@@ -1541,14 +1541,14 @@ function $t(e, t) {
 function jt(e, t) {
   return `--${e}-${t}`;
 }
-function Ot(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 Nt(e) {
+function Ot(e) {
   return e.length === 0 ? e : e[0].toUpperCase() + e.slice(1);
 }
-function me(e) {
+function V(e) {
   return e.anyOf ?? e.oneOf;
 }
 function At(e) {
@@ -1556,7 +1556,7 @@ function At(e) {
     return !1;
   if (e.type === "array" || e.type === "object")
     return !0;
-  const t = me(e);
+  const t = V(e);
   if (t) {
     const r = t.filter((n) => n.type !== "null");
     return r.length > 0 && r.every((n) => n.type === "array" || n.type === "object");
@@ -1568,7 +1568,7 @@ function _t(e) {
     return !1;
   if (e.type === "boolean")
     return !0;
-  const t = me(e);
+  const t = V(e);
   if (t) {
     const r = t.filter((n) => n.type !== "null");
     return r.length > 0 && r.every((n) => n.type === "boolean");
@@ -1576,17 +1576,29 @@ function _t(e) {
   return !1;
 }
 function Et(e) {
-  return e.replace(/[A-Z]/g, (t) => "-" + t.toLowerCase());
+  if (!e)
+    return !1;
+  if (e.type === "number" || e.type === "integer")
+    return !0;
+  const t = V(e);
+  if (t) {
+    const r = t.filter((n) => n.type !== "null");
+    return r.length > 0 && r.every((n) => n.type === "number" || n.type === "integer");
+  }
+  return !1;
 }
 function kt(e) {
+  return e.replace(/[A-Z]/g, (t) => "-" + t.toLowerCase());
+}
+function It(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 };
 }
-function ae(e) {
+function ce(e) {
   return typeof e.handler == "function";
 }
-function It(e) {
+function Ct(e) {
   var o;
   const t = ((o = e.input) == null ? void 0 : o.properties) ?? {}, r = e["x-apigen-envelope"], n = [];
   for (const i of Object.keys(t)) {
@@ -1599,16 +1611,16 @@ function It(e) {
       httpHeader: a,
       mcpMetaKey: a,
       cliFlag: jt(s, i),
-      envVar: Ot(s, i)
+      envVar: Nt(s, i)
     });
   }
   return n;
 }
-function Ct(e, t) {
-  const r = /* @__PURE__ */ new Map(), { props: n } = kt(e);
+function St(e, t) {
+  const r = /* @__PURE__ */ new Map(), { props: n } = It(e);
   for (const [o, i] of Object.entries(n)) {
     let s = "string";
-    _t(i) ? s = "boolean" : At(i) && (s = "json"), r.set(Et(o), {
+    _t(i) ? s = "boolean" : (At(i) || Et(i)) && (s = "json"), r.set(kt(o), {
       camelKey: o,
       kind: "domain",
       valueKind: s
@@ -1625,8 +1637,8 @@ function Ct(e, t) {
   }
   return r;
 }
-function tr(e) {
-  const { op: t, schema: r, transport: n, projection: o } = e, i = vt(t, o), s = r ? It(r) : [], a = r ? Ct(r, s) : /* @__PURE__ */ new Map(), f = r ? Ve(r).params : void 0, c = {
+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 = {
     op: t,
     transport: n,
     http: i.http,
@@ -1637,38 +1649,38 @@ function tr(e) {
     envelope: s,
     cliFlags: a,
     streaming: t.streaming,
-    isMount: ae(t)
+    isMount: ce(t)
   };
-  if (ae(t)) {
+  if (ce(t)) {
     const u = t.handler;
     c.mountHandler = async (p) => u(p);
   }
   return c;
 }
-function rr(e) {
+function nr(e) {
   const t = e.usePlugins;
   return Array.isArray(t) ? t : [];
 }
-function nr(e) {
+function or(e) {
   const t = e.useOptions;
   return t && typeof t == "object" ? t : {};
 }
-function St(e) {
+function xt(e) {
   return async function(r, n) {
     const o = Object.assign(r, { data: r.domainArgs });
     return await e.layer(o, n);
   };
 }
-function or(e, t) {
+function ir(e, t) {
   var n;
   const r = [];
   for (const o of t) {
     const i = (n = o.capabilities) == null ? void 0 : n.layer;
-    i && r.push(St(i));
+    i && r.push(xt(i));
   }
   return r.push(Ye(e)), Me(r);
 }
-function xt() {
+function Mt() {
   const e = /* @__PURE__ */ new Map();
   return {
     get: (t) => e.get(t),
@@ -1677,14 +1689,14 @@ function xt() {
     }
   };
 }
-const Mt = {
+const Tt = {
   input: {
     type: "object",
     properties: { data: { type: "object", properties: {} } }
   },
   output: {}
 };
-async function ir(e, t, r, n) {
+async function sr(e, t, r, n) {
   const o = {
     ...r,
     operation: { id: e.op.id },
@@ -1700,13 +1712,13 @@ async function ir(e, t, r, n) {
       operation: e.op,
       data: r.domainArgs,
       envelope: r.envelope,
-      ctx: xt(),
+      ctx: Mt(),
       transport: e.transport,
       signal: r.signal ?? new AbortController().signal
     }, a = {
       ...n,
       fns: { [e.op.id]: () => i(s) },
-      schemas: { [e.op.id]: Mt }
+      schemas: { [e.op.id]: Tt }
     };
     return t(e.op.id, o, a);
   }
@@ -1714,42 +1726,42 @@ async function ir(e, t, r, n) {
 }
 export {
   pt as BATCH_DEFAULT_CONCURRENCY,
-  dt as BATCH_MAX_CONCURRENCY,
+  lt as BATCH_MAX_CONCURRENCY,
   Te as EventBus,
-  Wt as InstanceRegistry,
+  Gt as InstanceRegistry,
   xe as LayerContext,
   g as UnionCodecError,
   Je as ValidateSchemasToken,
   at as WELL_KNOWN_TS_CODECS,
-  St as adaptCoreLayer,
+  xt as adaptCoreLayer,
   ze as assertNoSelfSubscription,
   Ue as buildContext,
-  zt as buildFnTable,
-  Qt as buildMcpOutputSchema,
-  tr as buildOpPlan,
-  Xt as buildToolDescription,
-  qt as coerceQueryParams,
+  Vt as buildFnTable,
+  Zt as buildMcpOutputSchema,
+  rr as buildOpPlan,
+  Qt as buildToolDescription,
+  zt as coerceQueryParams,
   Qe as collectWithPhase,
-  Kt as createApiPackage,
+  Ht as createApiPackage,
   Me as createInvoker,
-  Ht as createLogger,
-  or as createPackageInvoker,
-  Gt as createStream,
+  qt as createLogger,
+  ir as createPackageInvoker,
+  Jt as createStream,
   rt as createUnionCodec,
   ke as dataParamNames,
-  Ft as defineMiddleware,
+  Kt as defineMiddleware,
   Ve as describeParams,
   Se as dispatch,
-  ir as dispatchForPlan,
-  Jt as drainStream,
-  er as invokeBatch,
+  sr as dispatchForPlan,
+  Yt as drainStream,
+  tr as invokeBatch,
   Ze as isApiStream,
   Ye as makeValidateLayer,
   Ee as needsEnvelopeField,
-  nr as readUseOptions,
-  rr as readUsePlugins,
-  Yt as tsHostBinding,
-  Vt as validateLayer,
+  or as readUseOptions,
+  nr as readUsePlugins,
+  Xt as tsHostBinding,
+  Wt as validateLayer,
   De as wireObservers,
-  Zt as wrapMcpStructuredContent
+  er as wrapMcpStructuredContent
 };

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@adhd/apigen-engine-runtime",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "dependencies": {
     "ajv": "^8.20.0",
     "ajv-formats": "2.1.1",
     "pino": "10.3.1",
-    "@adhd/apigen-core-client": "^0.2.1",
+    "@adhd/apigen-core-client": "^0.2.2",
     "@adhd/apigen-base-logical": "^0.1.0",
     "@adhd/apigen-base-errors": "^0.2.0",
     "@adhd/apigen-engine-naming": "^0.2.1",