@adhd/apigen-engine-runtime 0.1.4 → 0.2.0

package/CHANGELOG.md

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

package/index.mjs

@@ -2,11 +2,11 @@ import "ts-morph";
 import "node:fs";
 import "node:path";
 import "ts-json-schema-generator";
-import j from "pino";
+import N from "pino";
 import ye from "ajv";
 import me from "ajv-formats";
-const k = "$apigen";
-class z extends Error {
+const I = "$apigen";
+class H extends Error {
   constructor(t) {
     super(t), this.code = "E_DUP_CODEC", this.name = "CodecRegistryError";
   }
@@ -16,7 +16,7 @@ function he(e) {
   return {
     register(n, r) {
       if (t.has(n.id) && !(r != null && r.override))
-        throw new z(
+        throw new H(
           `E_DUP_CODEC: a codec is already registered for id "${n.id}"`
         );
       t.set(n.id, n);
@@ -35,7 +35,7 @@ function he(e) {
     freeze() {
       const n = new Map(t), r = {
         register() {
-          throw new z(
+          throw new H(
             "E_DUP_CODEC: registry is frozen and cannot accept new codecs"
           );
         },
@@ -58,8 +58,8 @@ function he(e) {
     }
   };
 }
-const U = "x-apigen-logical", D = "x-apigen-codec", I = "x-apigen-ctor", x = "x-apigen-tojson", ge = "0.1.0";
-function H(e, t) {
+const U = "x-apigen-logical", D = "x-apigen-codec", k = "x-apigen-ctor", x = "x-apigen-tojson", ge = "0.1.0";
+function V(e, t) {
   return {
     registry: e,
     resolve: (n) => {
@@ -84,7 +84,7 @@ function v(e, t, n) {
   }
   const i = t.oneOf;
   if (Array.isArray(i)) {
-    const a = ie(e, i, t);
+    const a = se(e, i, t);
     return v(e, a, n);
   }
   const s = t.type;
@@ -131,7 +131,7 @@ function $(e, t, n) {
   }
   const i = t.oneOf;
   if (Array.isArray(i)) {
-    const a = ie(e, i, t);
+    const a = se(e, i, t);
     return $(e, a, n);
   }
   const s = t.type;
@@ -167,7 +167,7 @@ function $(e, t, n) {
   }
   return s == null ? we(e, n) : e;
 }
-function ie(e, t, n, r) {
+function se(e, t, n, r) {
   const o = n.discriminator;
   if (o != null && o.propertyName) {
     const i = e !== null && typeof e == "object" ? e[o.propertyName] : void 0;
@@ -188,15 +188,15 @@ function A(e, t, n) {
     if (o)
       try {
         const i = o.encode(e, o.schema, n);
-        return { [k]: r, v: i };
+        return { [I]: r, v: i };
       } catch {
       }
   }
   return w(e);
 }
 function we(e, t) {
-  if (e !== null && typeof e == "object" && !Array.isArray(e) && k in e) {
-    const n = e, r = n[k], o = t.registry.get(r);
+  if (e !== null && typeof e == "object" && !Array.isArray(e) && I in e) {
+    const n = e, r = n[I], o = t.registry.get(r);
     if (o)
       return o.decode(n.v, o.schema, t);
   }
@@ -218,11 +218,11 @@ function w(e) {
 function be(e) {
   return {
     encode(t, n, r) {
-      const o = H(e, r);
+      const o = V(e, r);
       return v(t, n, o);
     },
     decode(t, n, r) {
-      const o = H(e, r);
+      const o = V(e, r);
       return $(t, n, o);
     }
   };
@@ -389,7 +389,7 @@ const L = {
       );
     return NaN;
   }
-}, Ne = [
+}, je = [
   L,
   R,
   F,
@@ -397,8 +397,8 @@ const L = {
   B,
   q
 ];
-function je(e, t = {}) {
-  for (const n of Ne)
+function Ne(e, t = {}) {
+  for (const n of je)
     e.register(n, { override: t.override ?? !1 });
 }
 L.id, // 'date-time'
@@ -407,9 +407,9 @@ F.id, // 'decimal'
 K.id, // 'byte'
 B.id, // 'uuid'
 q.id;
-const se = he();
-je(se);
-const ae = be(se.freeze());
+const ae = he();
+Ne(ae);
+const ce = be(ae.freeze());
 function Oe(e, t) {
   var r;
   const n = ((r = e.input) == null ? void 0 : r.properties) ?? {};
@@ -426,11 +426,11 @@ function _e(e, t) {
   return r !== void 0 ? r : void 0;
 }
 function Ee(e, t) {
-  return t === void 0 || e === void 0 ? e : ae.decode(e, t);
+  return t === void 0 || e === void 0 ? e : ce.decode(e, t);
 }
 function _(e, t) {
   const n = t.output;
-  return !n || Object.keys(n).length === 0 ? e : ae.encode(e, n);
+  return !n || Object.keys(n).length === 0 ? e : ce.encode(e, n);
 }
 async function Se(e, t, n, r, o, i) {
   const a = Ae(n).map(
@@ -447,7 +447,7 @@ async function Se(e, t, n, r, o, i) {
   const f = await e[r](...a);
   return _(f, n);
 }
-class ke {
+class Ie {
   constructor() {
     this._map = /* @__PURE__ */ new Map();
   }
@@ -462,7 +462,7 @@ class ke {
     return this._map.has(t);
   }
 }
-function Ie(e = []) {
+function ke(e = []) {
   return async function(n, r, o) {
     const i = o.schemas[n];
     if (!i)
@@ -483,7 +483,7 @@ function Ie(e = []) {
     )();
   };
 }
-function Et(e) {
+function Ct(e) {
   return e;
 }
 class xe {
@@ -609,7 +609,7 @@ function Pe(e) {
   const { type: n } = t;
   return typeof n == "string" ? G.has(n) : Array.isArray(n) ? n.every((r) => G.has(r) || r === "null") : Array.isArray(t.enum) && t.enum.length > 0 ? t.enum.every((r) => ["string", "number", "boolean"].includes(typeof r)) : !1;
 }
-function ce(e) {
+function Ue(e) {
   if (!e || typeof e != "object")
     return !1;
   const t = e.properties;
@@ -617,7 +617,7 @@ function ce(e) {
     Pe
   );
 }
-function Ue(e) {
+function De(e) {
   const t = {}, n = (r) => {
     for (const o of ["definitions", "$defs"]) {
       const i = r[o];
@@ -640,7 +640,7 @@ function Ue(e) {
         );
       }
 }
-function De(e, t) {
+function Le(e, t) {
   const n = [
     'apigen calling convention: all domain parameters go inside a "data" envelope — e.g. { "data": { ... } }' + (t ? "." : " (an empty object for this zero-parameter tool).")
   ];
@@ -648,21 +648,21 @@ function De(e, t) {
     `Field(s) ${e.map((r) => `"${r}"`).join(", ")} are transport-level envelope metadata, NOT domain data — do not nest them under "data". Over MCP they are read from arguments._meta["x-<pluginId>-<field>"] (default pluginId "adhd"); see @adhd/apigen-engine-naming's envelopeMetaKey/envelopeCliFlag/envelopeEnvVar for the HTTP-header / CLI-flag / env-var equivalents.`
   ), n.join(" ");
 }
-function Le(e, t, n) {
-  Ue(e);
+function Re(e, t, n) {
+  De(e);
   const r = {};
   for (const [o, i] of Object.entries(e.schemas)) {
     const s = (n == null ? void 0 : n[o]) ?? {}, a = i.input.properties ?? {}, f = i.input.required ?? [], c = {}, u = [], p = {};
     for (const h of t)
       if (h.envelope && s[h.id] !== !1)
-        for (const [b, le] of Object.entries(h.envelope))
-          c[b] = le, p[b] = h.id, u.includes(b) || u.push(b);
+        for (const [b, de] of Object.entries(h.envelope))
+          c[b] = de, p[b] = h.id, u.includes(b) || u.push(b);
     const l = {
       type: "object",
       properties: a,
       additionalProperties: !1,
       ...f.length > 0 ? { required: f } : {}
-    }, y = i.safe === !0 || ce(i.input), d = i.input.definitions, m = i.input.$defs;
+    }, y = i.safe === !0 || Ue(i.input), d = i.input.definitions, m = i.input.$defs;
     r[o] = {
       input: {
         type: "object",
@@ -675,7 +675,7 @@ function Le(e, t, n) {
         // field or the "data" wrapper — no silently-ignored junk params.
         additionalProperties: !1,
         // BUG-APIGEN-020: document the envelope/data calling convention inline.
-        description: De(
+        description: Le(
           Object.keys(c),
           Object.keys(a).length > 0
         ),
@@ -695,13 +695,13 @@ function Le(e, t, n) {
   }
   return r;
 }
-const Re = {
+const Fe = {
   "decimal.js": "Decimal"
 };
-function Fe(e) {
+function Ke(e) {
   return e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-Object.entries(Re).map(([e, t]) => ({
+Object.entries(Fe).map(([e, t]) => ({
   // Matches: import("...{modSpec}...").<anyMemberName>  (single or double quotes)
   // The module specifier appears inside an absolute path, so we allow any
   // characters between the quote and the specifier, and between the specifier
@@ -709,7 +709,7 @@ Object.entries(Re).map(([e, t]) => ({
   // …) is matched generically (`\w+`) rather than anchored to one spelling —
   // see the doc comment above for why.
   pattern: new RegExp(
-    `import\\(["'][^"']*${Fe(e)}[^"']*["']\\)\\.\\w+`,
+    `import\\(["'][^"']*${Ke(e)}[^"']*["']\\)\\.\\w+`,
     "g"
   ),
   key: t
@@ -719,7 +719,7 @@ class P extends Error {
     super(t), this.name = "ConfigurationError";
   }
 }
-function Ke(e) {
+function Be(e) {
   for (const t of e)
     for (const n of Object.keys(t.eventMapping ?? {})) {
       const [r] = n.split(":");
@@ -729,14 +729,14 @@ function Ke(e) {
         );
     }
 }
-function St(e) {
+function Mt(e) {
   const {
     domainSchemas: t,
     middlewares: n,
     overrides: r = {},
     strict: o = !1
   } = e;
-  Ke(n);
+  Be(n);
   for (const c of Object.keys(r))
     if (!(c in t.schemas)) {
       const u = `Override key "${c}" not found in domain schemas.`;
@@ -753,14 +753,14 @@ function St(e) {
           throw new P(l);
         console.warn("[apigen-runtime]", l);
       }
-  const s = Le(
+  const s = Re(
     t,
     n,
     r
   ), a = new xe();
   return Me(n, a), { schemas: s, createClient: async (c) => Te(n, c, a), dispose: () => a.clear() };
 }
-function kt(e = {}) {
+function Tt(e = {}) {
   const t = e.level ?? "info", n = typeof e.destination == "string" && e.destination.length > 0, r = !n && !!process.stderr.isTTY, o = e.format ?? (r ? "pretty" : "json"), i = { level: t };
   if (o === "pretty")
     return i.transport = {
@@ -771,14 +771,14 @@ function kt(e = {}) {
         ignore: "pid,hostname",
         ...n ? { destination: e.destination, mkdir: !0 } : { destination: 2 }
       }
-    }, j(i);
-  const s = n ? j.destination({ dest: e.destination, mkdir: !0, sync: !0 }) : j.destination(2);
-  return j(i, s);
+    }, N(i);
+  const s = n ? N.destination({ dest: e.destination, mkdir: !0, sync: !0 }) : N.destination(2);
+  return N(i, s);
 }
 function ue(e) {
   return e ? e.type === "array" ? `${ue(e.items)}[]` : e.enum ? "enum" : e.$ref ? String(e.$ref).split("/").pop() || "object" : e.anyOf || e.oneOf ? "union" : e.type ?? "object" : "unknown";
 }
-function Be(e) {
+function qe(e) {
   var a;
   const n = (a = ((e == null ? void 0 : e.input) ?? {}).properties) == null ? void 0 : a.data, r = (n == null ? void 0 : n.properties) ?? {}, o = new Set((n == null ? void 0 : n.required) ?? []), i = Object.entries(r).map(([f, c]) => ({
     name: f,
@@ -787,18 +787,18 @@ function Be(e) {
   })), s = i.map((f) => `${f.name}${f.required ? "" : "?"}: ${f.type}`).join(", ");
   return { params: i, text: s };
 }
-function qe(e) {
+function ze(e) {
   let t;
   return Array.isArray(e) ? t = e : e ? t = [e] : t = [], t.find((n) => n === "number" || n === "integer" || n === "boolean");
 }
-function It(e, t) {
+function Pt(e, t) {
   var i, s;
   const r = ((s = (i = ((t == null ? void 0 : t.input) ?? {}).properties) == null ? void 0 : i.data) == null ? void 0 : s.properties) ?? {}, o = { ...e };
   for (const [a, f] of Object.entries(r)) {
     const c = o[a];
     if (typeof c != "string")
       continue;
-    const u = qe(f == null ? void 0 : f.type);
+    const u = ze(f == null ? void 0 : f.type);
     if (u === "number" || u === "integer") {
       const p = Number(c);
       !Number.isNaN(p) && c.trim() !== "" && (o[a] = p);
@@ -808,7 +808,7 @@ function It(e, t) {
   return o;
 }
 const J = /* @__PURE__ */ new Set(["default", "module.exports", "__esModule"]);
-function xt(e) {
+function Ut(e) {
   const t = {}, n = (r, o) => {
     for (const [i, s] of Object.entries(r))
       if (typeof s == "function") {
@@ -820,14 +820,14 @@ function xt(e) {
   };
   return n(e, 0), t;
 }
-const Ve = [
+const He = [
   "invalid_argument",
   "unauthenticated",
   "permission_denied",
   "not_found",
   "internal"
 ];
-class V extends Error {
+class z extends Error {
   constructor(t, n, r) {
     super(n), this.name = "ApiError", this.code = t, this.details = r, Object.setPrototypeOf(this, new.target.prototype);
   }
@@ -840,30 +840,30 @@ class V extends Error {
     return this.details !== void 0 && (t.details = this.details), t;
   }
 }
-function ze(e) {
-  return typeof e == "object" && e !== null && e.name === "ApiError" && Ve.includes(e.code) && typeof e.toJSON == "function";
+function Ve(e) {
+  return typeof e == "object" && e !== null && e.name === "ApiError" && He.includes(e.code) && typeof e.toJSON == "function";
 }
 function Y(e, t, n = 0) {
   return e === "before-first-chunk" ? { phase: e, error: t } : { phase: e, error: t, chunksDelivered: n };
 }
-const N = new ye({ allErrors: !0 });
-me(N);
+const j = new ye({ allErrors: !0 });
+me(j);
 for (const e of [
   U,
   D,
-  I,
+  k,
   x,
   "discriminator"
 ])
-  N.addKeyword({ keyword: e, valid: !0 });
-N.addFormat("decimal", /^[+-]?(?:\d+(?:\.\d+)?|\.\d+)$/);
+  j.addKeyword({ keyword: e, valid: !0 });
+j.addFormat("decimal", /^[+-]?(?:\d+(?:\.\d+)?|\.\d+)$/);
 function fe(e) {
   return e.map(
     (t) => `${t.instancePath || "(root)"} ${t.message ?? "failed schema check"}`
   ).join("; ");
 }
-const Ct = async (e, t) => {
-  const n = e.ctx.get(He);
+const Dt = async (e, t) => {
+  const n = e.ctx.get(We);
   if (n === void 0)
     return t();
   const r = e.operation.id, o = n[r];
@@ -872,18 +872,18 @@ const Ct = async (e, t) => {
   const i = {
     data: e.domainArgs,
     ...e.envelope
-  }, s = N.compile(o.input);
+  }, s = j.compile(o.input);
   if (!s(i)) {
     const f = s.errors ?? [];
-    throw new V(
+    throw new z(
       "invalid_argument",
       `Validation failed: ${fe(f)}`,
       f
     );
   }
   return t();
-}, He = Symbol("ValidateSchemasToken");
-function We(e) {
+}, We = Symbol("ValidateSchemasToken");
+function Ge(e) {
   return async function(n, r) {
     const o = n.operation.id, i = e[o];
     if (i === void 0)
@@ -891,10 +891,10 @@ function We(e) {
     const s = {
       data: n.domainArgs,
       ...n.envelope
-    }, a = N.compile(i.input);
+    }, a = j.compile(i.input);
     if (!a(s)) {
       const c = a.errors ?? [];
-      throw new V(
+      throw new z(
         "invalid_argument",
         `Validation failed: ${fe(c)}`,
         c
@@ -903,13 +903,13 @@ function We(e) {
     return r();
   };
 }
-function Ge() {
+function Je() {
   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 Mt {
+class Lt {
   constructor(t = {}) {
     var r, o;
     this._store = /* @__PURE__ */ new Map(), this._sweeper = null, this._defaultTtlMs = t.defaultTtlMs;
@@ -928,7 +928,7 @@ class Mt {
    * @returns `{ instanceId }` — pass this to `dispatch()` / `get()`.
    */
   create(t, n = [], r) {
-    const o = new t(...n), i = Ge(), s = r ?? this._defaultTtlMs, a = s !== void 0 ? Date.now() + s : null;
+    const o = new t(...n), i = Je(), s = r ?? this._defaultTtlMs, a = s !== void 0 ? Date.now() + s : null;
     return this._store.set(i, { instance: o, expiresAt: a }), { instanceId: i };
   }
   // ---------------------------------------------------------------------------
@@ -1016,7 +1016,7 @@ async function E(e) {
     typeof t == "function" && await t.call(e);
   }
 }
-function Tt(e) {
+function Rt(e) {
   const { produce: t, signal: n } = e, r = n ?? new AbortController().signal;
   return {
     [Symbol.asyncIterator]() {
@@ -1035,20 +1035,20 @@ function Tt(e) {
     }
   };
 }
-async function Pt(e) {
+async function Ft(e) {
   const t = [];
   for await (const n of e)
     t.push(n);
   return t;
 }
-async function Ut(e) {
+async function Kt(e) {
   const t = [];
   try {
     for await (const n of e)
       t.push(n);
     return { ok: !0, chunks: t };
   } catch (n) {
-    const r = ze(n) ? n : new V(
+    const r = Ve(n) ? n : new z(
       "internal",
       n instanceof Error ? n.message : String(n)
     );
@@ -1061,7 +1061,7 @@ async function Ut(e) {
     };
   }
 }
-function Dt(e) {
+function Bt(e) {
   return e !== null && typeof e == "object" && Symbol.asyncIterator in e;
 }
 class g extends Error {
@@ -1092,15 +1092,15 @@ function pe(e, t) {
   }
   return t.registry.resolve(e);
 }
-function Je(e, t, n) {
+function Ye(e, t, n) {
   const r = pe(t, n);
   return r ? r.encode(e, t, n) : e;
 }
-function Ye(e, t, n) {
+function Qe(e, t, n) {
   const r = pe(t, n);
   return r ? r.decode(e, t, n) : e;
 }
-function Qe(e) {
+function Xe(e) {
   const { id: t, schema: n } = e;
   return {
     id: t,
@@ -1137,7 +1137,7 @@ function Qe(e) {
           `[${t}] discriminator tag "${u}" at "${i.path}" is not in the mapping (known: ${Object.keys(f).join(", ")}).`
         );
       const l = i.resolve(p);
-      return Je(r, l, {
+      return Ye(r, l, {
         ...i,
         path: `${i.path}[${u}]`
       });
@@ -1169,14 +1169,14 @@ function Qe(e) {
           `[${t}] discriminator tag "${p}" on the wire at "${i.path}" is not in the mapping (known: ${Object.keys(c).join(", ")}).`
         );
       const y = i.resolve(l);
-      return Ye(r, y, {
+      return Qe(r, y, {
         ...i,
         path: `${i.path}[${p}]`
       });
     }
   };
 }
-const Xe = "x-apigen-instances";
+const Ze = "x-apigen-instances";
 class O extends Error {
   constructor(t, n) {
     super(n), this.name = "NominalCodecError", this.code = t;
@@ -1186,7 +1186,7 @@ function Q(e) {
   const t = e.properties;
   return t && typeof t == "object" && !Array.isArray(t) ? t : {};
 }
-function Ze(e) {
+function et(e) {
   const t = e.required;
   return Array.isArray(t) ? t.filter((n) => typeof n == "string") : [];
 }
@@ -1198,7 +1198,7 @@ function X(e, t, n) {
   }
   return e;
 }
-function et(e, t, n) {
+function tt(e, t, n) {
   if (t) {
     const r = n.registry.resolve(t);
     if (r)
@@ -1206,7 +1206,7 @@ function et(e, t, n) {
   }
   return e;
 }
-function tt(e) {
+function nt(e) {
   const { id: t, schema: n, ctor: r } = e;
   return {
     id: t,
@@ -1273,25 +1273,25 @@ function tt(e) {
         );
       }
       const a = o;
-      for (const u of Ze(i))
+      for (const u of et(i))
         if (!(u in a))
           throw new O(
             "E_NOMINAL_INVALID_WIRE",
             `[${t}] required field "${u}" missing on the wire at "${s.path}".`
           );
-      if (i[Xe] === !1)
+      if (i[Ze] === !1)
         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 = {};
       for (const [u, p] of Object.entries(a))
-        c[u] = et(p, f[u], {
+        c[u] = tt(p, f[u], {
           ...s,
           path: `${s.path}/${u}`
         });
       if (r) {
-        const u = typeof i[I] == "string" ? i[I] : "fromJSON", p = r[u];
+        const u = typeof i[k] == "string" ? i[k] : "fromJSON", p = r[u];
         if (typeof p == "function")
           return p.call(
             r,
@@ -1304,33 +1304,33 @@ function tt(e) {
     }
   };
 }
-const nt = [
+const rt = [
   L,
   R,
   F,
   K,
   B,
   q
-], rt = {
+], ot = {
   type: "object",
   "x-apigen-logical": "nominal",
   "x-apigen-codec": "ts.NominalSentinel"
-}, Z = tt({
+}, Z = nt({
   id: "ts.NominalSentinel",
-  schema: rt
-}), ot = {
+  schema: ot
+}), it = {
   oneOf: [],
   discriminator: { propertyName: "kind", mapping: {} },
   "x-apigen-logical": "union",
   "x-apigen-codec": "ts.UnionSentinel"
-}, ee = Qe({
+}, ee = Xe({
   id: "ts.UnionSentinel",
-  schema: ot
+  schema: it
 });
-function it() {
+function st() {
   const e = [
     // 6 well-known scalars
-    ...nt.map((t) => [
+    ...rt.map((t) => [
       t.id,
       t
     ]),
@@ -1341,19 +1341,19 @@ function it() {
   ];
   return Object.freeze(new Map(e));
 }
-const Lt = Object.freeze({
+const qt = Object.freeze({
   host: "ts",
   logicalTypeVersion: ge,
-  codecs: it()
+  codecs: st()
 });
-function Rt(e, t, n) {
+function zt(e, t, n) {
   var i;
   const r = typeof ((i = t == null ? void 0 : t.input) == null ? void 0 : i.description) == "string" ? t.input.description : void 0, o = [n, r].filter(
     (s) => typeof s == "string" && s.length > 0
   );
   return o.length > 0 ? o.join(" — ") : e;
 }
-function Ft(e) {
+function Ht(e) {
   if (!e || typeof e != "object" || Array.isArray(e) || Object.keys(e).length === 0)
     return { outputSchema: void 0, wrapped: !1 };
   const t = e;
@@ -1366,102 +1366,139 @@ function Ft(e) {
     wrapped: !0
   };
 }
-function Kt(e, t) {
+function Vt(e, t) {
   return e ? { result: t } : t && typeof t == "object" && !Array.isArray(t) ? t : void 0;
 }
-function te(e) {
-  return e.words.join("-");
+const te = /* @__PURE__ */ new Set(["string", "number", "boolean", "integer"]);
+function at(e) {
+  if (typeof e != "object" || e === null)
+    return !1;
+  const t = e;
+  if (t.$ref !== void 0 || t.oneOf || t.anyOf || t.allOf)
+    return !1;
+  const { type: n } = t;
+  return typeof n == "string" ? te.has(n) : Array.isArray(n) ? n.every((r) => te.has(r) || r === "null") : Array.isArray(t.enum) && t.enum.length > 0 ? t.enum.every((r) => ["string", "number", "boolean"].includes(typeof r)) : !1;
 }
+function ct(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(
+    at
+  );
+}
+const ut = {
+  "decimal.js": "Decimal"
+};
+function ft(e) {
+  return e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+Object.entries(ut).map(([e, t]) => ({
+  // Matches: import("...{modSpec}...").<anyMemberName>  (single or double quotes)
+  // The module specifier appears inside an absolute path, so we allow any
+  // characters between the quote and the specifier, and between the specifier
+  // and the closing quote. The trailing member accessor (`.default`, `.Decimal`,
+  // …) is matched generically (`\w+`) rather than anchored to one spelling —
+  // see the doc comment above for why.
+  pattern: new RegExp(
+    `import\\(["'][^"']*${ft(e)}[^"']*["']\\)\\.\\w+`,
+    "g"
+  ),
+  key: t
+}));
 function ne(e) {
-  return e.words.map(ft).join("");
+  return e.words.join("-");
 }
 function re(e) {
+  return e.words.map(mt).join("");
+}
+function oe(e) {
   return e.words.join("_");
 }
-function st(e, t = {}) {
-  var l, y;
-  const n = [e.namespace, ...e.path], r = e.safe || ce(e.input) ? "GET" : "POST", o = ((y = (l = t.http) == null ? void 0 : l.verb) == null ? void 0 : y[e.id]) ?? r, i = "/" + n.map((d) => te(d)).join("/"), s = n.map((d) => re(d)).join("_"), f = n.map((d) => re(d)).slice(0, -1).join("."), c = ne(n[n.length - 2] ?? n[0]), u = ne(n[n.length - 1]), p = n.map((d) => te(d));
+function pt(e, t = {}) {
+  var n, r;
+  const o = [e.namespace, ...e.path], i = e.safe || ct(e.input) ? "GET" : "POST", s = ((r = (n = t.http) == null ? void 0 : n.verb) == null ? void 0 : r[e.id]) ?? i, a = "/" + o.map((y) => ne(y)).join("/"), f = o.map((y) => oe(y)).join("_"), c = o.map((y) => oe(y)).slice(0, -1).join("."), u = re(o[o.length - 2] ?? o[0]), p = re(o[o.length - 1]), l = o.map((y) => ne(y));
   return {
-    http: { verb: o, route: i },
-    mcp: { name: s },
-    grpc: { package: f, service: c, method: u },
-    cli: { path: p }
+    http: { verb: s, route: a },
+    mcp: { name: f },
+    grpc: { package: c, service: u, method: p },
+    cli: { path: l }
   };
 }
-function at(e, t) {
+function lt(e, t) {
   return `x-${e}-${t}`;
 }
-function ct(e, t) {
+function dt(e, t) {
   return `--${e}-${t}`;
 }
-function ut(e, t) {
+function yt(e, t) {
   const n = (r) => r.toUpperCase().replace(/-/g, "_");
   return e === "adhd" ? `APIGEN_${n(t)}` : `APIGEN_${n(e)}_${n(t)}`;
 }
-function ft(e) {
+function mt(e) {
   return e.length === 0 ? e : e[0].toUpperCase() + e.slice(1);
 }
-function de(e) {
+function le(e) {
   return e.anyOf ?? e.oneOf;
 }
-function pt(e) {
+function ht(e) {
   if (!e)
     return !1;
   if (e.type === "array" || e.type === "object")
     return !0;
-  const t = de(e);
+  const t = le(e);
   if (t) {
     const n = t.filter((r) => r.type !== "null");
     return n.length > 0 && n.every((r) => r.type === "array" || r.type === "object");
   }
   return !1;
 }
-function dt(e) {
+function gt(e) {
   if (!e)
     return !1;
   if (e.type === "boolean")
     return !0;
-  const t = de(e);
+  const t = le(e);
   if (t) {
     const n = t.filter((r) => r.type !== "null");
     return n.length > 0 && n.every((r) => r.type === "boolean");
   }
   return !1;
 }
-function lt(e) {
+function wt(e) {
   return e.replace(/[A-Z]/g, (t) => "-" + t.toLowerCase());
 }
-function yt(e) {
+function bt(e) {
   var o, i;
   const t = (i = (o = e.input) == null ? void 0 : o.properties) == null ? void 0 : i.data, n = (t == null ? void 0 : t.properties) ?? {}, r = (t == null ? void 0 : t.required) ?? [];
   return { props: n, required: r };
 }
-function oe(e) {
+function ie(e) {
   return typeof e.handler == "function";
 }
-function mt(e) {
+function vt(e) {
   var o;
   const t = ((o = e.input) == null ? void 0 : o.properties) ?? {}, n = e["x-apigen-envelope"], r = [];
   for (const i of Object.keys(t)) {
     if (i === "data")
       continue;
-    const s = (n == null ? void 0 : n[i]) ?? "adhd", a = at(s, i);
+    const s = (n == null ? void 0 : n[i]) ?? "adhd", a = lt(s, i);
     r.push({
       field: i,
       pluginId: s,
       httpHeader: a,
       mcpMetaKey: a,
-      cliFlag: ct(s, i),
-      envVar: ut(s, i)
+      cliFlag: dt(s, i),
+      envVar: yt(s, i)
     });
   }
   return r;
 }
-function ht(e, t) {
-  const n = /* @__PURE__ */ new Map(), { props: r } = yt(e);
+function $t(e, t) {
+  const n = /* @__PURE__ */ new Map(), { props: r } = bt(e);
   for (const [o, i] of Object.entries(r)) {
     let s = "string";
-    dt(i) ? s = "boolean" : pt(i) && (s = "json"), n.set(lt(o), {
+    gt(i) ? s = "boolean" : ht(i) && (s = "json"), n.set(wt(o), {
       camelKey: o,
       kind: "domain",
       valueKind: s
@@ -1478,8 +1515,8 @@ function ht(e, t) {
   }
   return n;
 }
-function Bt(e) {
-  const { op: t, schema: n, transport: r, projection: o } = e, i = st(t, o), s = n ? mt(n) : [], a = n ? ht(n, s) : /* @__PURE__ */ new Map(), f = n ? Be(n).params : void 0, c = {
+function Wt(e) {
+  const { op: t, schema: n, transport: r, projection: o } = e, i = pt(t, o), s = n ? vt(n) : [], a = n ? $t(n, s) : /* @__PURE__ */ new Map(), f = n ? qe(n).params : void 0, c = {
     op: t,
     transport: r,
     http: i.http,
@@ -1490,38 +1527,38 @@ function Bt(e) {
     envelope: s,
     cliFlags: a,
     streaming: t.streaming,
-    isMount: oe(t)
+    isMount: ie(t)
   };
-  if (oe(t)) {
+  if (ie(t)) {
     const u = t.handler;
     c.mountHandler = async (p) => u(p);
   }
   return c;
 }
-function qt(e) {
+function Gt(e) {
   const t = e.usePlugins;
   return Array.isArray(t) ? t : [];
 }
-function Vt(e) {
+function Jt(e) {
   const t = e.useOptions;
   return t && typeof t == "object" ? t : {};
 }
-function gt(e) {
+function jt(e) {
   return async function(n, r) {
     const o = Object.assign(n, { data: n.domainArgs });
     return await e.layer(o, r);
   };
 }
-function zt(e, t) {
+function Yt(e, t) {
   var r;
   const n = [];
   for (const o of t) {
     const i = (r = o.capabilities) == null ? void 0 : r.layer;
-    i && n.push(gt(i));
+    i && n.push(jt(i));
   }
-  return n.push(We(e)), Ie(n);
+  return n.push(Ge(e)), ke(n);
 }
-function wt() {
+function Nt() {
   const e = /* @__PURE__ */ new Map();
   return {
     get: (t) => e.get(t),
@@ -1530,18 +1567,18 @@ function wt() {
     }
   };
 }
-const bt = {
+const Ot = {
   input: {
     type: "object",
     properties: { data: { type: "object", properties: {} } }
   },
   output: {}
 };
-async function Ht(e, t, n, r) {
+async function Qt(e, t, n, r) {
   const o = {
     ...n,
     operation: { id: e.op.id },
-    ctx: new ke()
+    ctx: new Ie()
   };
   if (e.isMount) {
     const i = e.mountHandler;
@@ -1553,13 +1590,13 @@ async function Ht(e, t, n, r) {
       operation: e.op,
       data: n.domainArgs,
       envelope: n.envelope,
-      ctx: wt(),
+      ctx: Nt(),
       transport: e.transport,
       signal: n.signal ?? new AbortController().signal
     }, a = {
       ...r,
       fns: { [e.op.id]: () => i(s) },
-      schemas: { [e.op.id]: bt }
+      schemas: { [e.op.id]: Ot }
     };
     return t(e.op.id, o, a);
   }
@@ -1567,39 +1604,39 @@ async function Ht(e, t, n, r) {
 }
 export {
   xe as EventBus,
-  Mt as InstanceRegistry,
-  ke as LayerContext,
+  Lt as InstanceRegistry,
+  Ie as LayerContext,
   g as UnionCodecError,
-  He as ValidateSchemasToken,
-  nt as WELL_KNOWN_TS_CODECS,
-  gt as adaptCoreLayer,
-  Ke as assertNoSelfSubscription,
+  We as ValidateSchemasToken,
+  rt as WELL_KNOWN_TS_CODECS,
+  jt as adaptCoreLayer,
+  Be as assertNoSelfSubscription,
   Te as buildContext,
-  xt as buildFnTable,
-  Ft as buildMcpOutputSchema,
-  Bt as buildOpPlan,
-  Rt as buildToolDescription,
-  It as coerceQueryParams,
-  Ut as collectWithPhase,
-  St as createApiPackage,
-  Ie as createInvoker,
-  kt as createLogger,
-  zt as createPackageInvoker,
-  Tt as createStream,
-  Qe as createUnionCodec,
+  Ut as buildFnTable,
+  Ht as buildMcpOutputSchema,
+  Wt as buildOpPlan,
+  zt as buildToolDescription,
+  Pt as coerceQueryParams,
+  Kt as collectWithPhase,
+  Mt as createApiPackage,
+  ke as createInvoker,
+  Tt as createLogger,
+  Yt as createPackageInvoker,
+  Rt as createStream,
+  Xe as createUnionCodec,
   Ae as dataParamNames,
-  Et as defineMiddleware,
-  Be as describeParams,
+  Ct as defineMiddleware,
+  qe as describeParams,
   Se as dispatch,
-  Ht as dispatchForPlan,
-  Pt as drainStream,
-  Dt as isApiStream,
-  We as makeValidateLayer,
+  Qt as dispatchForPlan,
+  Ft as drainStream,
+  Bt as isApiStream,
+  Ge as makeValidateLayer,
   Oe as needsEnvelopeField,
-  Vt as readUseOptions,
-  qt as readUsePlugins,
-  Lt as tsHostBinding,
-  Ct as validateLayer,
+  Jt as readUseOptions,
+  Gt as readUsePlugins,
+  qt as tsHostBinding,
+  Dt as validateLayer,
   Me as wireObservers,
-  Kt as wrapMcpStructuredContent
+  Vt as wrapMcpStructuredContent
 };

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@adhd/apigen-engine-runtime",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "dependencies": {
     "ajv": "^8.20.0",
     "ajv-formats": "2.1.1",
     "pino": "10.3.1",
-    "@adhd/apigen-core-client": "^0.1.4",
-    "@adhd/apigen-base-logical": "^0.0.5",
-    "@adhd/apigen-base-errors": "^0.1.5",
-    "@adhd/apigen-engine-naming": "^0.1.4",
+    "@adhd/apigen-core-client": "^0.2.0",
+    "@adhd/apigen-base-logical": "^0.1.0",
+    "@adhd/apigen-base-errors": "^0.2.0",
+    "@adhd/apigen-engine-naming": "^0.2.0",
     "better-sqlite3": "12.10.0"
   },
   "main": "./index.js",