@lssm/lib.contracts 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217073102

package/dist/experiments/evaluator.js

@@ -1 +1,101 @@
-import{createHash as e}from"node:crypto";var t=class{registry;policyChecker;expressionEvaluator;constructor(e){this.registry=e.registry,this.policyChecker=e.policyChecker,this.expressionEvaluator=e.expressionEvaluator}async chooseVariant(e){let t=this.registry.get(e.experiment,e.version);if(!t)return null;let n=t.variants.find(e=>e.id===t.controlVariant);if(!n)throw Error(`Experiment ${t.meta.name} missing control variant ${t.controlVariant}`);switch(t.allocation.type){case`random`:return{variant:this.pickByWeight(t,this.randomSeed(e,t.allocation.salt)),reason:`random`};case`sticky`:return{variant:this.pickByWeight(t,this.stickySeed(e,t.allocation.attribute,t.allocation.salt)),reason:`sticky`};case`targeted`:{let r=await this.evaluateTargeting(t,e,t.allocation.rules);return r?{variant:r,reason:`targeted`}:t.allocation.fallback===`random`?{variant:this.pickByWeight(t,this.randomSeed(e)),reason:`random`}:{variant:n,reason:`control`}}default:return{variant:n,reason:`control`}}}pickByWeight(e,t){let n=e.variants,r=t*n.reduce((e,t)=>e+(t.weight??1),0),i=0;for(let e of n)if(i+=e.weight??1,r<=i)return e;return n[n.length-1]}randomSeed(e,t=``){let n=e.sessionId??e.userId??e.organizationId??`${Date.now()}-${Math.random()}`;return this.hashToUnitInterval(n+t)}stickySeed(e,t,n=``){let r=e[t];return r?this.hashToUnitInterval(`${r}-${n}`):this.randomSeed(e,n)}hashToUnitInterval(t){let n=e(`sha256`).update(t).digest(`hex`).slice(0,15);return parseInt(n,16)%1e6/1e6}async evaluateTargeting(e,t,n){for(let r of n){if(!await this.matchesRule(r,t))continue;let n=e.variants.find(e=>e.id===r.variantId);if(n&&!(typeof r.percentage==`number`&&this.randomSeed(t,`rule-${r.variantId}`)>r.percentage))return n}return null}async matchesRule(e,t){if(e.policy&&this.policyChecker&&!await this.policyChecker(e.policy,t))return!1;if(e.expression){if(this.expressionEvaluator)return!!this.expressionEvaluator(e.expression,t);try{return!!Function(`context`,`return (${e.expression});`)(t)}catch{return!1}}return!0}};export{t as ExperimentEvaluator};
+import { createHash } from "node:crypto";
+
+//#region src/experiments/evaluator.ts
+var ExperimentEvaluator = class {
+	registry;
+	policyChecker;
+	expressionEvaluator;
+	constructor(config) {
+		this.registry = config.registry;
+		this.policyChecker = config.policyChecker;
+		this.expressionEvaluator = config.expressionEvaluator;
+	}
+	async chooseVariant(context) {
+		const experiment = this.registry.get(context.experiment, context.version);
+		if (!experiment) return null;
+		const control = experiment.variants.find((variant) => variant.id === experiment.controlVariant);
+		if (!control) throw new Error(`Experiment ${experiment.meta.name} missing control variant ${experiment.controlVariant}`);
+		switch (experiment.allocation.type) {
+			case "random": return {
+				variant: this.pickByWeight(experiment, this.randomSeed(context, experiment.allocation.salt)),
+				reason: "random"
+			};
+			case "sticky": return {
+				variant: this.pickByWeight(experiment, this.stickySeed(context, experiment.allocation.attribute, experiment.allocation.salt)),
+				reason: "sticky"
+			};
+			case "targeted": {
+				const targeted = await this.evaluateTargeting(experiment, context, experiment.allocation.rules);
+				if (targeted) return {
+					variant: targeted,
+					reason: "targeted"
+				};
+				if (experiment.allocation.fallback === "random") return {
+					variant: this.pickByWeight(experiment, this.randomSeed(context)),
+					reason: "random"
+				};
+				return {
+					variant: control,
+					reason: "control"
+				};
+			}
+			default: return {
+				variant: control,
+				reason: "control"
+			};
+		}
+	}
+	pickByWeight(experiment, seed) {
+		const variants = experiment.variants;
+		const target = seed * variants.reduce((sum, variant) => sum + (variant.weight ?? 1), 0);
+		let cumulative = 0;
+		for (const variant of variants) {
+			cumulative += variant.weight ?? 1;
+			if (target <= cumulative) return variant;
+		}
+		return variants[variants.length - 1];
+	}
+	randomSeed(context, salt = "") {
+		const base = context.sessionId ?? context.userId ?? context.organizationId ?? `${Date.now()}-${Math.random()}`;
+		return this.hashToUnitInterval(base + salt);
+	}
+	stickySeed(context, attribute, salt = "") {
+		const value = context[attribute];
+		if (!value) return this.randomSeed(context, salt);
+		return this.hashToUnitInterval(`${value}-${salt}`);
+	}
+	hashToUnitInterval(value) {
+		const hash = createHash("sha256").update(value).digest("hex").slice(0, 15);
+		return parseInt(hash, 16) % 1e6 / 1e6;
+	}
+	async evaluateTargeting(experiment, context, rules) {
+		for (const rule of rules) {
+			if (!await this.matchesRule(rule, context)) continue;
+			const variant = experiment.variants.find((v) => v.id === rule.variantId);
+			if (!variant) continue;
+			if (typeof rule.percentage === "number") {
+				if (this.randomSeed(context, `rule-${rule.variantId}`) > rule.percentage) continue;
+			}
+			return variant;
+		}
+		return null;
+	}
+	async matchesRule(rule, context) {
+		if (rule.policy && this.policyChecker) {
+			if (!await this.policyChecker(rule.policy, context)) return false;
+		}
+		if (rule.expression) {
+			if (this.expressionEvaluator) return Boolean(this.expressionEvaluator(rule.expression, context));
+			try {
+				const fn = new Function("context", `return (${rule.expression});`);
+				return Boolean(fn(context));
+			} catch (_error) {
+				return false;
+			}
+		}
+		return true;
+	}
+};
+
+//#endregion
+export { ExperimentEvaluator };

package/dist/experiments/spec.js

@@ -1 +1,33 @@
-const e=e=>`${e.name}.v${e.version}`;var t=class{items=new Map;register(t){let n=e(t.meta);if(this.items.has(n))throw Error(`Duplicate experiment ${n}`);return this.items.set(n,t),this}list(){return[...this.items.values()]}get(e,t){if(t!=null)return this.items.get(`${e}.v${t}`);let n,r=-1/0;for(let t of this.items.values())t.meta.name===e&&t.meta.version>r&&(r=t.meta.version,n=t);return n}};function n(t){return e(t)}export{t as ExperimentRegistry,n as makeExperimentKey};
+//#region src/experiments/spec.ts
+const experimentKey = (meta) => `${meta.name}.v${meta.version}`;
+var ExperimentRegistry = class {
+	items = /* @__PURE__ */ new Map();
+	register(spec) {
+		const key = experimentKey(spec.meta);
+		if (this.items.has(key)) throw new Error(`Duplicate experiment ${key}`);
+		this.items.set(key, spec);
+		return this;
+	}
+	list() {
+		return [...this.items.values()];
+	}
+	get(name, version) {
+		if (version != null) return this.items.get(`${name}.v${version}`);
+		let latest;
+		let maxVersion = -Infinity;
+		for (const spec of this.items.values()) {
+			if (spec.meta.name !== name) continue;
+			if (spec.meta.version > maxVersion) {
+				maxVersion = spec.meta.version;
+				latest = spec;
+			}
+		}
+		return latest;
+	}
+};
+function makeExperimentKey(meta) {
+	return experimentKey(meta);
+}
+
+//#endregion
+export { ExperimentRegistry, makeExperimentKey };

package/dist/features.js

@@ -1 +1,68 @@
-function e(e){return e.meta.key}var t=class{items=new Map;register(t){let n=e(t);if(this.items.has(n))throw Error(`Duplicate feature ${n}`);return this.items.set(n,t),this}list(){return[...this.items.values()]}get(e){return this.items.get(e)}};function n(e,t){if(t.ops&&e.operations){for(let n of e.operations)if(!t.ops.getSpec(n.name,n.version))throw Error(`installFeature: operation not found ${n.name}.v${n.version}`)}if(t.presentations&&e.presentations){for(let n of e.presentations)if(!t.presentations.get(n.name,n.version))throw Error(`installFeature: presentation not found ${n.name}.v${n.version}`)}if(e.presentationsTargets&&t.descriptorsV2)for(let n of e.presentationsTargets){let e=t.descriptorsV2.find(e=>e.meta.name===n.name&&e.meta.version===n.version);if(!e)throw Error(`installFeature: V2 descriptor not found ${n.name}.v${n.version}`);for(let t of n.targets)if(!e.targets.includes(t))throw Error(`installFeature: descriptor ${n.name}.v${n.version} missing target ${t}`)}if(e.opToPresentation&&e.opToPresentation.length>0)for(let n of e.opToPresentation){if(t.ops&&!t.ops.getSpec(n.op.name,n.op.version))throw Error(`installFeature: linked op not found ${n.op.name}.v${n.op.version}`);if(t.presentations&&!t.presentations.get(n.pres.name,n.pres.version))throw Error(`installFeature: linked presentation not found ${n.pres.name}.v${n.pres.version}`)}if(t.capabilities&&e.capabilities?.provides){for(let n of e.capabilities.provides)if(!t.capabilities.get(n.key,n.version))throw Error(`installFeature: capability not registered ${n.key}.v${n.version}`)}if(e.capabilities?.requires?.length){if(!t.capabilities)throw Error(`installFeature: capability registry required to validate capability requirements for ${e.meta.key}`);let n=e.capabilities.provides??[];for(let r of e.capabilities.requires)if(!t.capabilities.satisfies(r,n))throw Error(`installFeature: capability requirement not satisfied ${r.key}${r.version?`.v${r.version}`:``}`)}return t.features.register(e),t.features}function r(e,t){if(!e.presentationsTargets||e.presentationsTargets.length===0)return!0;for(let n of e.presentationsTargets){let e=t.find(e=>e.meta.name===n.name&&e.meta.version===n.version);if(!e)throw Error(`V2 descriptor not found ${n.name}.v${n.version}`);for(let t of n.targets)if(!e.targets.includes(t))throw Error(`Descriptor ${n.name}.v${n.version} missing target ${t}`)}return!0}export{t as FeatureRegistry,n as installFeature,r as validateFeatureTargetsV2};
+//#region src/features.ts
+function keyOf(f) {
+	return f.meta.key;
+}
+/** In-memory registry for FeatureModuleSpec. */
+var FeatureRegistry = class {
+	items = /* @__PURE__ */ new Map();
+	/** Register a feature module. Throws when the key already exists. */
+	register(f) {
+		const key = keyOf(f);
+		if (this.items.has(key)) throw new Error(`Duplicate feature ${key}`);
+		this.items.set(key, f);
+		return this;
+	}
+	/** List all registered feature modules. */
+	list() {
+		return [...this.items.values()];
+	}
+	/** Get a feature by its key (slug). */
+	get(key) {
+		return this.items.get(key);
+	}
+};
+/** Validate and register a feature against optional registries/descriptors. */
+function installFeature(feature, deps) {
+	if (deps.ops && feature.operations) {
+		for (const o of feature.operations) if (!deps.ops.getSpec(o.name, o.version)) throw new Error(`installFeature: operation not found ${o.name}.v${o.version}`);
+	}
+	if (deps.presentations && feature.presentations) {
+		for (const p of feature.presentations) if (!deps.presentations.get(p.name, p.version)) throw new Error(`installFeature: presentation not found ${p.name}.v${p.version}`);
+	}
+	if (feature.presentationsTargets && deps.descriptorsV2) for (const req of feature.presentationsTargets) {
+		const d = deps.descriptorsV2.find((x) => x.meta.name === req.name && x.meta.version === req.version);
+		if (!d) throw new Error(`installFeature: V2 descriptor not found ${req.name}.v${req.version}`);
+		for (const t of req.targets) if (!d.targets.includes(t)) throw new Error(`installFeature: descriptor ${req.name}.v${req.version} missing target ${t}`);
+	}
+	if (feature.opToPresentation && feature.opToPresentation.length > 0) for (const link of feature.opToPresentation) {
+		if (deps.ops) {
+			if (!deps.ops.getSpec(link.op.name, link.op.version)) throw new Error(`installFeature: linked op not found ${link.op.name}.v${link.op.version}`);
+		}
+		if (deps.presentations) {
+			if (!deps.presentations.get(link.pres.name, link.pres.version)) throw new Error(`installFeature: linked presentation not found ${link.pres.name}.v${link.pres.version}`);
+		}
+	}
+	if (deps.capabilities && feature.capabilities?.provides) {
+		for (const cap of feature.capabilities.provides) if (!deps.capabilities.get(cap.key, cap.version)) throw new Error(`installFeature: capability not registered ${cap.key}.v${cap.version}`);
+	}
+	if (feature.capabilities?.requires?.length) {
+		if (!deps.capabilities) throw new Error(`installFeature: capability registry required to validate capability requirements for ${feature.meta.key}`);
+		const provided = feature.capabilities.provides ?? [];
+		for (const req of feature.capabilities.requires) if (!deps.capabilities.satisfies(req, provided)) throw new Error(`installFeature: capability requirement not satisfied ${req.key}${req.version ? `.v${req.version}` : ""}`);
+	}
+	deps.features.register(feature);
+	return deps.features;
+}
+/** Ensure declared target requirements exist on the provided descriptors. */
+function validateFeatureTargetsV2(feature, descriptors) {
+	if (!feature.presentationsTargets || feature.presentationsTargets.length === 0) return true;
+	for (const req of feature.presentationsTargets) {
+		const d = descriptors.find((x) => x.meta.name === req.name && x.meta.version === req.version);
+		if (!d) throw new Error(`V2 descriptor not found ${req.name}.v${req.version}`);
+		for (const t of req.targets) if (!d.targets.includes(t)) throw new Error(`Descriptor ${req.name}.v${req.version} missing target ${t}`);
+	}
+	return true;
+}
+
+//#endregion
+export { FeatureRegistry, installFeature, validateFeatureTargetsV2 };

package/dist/forms/docs/forms.docblock.js

@@ -1 +1,22 @@
-import{registerDocBlocks as e}from"../../docs/registry.js";import"../../registry.js";const t=[{id:`docs.tech.contracts.forms`,title:`Contracts: FormSpec`,summary:`This document defines the canonical contracts for declarative forms.`,kind:`reference`,visibility:`public`,route:`/docs/tech/contracts/forms`,tags:[`tech`,`contracts`,`forms`],body:"# Contracts: FormSpec\n\nThis document defines the canonical contracts for declarative forms.\n\n## Overview\n\n- `FormSpec` (in `@lssm/lib.contracts/forms`) declares:\n  - `meta` (extends `OwnerShipMeta`) + `key`/`version` for stability.\n  - `model` (`@lssm/lib.schema` `SchemaModel`) as the single source of truth.\n  - `fields` built from `FieldSpec` kinds: `text`, `textarea`, `select`, `checkbox`, `radio`, `switch`, `group`, `array`.\n  - Optional `actions`, `policy.flags`, `constraints` and `renderHints`.\n- Relations DSL provides `visibleWhen`, `enabledWhen`, `requiredWhen` based on predicates.\n- `buildZodWithRelations(spec)` augments the base zod with conditional rules and constraints.\n- React adapter renders with React Hook Form + driver API for UI components (shadcn driver provided).\n\n## Driver API (UI-agnostic)\n\nHost apps supply a driver mapping slots → components:\n\n- Required: `Field`, `FieldLabel`, `FieldDescription`, `FieldError`, `Input`, `Textarea`, `Select`, `Checkbox`, `RadioGroup`, `Switch`, `Button`.\n- Optional: `FieldGroup`, `FieldSet`, `FieldLegend` and input group helpers.\n\nUse `createFormRenderer({ driver })` to obtain a `render(spec)` function.\n\n## Arrays and Groups\n\n- `array` items are rendered with `useFieldArray`, honoring `min`/`max` and add/remove controls.\n- `group` composes nested fields and provides optional legend/description.\n\n## Feature Flags\n\n- Declare `policy.flags` on forms to signal gating. Gate usage at host boundary; avoid scattering flags across individual fields.\n\n## Example\n\nSee `packages/hcircle/apps/web-coliving/src/forms/bug-report.spec.ts` for a concrete form spec and `components/forms/BugReportFormDemo.tsx` for rendering with a minimal shadcn driver mapping.\n"}];e(t);export{t as tech_contracts_forms_DocBlocks};
+import { registerDocBlocks } from "../../docs/registry.js";
+import "../../registry.js";
+
+//#region src/forms/docs/forms.docblock.ts
+const tech_contracts_forms_DocBlocks = [{
+	id: "docs.tech.contracts.forms",
+	title: "Contracts: FormSpec",
+	summary: "This document defines the canonical contracts for declarative forms.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/tech/contracts/forms",
+	tags: [
+		"tech",
+		"contracts",
+		"forms"
+	],
+	body: "# Contracts: FormSpec\n\nThis document defines the canonical contracts for declarative forms.\n\n## Overview\n\n- `FormSpec` (in `@lssm/lib.contracts/forms`) declares:\n  - `meta` (extends `OwnerShipMeta`) + `key`/`version` for stability.\n  - `model` (`@lssm/lib.schema` `SchemaModel`) as the single source of truth.\n  - `fields` built from `FieldSpec` kinds: `text`, `textarea`, `select`, `checkbox`, `radio`, `switch`, `group`, `array`.\n  - Optional `actions`, `policy.flags`, `constraints` and `renderHints`.\n- Relations DSL provides `visibleWhen`, `enabledWhen`, `requiredWhen` based on predicates.\n- `buildZodWithRelations(spec)` augments the base zod with conditional rules and constraints.\n- React adapter renders with React Hook Form + driver API for UI components (shadcn driver provided).\n\n## Driver API (UI-agnostic)\n\nHost apps supply a driver mapping slots → components:\n\n- Required: `Field`, `FieldLabel`, `FieldDescription`, `FieldError`, `Input`, `Textarea`, `Select`, `Checkbox`, `RadioGroup`, `Switch`, `Button`.\n- Optional: `FieldGroup`, `FieldSet`, `FieldLegend` and input group helpers.\n\nUse `createFormRenderer({ driver })` to obtain a `render(spec)` function.\n\n## Arrays and Groups\n\n- `array` items are rendered with `useFieldArray`, honoring `min`/`max` and add/remove controls.\n- `group` composes nested fields and provides optional legend/description.\n\n## Feature Flags\n\n- Declare `policy.flags` on forms to signal gating. Gate usage at host boundary; avoid scattering flags across individual fields.\n\n## Example\n\nSee `packages/hcircle/apps/web-coliving/src/forms/bug-report.spec.ts` for a concrete form spec and `components/forms/BugReportFormDemo.tsx` for rendering with a minimal shadcn driver mapping.\n"
+}];
+registerDocBlocks(tech_contracts_forms_DocBlocks);
+
+//#endregion
+export { tech_contracts_forms_DocBlocks };

package/dist/forms.js

@@ -1 +1,119 @@
-function e(e){return`${e.key}.v${e.version}`}var t=class{items=new Map;register(t){let n=e(t.meta);if(this.items.has(n))throw Error(`Duplicate form ${n}`);return this.items.set(n,t),this}list(){return[...this.items.values()]}get(e,t){if(t!=null)return this.items.get(`${e}.v${t}`);let n,r=-1/0;for(let[t,i]of this.items.entries())t.startsWith(`${e}.v`)&&i.meta.version>r&&(r=i.meta.version,n=i);return n}};function n(e,t){if(!t)return;let n=t.replace(/\[(\d+)\]/g,`.$1`).split(`.`).filter(Boolean),r=e;for(let e of n){if(r==null)return;r=r[e]}return r}function r(e,t){if(!t)return!0;if(t.not)return!r(e,t.not);if(t.all&&t.all.length)return t.all.every(t=>r(e,t));if(t.any&&t.any.length)return t.any.some(t=>r(e,t));if(t.when){let{path:r,op:i=`truthy`,value:a}=t.when,o=n(e,r);switch(i){case`equals`:return o===a;case`notEquals`:return o!==a;case`in`:return Array.isArray(a)&&a.includes(o);case`notIn`:return Array.isArray(a)&&!a.includes(o);case`gt`:return Number(o)>Number(a);case`gte`:return Number(o)>=Number(a);case`lt`:return Number(o)<Number(a);case`lte`:return Number(o)<=Number(a);case`empty`:return o==null||(Array.isArray(o)?o.length===0:String(o).length===0);case`lengthGt`:return(Array.isArray(o)||typeof o==`string`)&&o.length>Number(a??0);case`lengthGte`:return(Array.isArray(o)||typeof o==`string`)&&o.length>=Number(a??0);case`lengthLt`:return(Array.isArray(o)||typeof o==`string`)&&o.length<Number(a??0);case`lengthLte`:return(Array.isArray(o)||typeof o==`string`)&&o.length<=Number(a??0);case`truthy`:default:return!!o}}return!0}function i(e,t){return e.model.getZod().superRefine((i,a)=>{let o=(e,t)=>{let s=e.name?t?`${t}.${e.name}`:e.name:t??``;if(e.requiredWhen&&r(i,e.requiredWhen)){let e=n(i,s);(e==null||typeof e==`string`&&e.trim().length===0||Array.isArray(e)&&e.length===0)&&a.addIssue({code:`custom`,path:s.split(`.`),message:`required`})}if(e.kind===`array`){let t=n(i,s);e.min!=null&&Array.isArray(t)&&t.length<e.min&&a.addIssue({code:`custom`,path:s.split(`.`),message:`min:${e.min}`}),e.max!=null&&Array.isArray(t)&&t.length>e.max&&a.addIssue({code:`custom`,path:s.split(`.`),message:`max:${e.max}`}),o(e.of,s)}else if(e.kind===`group`)for(let t of e.fields)o(t,s)};for(let t of e.fields)o(t);if(e.constraints&&t)for(let n of e.constraints){let e=t[n.key];if(!e)continue;let r=e(i,n.paths,n.args);r.ok||a.addIssue({code:`custom`,path:(r.path??n.paths[0]??``).split(`.`).filter(Boolean),message:r.message??n.messageI18n})}})}function a(e){return e}export{t as FormRegistry,i as buildZodWithRelations,a as defineFormSpec,r as evalPredicate};
+//#region src/forms.ts
+function formKey(meta) {
+	return `${meta.key}.v${meta.version}`;
+}
+var FormRegistry = class {
+	items = /* @__PURE__ */ new Map();
+	register(spec) {
+		const key = formKey(spec.meta);
+		if (this.items.has(key)) throw new Error(`Duplicate form ${key}`);
+		this.items.set(key, spec);
+		return this;
+	}
+	list() {
+		return [...this.items.values()];
+	}
+	get(key, version) {
+		if (version != null) return this.items.get(`${key}.v${version}`);
+		let candidate;
+		let max = -Infinity;
+		for (const [k, v] of this.items.entries()) {
+			if (!k.startsWith(`${key}.v`)) continue;
+			if (v.meta.version > max) {
+				max = v.meta.version;
+				candidate = v;
+			}
+		}
+		return candidate;
+	}
+};
+function getAtPath(values, path) {
+	if (!path) return void 0;
+	const segs = path.replace(/\[(\d+)\]/g, ".$1").split(".").filter(Boolean);
+	let cur = values;
+	for (const s of segs) {
+		if (cur == null) return void 0;
+		cur = cur[s];
+	}
+	return cur;
+}
+function evalPredicate(values, pred) {
+	if (!pred) return true;
+	if (pred.not) return !evalPredicate(values, pred.not);
+	if (pred.all && pred.all.length) return pred.all.every((p) => evalPredicate(values, p));
+	if (pred.any && pred.any.length) return pred.any.some((p) => evalPredicate(values, p));
+	if (pred.when) {
+		const { path, op = "truthy", value } = pred.when;
+		const v = getAtPath(values, path);
+		switch (op) {
+			case "equals": return v === value;
+			case "notEquals": return v !== value;
+			case "in": return Array.isArray(value) && value.includes(v);
+			case "notIn": return Array.isArray(value) && !value.includes(v);
+			case "gt": return Number(v) > Number(value);
+			case "gte": return Number(v) >= Number(value);
+			case "lt": return Number(v) < Number(value);
+			case "lte": return Number(v) <= Number(value);
+			case "empty": return v == null || (Array.isArray(v) ? v.length === 0 : String(v).length === 0);
+			case "lengthGt": return (Array.isArray(v) || typeof v === "string") && v.length > Number(value ?? 0);
+			case "lengthGte": return (Array.isArray(v) || typeof v === "string") && v.length >= Number(value ?? 0);
+			case "lengthLt": return (Array.isArray(v) || typeof v === "string") && v.length < Number(value ?? 0);
+			case "lengthLte": return (Array.isArray(v) || typeof v === "string") && v.length <= Number(value ?? 0);
+			case "truthy":
+			default: return Boolean(v);
+		}
+	}
+	return true;
+}
+/**
+* Wrap the base zod schema with relation-driven refinements (requiredWhen, array min/max)
+* and optional custom constraints. Call this when wiring RHF resolver.
+*/
+function buildZodWithRelations(spec, handlers) {
+	return spec.model.getZod().superRefine((values, ctx) => {
+		const visit = (field, parentPath) => {
+			const path = field.name ? parentPath ? `${parentPath}.${field.name}` : field.name : parentPath ?? "";
+			if (field.requiredWhen) {
+				if (evalPredicate(values, field.requiredWhen)) {
+					const v = getAtPath(values, path);
+					if (v == null || typeof v === "string" && v.trim().length === 0 || Array.isArray(v) && v.length === 0) ctx.addIssue({
+						code: "custom",
+						path: path.split("."),
+						message: "required"
+					});
+				}
+			}
+			if (field.kind === "array") {
+				const arr = getAtPath(values, path);
+				if (field.min != null && Array.isArray(arr) && arr.length < field.min) ctx.addIssue({
+					code: "custom",
+					path: path.split("."),
+					message: `min:${field.min}`
+				});
+				if (field.max != null && Array.isArray(arr) && arr.length > field.max) ctx.addIssue({
+					code: "custom",
+					path: path.split("."),
+					message: `max:${field.max}`
+				});
+				visit(field.of, path);
+			} else if (field.kind === "group") for (const child of field.fields) visit(child, path);
+		};
+		for (const f of spec.fields) visit(f);
+		if (spec.constraints && handlers) for (const c of spec.constraints) {
+			const fn = handlers[c.key];
+			if (!fn) continue;
+			const res = fn(values, c.paths, c.args);
+			if (!res.ok) ctx.addIssue({
+				code: "custom",
+				path: (res.path ?? c.paths[0] ?? "").split(".").filter(Boolean),
+				message: res.message ?? c.messageI18n
+			});
+		}
+	});
+}
+function defineFormSpec(spec) {
+	return spec;
+}
+
+//#endregion
+export { FormRegistry, buildZodWithRelations, defineFormSpec, evalPredicate };

package/dist/index.js

@@ -1 +1,107 @@
-import{CapabilityRegistry as e,capabilityKey as t,defineCapability as n}from"./capabilities.js";import{DataViewRegistry as r,dataViewKey as i}from"./data-views.js";import{n as a}from"./schema/dist/SchemaModel.js";import"./schema/dist/index.js";import{defineEvent as o,eventKey as s}from"./events.js";import{FeatureRegistry as c,installFeature as l,validateFeatureTargetsV2 as u}from"./features.js";import{FormRegistry as d,buildZodWithRelations as f,defineFormSpec as p,evalPredicate as m}from"./forms.js";import{schemaToMarkdown as h,schemaToMarkdownDetail as g,schemaToMarkdownList as _,schemaToMarkdownSummary as v,schemaToMarkdownTable as y}from"./schema-to-markdown.js";import{TransformEngine as b,createDefaultTransformEngine as x,registerBasicValidation as S,registerDefaultReactRenderer as C,registerReactToMarkdownRenderer as w}from"./presentations.v2.js";import{createEngineWithDefaults as T,createFeatureModule as E,registerFeature as D,renderFeaturePresentation as O}from"./client/react/feature-render.js";import{createFormRenderer as k}from"./client/react/form-render.js";import{shadcnDriver as A}from"./client/react/drivers/shadcn.js";import{rnReusablesDriver as j}from"./client/react/drivers/rn-reusables.js";import"./client/index.js";import{defaultGqlField as M,defaultMcpTool as N,defaultRestPath as P,jsonSchemaForSpec as F}from"./jsonschema.js";import{registerContractsOnBuilder as I}from"./server/graphql-pothos.js";import{PresentationRegistry as L,jsonSchemaForPresentation as R}from"./presentations.js";import{createMcpServer as z}from"./server/mcp/createMcpServer.js";import{createFetchHandler as B}from"./server/rest-generic.js";import{elysiaPlugin as V}from"./server/rest-elysia.js";import{expressRouter as H}from"./server/rest-express.js";import{makeNextAppHandler as U}from"./server/rest-next-app.js";import{makeNextPagesHandler as W}from"./server/rest-next-pages.js";import"./server/index.js";import{defineCommand as G,defineQuery as K,isEmitDeclRef as q}from"./spec.js";import{docBlockToPresentationSpec as J,docBlockToPresentationV2 as Y,docBlocksToPresentationRoutes as X,docBlocksToPresentationSpecs as Z,mapDocRoutes as Q}from"./docs/presentations.js";import{DocRegistry as $,defaultDocRegistry as ee,docId as te,listRegisteredDocBlocks as ne,registerDocBlocks as re}from"./docs/registry.js";import{SpecRegistry as ie,opKey as ae}from"./registry.js";import{Owners as oe,OwnersEnum as se,StabilityEnum as ce,Tags as le,TagsEnum as ue}from"./ownership.js";import{ContractRegistryFileSchema as de,ContractRegistryItemSchema as fe,ContractRegistryItemTypeSchema as pe,ContractRegistryManifestSchema as me}from"./contract-registry/schemas.js";import"./contract-registry/index.js";import{installOp as he,makeEmit as ge,op as _e}from"./install.js";import{openApiForRegistry as ve}from"./openapi.js";import{definePrompt as ye}from"./prompt.js";import{PromptRegistry as be}from"./promptRegistry.js";import{ResourceRegistry as xe,defineResourceTemplate as Se,isResourceRef as Ce,resourceRef as we}from"./resources.js";import{toV2FromV1 as Te}from"./presentations.backcompat.js";import{CompleteOnboardingBaseInput as Ee,CompleteOnboardingBaseOutput as De,CompleteOnboardingBaseSpec as Oe,DeleteOnboardingDraftBaseSpec as ke,DeleteOnboardingDraftOutput as Ae,GetOnboardingDraftBaseSpec as je,GetOnboardingDraftOutput as Me,SaveOnboardingDraftBaseSpec as Ne,SaveOnboardingDraftInput as Pe,SaveOnboardingDraftOutput as Fe}from"./onboarding-base.js";import{openBankingAccountsReadCapability as Ie,openBankingBalancesReadCapability as Le,openBankingTransactionsReadCapability as Re,registerOpenBankingCapabilities as ze}from"./capabilities/openbanking.js";import{PolicyRegistry as Be,makePolicyKey as Ve}from"./policy/spec.js";import{PolicyEngine as He}from"./policy/engine.js";import{OPAPolicyAdapter as Ue,buildOPAInput as We}from"./policy/opa-adapter.js";import{ThemeRegistry as Ge,makeThemeRef as Ke}from"./themes.js";import{MigrationRegistry as qe}from"./migrations.js";import{TelemetryRegistry as Je,makeTelemetryKey as Ye}from"./telemetry/spec.js";import{TelemetryTracker as Xe}from"./telemetry/tracker.js";import{TelemetryAnomalyMonitor as Ze}from"./telemetry/anomaly.js";import"./telemetry/index.js";import{TestRegistry as Qe,makeTestKey as $e}from"./tests/spec.js";import{TestRunner as et}from"./tests/runner.js";import"./tests/index.js";import{ExperimentRegistry as tt,makeExperimentKey as nt}from"./experiments/spec.js";import{ExperimentEvaluator as rt}from"./experiments/evaluator.js";import{AppBlueprintRegistry as it,makeAppBlueprintKey as at}from"./app-config/spec.js";import{composeAppConfig as ot,resolveAppConfig as st}from"./app-config/runtime.js";import{IntegrationSpecRegistry as ct,makeIntegrationSpecKey as lt}from"./integrations/spec.js";import{registerStripeIntegration as ut,stripeIntegrationSpec as dt}from"./integrations/providers/stripe.js";import{postmarkIntegrationSpec as ft,registerPostmarkIntegration as pt}from"./integrations/providers/postmark.js";import{qdrantIntegrationSpec as mt,registerQdrantIntegration as ht}from"./integrations/providers/qdrant.js";import{mistralIntegrationSpec as gt,registerMistralIntegration as _t}from"./integrations/providers/mistral.js";import{elevenLabsIntegrationSpec as vt,registerElevenLabsIntegration as yt}from"./integrations/providers/elevenlabs.js";import{gmailIntegrationSpec as bt,registerGmailIntegration as xt}from"./integrations/providers/gmail.js";import{googleCalendarIntegrationSpec as St,registerGoogleCalendarIntegration as Ct}from"./integrations/providers/google-calendar.js";import{registerTwilioSmsIntegration as wt,twilioSmsIntegrationSpec as Tt}from"./integrations/providers/twilio-sms.js";import{gcsStorageIntegrationSpec as Et,registerGcsStorageIntegration as Dt}from"./integrations/providers/gcs-storage.js";import{powensIntegrationSpec as Ot,registerPowensIntegration as kt}from"./integrations/providers/powens.js";import{createDefaultIntegrationSpecRegistry as At}from"./integrations/providers/registry.js";import{AccountBalanceRecord as jt,BankAccountRecord as Mt,BankTransactionRecord as Nt}from"./integrations/openbanking/models.js";import{OPENBANKING_PII_FIELDS as Pt,OPENBANKING_TELEMETRY_EVENTS as Ft,redactOpenBankingTelemetryPayload as It}from"./integrations/openbanking/telemetry.js";import{OpenBankingGetAccount as Lt,OpenBankingListAccounts as Rt,OpenBankingSyncAccounts as zt}from"./integrations/openbanking/contracts/accounts.js";import{OpenBankingListTransactions as Bt,OpenBankingSyncTransactions as Vt}from"./integrations/openbanking/contracts/transactions.js";import{OpenBankingGetBalances as Ht,OpenBankingRefreshBalances as Ut}from"./integrations/openbanking/contracts/balances.js";import{OpenBankingFeature as Wt}from"./integrations/openbanking/openbanking.feature.js";import{registerOpenBankingContracts as Gt}from"./integrations/openbanking/contracts/index.js";import{assertPrimaryOpenBankingReady as Kt,ensurePrimaryOpenBankingIntegration as qt}from"./integrations/openbanking/guards.js";import"./integrations/index.js";import{KnowledgeSpaceRegistry as Jt,makeKnowledgeSpaceKey as Yt}from"./knowledge/spec.js";import{productCanonKnowledgeSpace as Xt,registerProductCanonKnowledgeSpace as Zt}from"./knowledge/spaces/product-canon.js";import{registerSupportFaqKnowledgeSpace as Qt,supportFaqKnowledgeSpace as $t}from"./knowledge/spaces/support-faq.js";import{emailThreadsKnowledgeSpace as en,registerEmailThreadsKnowledgeSpace as tn}from"./knowledge/spaces/email-threads.js";import{registerUploadedDocsKnowledgeSpace as nn,uploadedDocsKnowledgeSpace as rn}from"./knowledge/spaces/uploaded-docs.js";import{financialDocsKnowledgeSpace as an,registerFinancialDocsKnowledgeSpace as on}from"./knowledge/spaces/financial-docs.js";import{financialOverviewKnowledgeSpace as sn,registerFinancialOverviewKnowledgeSpace as cn}from"./knowledge/spaces/financial-overview.js";import"./knowledge/index.js";import{CreateIntegrationConnection as ln,DeleteIntegrationConnection as un,ListIntegrationConnections as dn,TestIntegrationConnection as fn,UpdateIntegrationConnection as pn,integrationContracts as mn,registerIntegrationContracts as hn}from"./integrations/contracts.js";import{CreateKnowledgeSource as gn,DeleteKnowledgeSource as _n,ListKnowledgeSources as vn,TriggerKnowledgeSourceSync as yn,UpdateKnowledgeSource as bn,knowledgeContracts as xn,registerKnowledgeContracts as Sn}from"./knowledge/contracts.js";import{behaviorToEnvelope as Cn,errorToEnvelope as wn,telemetryToEnvelope as Tn}from"./regenerator/utils.js";import{RegeneratorService as En}from"./regenerator/service.js";import{ProposalExecutor as Dn}from"./regenerator/executor.js";import{ExecutorProposalSink as On}from"./regenerator/sinks.js";import"./regenerator/index.js";import{WorkflowRegistry as kn}from"./workflow/spec.js";import{WorkflowValidationError as An,assertWorkflowSpecValid as jn,validateWorkflowSpec as Mn}from"./workflow/validation.js";import{evaluateExpression as Nn}from"./workflow/expression.js";import{WorkflowPreFlightError as Pn,WorkflowRunner as Fn}from"./workflow/runner.js";import{InMemoryStateStore as In}from"./workflow/adapters/memory-store.js";import{PrismaStateStore as Ln}from"./workflow/adapters/db-adapter.js";import{createFileStateStore as Rn}from"./workflow/adapters/file-adapter.js";import"./workflow/index.js";import{techContractsDocs as zn}from"./docs/tech-contracts.docs.js";import{metaDocs as Bn}from"./docs/meta.docs.js";import"./docs/index.js";import{docBlockToMarkdown as Vn,eventToMarkdown as Hn,exportFeature as Un,exportSpec as Wn,featureToMarkdown as Gn,presentationToMarkdown as Kn,specToAgentPrompt as qn,specToContextMarkdown as Jn,specToFullMarkdown as Yn}from"./llm/exporters.js";import{AGENT_SYSTEM_PROMPTS as Xn,formatPlanForAgent as Zn,generateFixViolationsPrompt as Qn,generateImplementationPlan as $n,generateImplementationPrompt as er,generateReviewPrompt as tr,generateTestPrompt as nr,generateVerificationPrompt as rr}from"./llm/prompts.js";import"./llm/index.js";export{Xn as AGENT_SYSTEM_PROMPTS,jt as AccountBalanceRecord,it as AppBlueprintRegistry,Mt as BankAccountRecord,Nt as BankTransactionRecord,e as CapabilityRegistry,Ee as CompleteOnboardingBaseInput,De as CompleteOnboardingBaseOutput,Oe as CompleteOnboardingBaseSpec,de as ContractRegistryFileSchema,fe as ContractRegistryItemSchema,pe as ContractRegistryItemTypeSchema,me as ContractRegistryManifestSchema,ln as CreateIntegrationConnection,gn as CreateKnowledgeSource,r as DataViewRegistry,un as DeleteIntegrationConnection,_n as DeleteKnowledgeSource,ke as DeleteOnboardingDraftBaseSpec,Ae as DeleteOnboardingDraftOutput,$ as DocRegistry,On as ExecutorProposalSink,rt as ExperimentEvaluator,tt as ExperimentRegistry,c as FeatureRegistry,d as FormRegistry,je as GetOnboardingDraftBaseSpec,Me as GetOnboardingDraftOutput,In as InMemoryStateStore,ct as IntegrationSpecRegistry,Jt as KnowledgeSpaceRegistry,dn as ListIntegrationConnections,vn as ListKnowledgeSources,qe as MigrationRegistry,Ue as OPAPolicyAdapter,Pt as OPENBANKING_PII_FIELDS,Ft as OPENBANKING_TELEMETRY_EVENTS,Wt as OpenBankingFeature,Lt as OpenBankingGetAccount,Ht as OpenBankingGetBalances,Rt as OpenBankingListAccounts,Bt as OpenBankingListTransactions,Ut as OpenBankingRefreshBalances,zt as OpenBankingSyncAccounts,Vt as OpenBankingSyncTransactions,oe as Owners,se as OwnersEnum,He as PolicyEngine,Be as PolicyRegistry,L as PresentationRegistry,Ln as PrismaStateStore,be as PromptRegistry,Dn as ProposalExecutor,En as RegeneratorService,xe as ResourceRegistry,Ne as SaveOnboardingDraftBaseSpec,Pe as SaveOnboardingDraftInput,Fe as SaveOnboardingDraftOutput,ie as SpecRegistry,ce as StabilityEnum,le as Tags,ue as TagsEnum,Ze as TelemetryAnomalyMonitor,Je as TelemetryRegistry,Xe as TelemetryTracker,fn as TestIntegrationConnection,Qe as TestRegistry,et as TestRunner,Ge as ThemeRegistry,b as TransformEngine,yn as TriggerKnowledgeSourceSync,pn as UpdateIntegrationConnection,bn as UpdateKnowledgeSource,Pn as WorkflowPreFlightError,kn as WorkflowRegistry,Fn as WorkflowRunner,An as WorkflowValidationError,Kt as assertPrimaryOpenBankingReady,jn as assertWorkflowSpecValid,Cn as behaviorToEnvelope,We as buildOPAInput,f as buildZodWithRelations,t as capabilityKey,ot as composeAppConfig,At as createDefaultIntegrationSpecRegistry,x as createDefaultTransformEngine,T as createEngineWithDefaults,E as createFeatureModule,B as createFetchHandler,Rn as createFileStateStore,k as createFormRenderer,z as createMcpServer,i as dataViewKey,ee as defaultDocRegistry,M as defaultGqlField,N as defaultMcpTool,P as defaultRestPath,n as defineCapability,G as defineCommand,o as defineEvent,p as defineFormSpec,ye as definePrompt,K as defineQuery,Se as defineResourceTemplate,a as defineSchemaModel,Vn as docBlockToMarkdown,J as docBlockToPresentationSpec,Y as docBlockToPresentationV2,X as docBlocksToPresentationRoutes,Z as docBlocksToPresentationSpecs,te as docId,vt as elevenLabsIntegrationSpec,V as elysiaPlugin,en as emailThreadsKnowledgeSpace,qt as ensurePrimaryOpenBankingIntegration,wn as errorToEnvelope,m as evalPredicate,Nn as evaluateExpression,s as eventKey,Hn as eventToMarkdown,Un as exportFeature,Wn as exportSpec,H as expressRouter,Gn as featureToMarkdown,an as financialDocsKnowledgeSpace,sn as financialOverviewKnowledgeSpace,Zn as formatPlanForAgent,Et as gcsStorageIntegrationSpec,Qn as generateFixViolationsPrompt,$n as generateImplementationPlan,er as generateImplementationPrompt,tr as generateReviewPrompt,nr as generateTestPrompt,rr as generateVerificationPrompt,bt as gmailIntegrationSpec,St as googleCalendarIntegrationSpec,l as installFeature,he as installOp,mn as integrationContracts,q as isEmitDeclRef,Ce as isResourceRef,R as jsonSchemaForPresentation,F as jsonSchemaForSpec,xn as knowledgeContracts,ne as listRegisteredDocBlocks,at as makeAppBlueprintKey,ge as makeEmit,nt as makeExperimentKey,lt as makeIntegrationSpecKey,Yt as makeKnowledgeSpaceKey,U as makeNextAppHandler,W as makeNextPagesHandler,Ve as makePolicyKey,Ye as makeTelemetryKey,$e as makeTestKey,Ke as makeThemeRef,Q as mapDocRoutes,Bn as metaDocs,gt as mistralIntegrationSpec,_e as op,ae as opKey,ve as openApiForRegistry,Ie as openBankingAccountsReadCapability,Le as openBankingBalancesReadCapability,Re as openBankingTransactionsReadCapability,ft as postmarkIntegrationSpec,Ot as powensIntegrationSpec,Kn as presentationToMarkdown,Xt as productCanonKnowledgeSpace,mt as qdrantIntegrationSpec,It as redactOpenBankingTelemetryPayload,S as registerBasicValidation,I as registerContractsOnBuilder,C as registerDefaultReactRenderer,re as registerDocBlocks,yt as registerElevenLabsIntegration,tn as registerEmailThreadsKnowledgeSpace,D as registerFeature,on as registerFinancialDocsKnowledgeSpace,cn as registerFinancialOverviewKnowledgeSpace,Dt as registerGcsStorageIntegration,xt as registerGmailIntegration,Ct as registerGoogleCalendarIntegration,hn as registerIntegrationContracts,Sn as registerKnowledgeContracts,_t as registerMistralIntegration,ze as registerOpenBankingCapabilities,Gt as registerOpenBankingContracts,pt as registerPostmarkIntegration,kt as registerPowensIntegration,Zt as registerProductCanonKnowledgeSpace,ht as registerQdrantIntegration,w as registerReactToMarkdownRenderer,ut as registerStripeIntegration,Qt as registerSupportFaqKnowledgeSpace,wt as registerTwilioSmsIntegration,nn as registerUploadedDocsKnowledgeSpace,O as renderFeaturePresentation,st as resolveAppConfig,we as resourceRef,j as rnReusablesDriver,h as schemaToMarkdown,g as schemaToMarkdownDetail,_ as schemaToMarkdownList,v as schemaToMarkdownSummary,y as schemaToMarkdownTable,A as shadcnDriver,qn as specToAgentPrompt,Jn as specToContextMarkdown,Yn as specToFullMarkdown,dt as stripeIntegrationSpec,$t as supportFaqKnowledgeSpace,zn as techContractsDocs,Tn as telemetryToEnvelope,Te as toV2FromV1,Tt as twilioSmsIntegrationSpec,rn as uploadedDocsKnowledgeSpace,u as validateFeatureTargetsV2,Mn as validateWorkflowSpec};
+import { CapabilityRegistry, capabilityKey, defineCapability } from "./capabilities.js";
+import { DataViewRegistry, dataViewKey } from "./data-views.js";
+import { defineSchemaModel } from "./schema/dist/SchemaModel.js";
+import "./schema/dist/index.js";
+import { defineEvent, eventKey } from "./events.js";
+import { FeatureRegistry, installFeature, validateFeatureTargetsV2 } from "./features.js";
+import { FormRegistry, buildZodWithRelations, defineFormSpec, evalPredicate } from "./forms.js";
+import { schemaToMarkdown, schemaToMarkdownDetail, schemaToMarkdownList, schemaToMarkdownSummary, schemaToMarkdownTable } from "./schema-to-markdown.js";
+import { TransformEngine, createDefaultTransformEngine, registerBasicValidation, registerDefaultReactRenderer, registerReactToMarkdownRenderer } from "./presentations.v2.js";
+import { createEngineWithDefaults, createFeatureModule, registerFeature, renderFeaturePresentation } from "./client/react/feature-render.js";
+import { createFormRenderer } from "./client/react/form-render.js";
+import { shadcnDriver } from "./client/react/drivers/shadcn.js";
+import { rnReusablesDriver } from "./client/react/drivers/rn-reusables.js";
+import "./client/index.js";
+import { defaultGqlField, defaultMcpTool, defaultRestPath, jsonSchemaForSpec } from "./jsonschema.js";
+import { registerContractsOnBuilder } from "./server/graphql-pothos.js";
+import { PresentationRegistry, jsonSchemaForPresentation } from "./presentations.js";
+import { createMcpServer } from "./server/mcp/createMcpServer.js";
+import { createFetchHandler } from "./server/rest-generic.js";
+import { elysiaPlugin } from "./server/rest-elysia.js";
+import { expressRouter } from "./server/rest-express.js";
+import { makeNextAppHandler } from "./server/rest-next-app.js";
+import { makeNextPagesHandler } from "./server/rest-next-pages.js";
+import "./server/index.js";
+import { defineCommand, defineQuery, isEmitDeclRef } from "./spec.js";
+import { docBlockToPresentationSpec, docBlockToPresentationV2, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, mapDocRoutes } from "./docs/presentations.js";
+import { DocRegistry, defaultDocRegistry, docId, listRegisteredDocBlocks, registerDocBlocks } from "./docs/registry.js";
+import { SpecRegistry, opKey } from "./registry.js";
+import { Owners, OwnersEnum, StabilityEnum, Tags, TagsEnum } from "./ownership.js";
+import { ContractRegistryFileSchema, ContractRegistryItemSchema, ContractRegistryItemTypeSchema, ContractRegistryManifestSchema } from "./contract-registry/schemas.js";
+import "./contract-registry/index.js";
+import { installOp, makeEmit, op } from "./install.js";
+import { openApiForRegistry } from "./openapi.js";
+import { definePrompt } from "./prompt.js";
+import { PromptRegistry } from "./promptRegistry.js";
+import { ResourceRegistry, defineResourceTemplate, isResourceRef, resourceRef } from "./resources.js";
+import { toV2FromV1 } from "./presentations.backcompat.js";
+import { CompleteOnboardingBaseInput, CompleteOnboardingBaseOutput, CompleteOnboardingBaseSpec, DeleteOnboardingDraftBaseSpec, DeleteOnboardingDraftOutput, GetOnboardingDraftBaseSpec, GetOnboardingDraftOutput, SaveOnboardingDraftBaseSpec, SaveOnboardingDraftInput, SaveOnboardingDraftOutput } from "./onboarding-base.js";
+import { openBankingAccountsReadCapability, openBankingBalancesReadCapability, openBankingTransactionsReadCapability, registerOpenBankingCapabilities } from "./capabilities/openbanking.js";
+import { PolicyRegistry, makePolicyKey } from "./policy/spec.js";
+import { PolicyEngine } from "./policy/engine.js";
+import { OPAPolicyAdapter, buildOPAInput } from "./policy/opa-adapter.js";
+import { ThemeRegistry, makeThemeRef } from "./themes.js";
+import { MigrationRegistry } from "./migrations.js";
+import { TelemetryRegistry, makeTelemetryKey } from "./telemetry/spec.js";
+import { TelemetryTracker } from "./telemetry/tracker.js";
+import { TelemetryAnomalyMonitor } from "./telemetry/anomaly.js";
+import "./telemetry/index.js";
+import { TestRegistry, makeTestKey } from "./tests/spec.js";
+import { TestRunner } from "./tests/runner.js";
+import "./tests/index.js";
+import { ExperimentRegistry, makeExperimentKey } from "./experiments/spec.js";
+import { ExperimentEvaluator } from "./experiments/evaluator.js";
+import { AppBlueprintRegistry, makeAppBlueprintKey } from "./app-config/spec.js";
+import { composeAppConfig, resolveAppConfig } from "./app-config/runtime.js";
+import { IntegrationSpecRegistry, makeIntegrationSpecKey } from "./integrations/spec.js";
+import { registerStripeIntegration, stripeIntegrationSpec } from "./integrations/providers/stripe.js";
+import { postmarkIntegrationSpec, registerPostmarkIntegration } from "./integrations/providers/postmark.js";
+import { qdrantIntegrationSpec, registerQdrantIntegration } from "./integrations/providers/qdrant.js";
+import { mistralIntegrationSpec, registerMistralIntegration } from "./integrations/providers/mistral.js";
+import { elevenLabsIntegrationSpec, registerElevenLabsIntegration } from "./integrations/providers/elevenlabs.js";
+import { gmailIntegrationSpec, registerGmailIntegration } from "./integrations/providers/gmail.js";
+import { googleCalendarIntegrationSpec, registerGoogleCalendarIntegration } from "./integrations/providers/google-calendar.js";
+import { registerTwilioSmsIntegration, twilioSmsIntegrationSpec } from "./integrations/providers/twilio-sms.js";
+import { gcsStorageIntegrationSpec, registerGcsStorageIntegration } from "./integrations/providers/gcs-storage.js";
+import { powensIntegrationSpec, registerPowensIntegration } from "./integrations/providers/powens.js";
+import { createDefaultIntegrationSpecRegistry } from "./integrations/providers/registry.js";
+import { AccountBalanceRecord, BankAccountRecord, BankTransactionRecord } from "./integrations/openbanking/models.js";
+import { OPENBANKING_PII_FIELDS, OPENBANKING_TELEMETRY_EVENTS, redactOpenBankingTelemetryPayload } from "./integrations/openbanking/telemetry.js";
+import { OpenBankingGetAccount, OpenBankingListAccounts, OpenBankingSyncAccounts } from "./integrations/openbanking/contracts/accounts.js";
+import { OpenBankingListTransactions, OpenBankingSyncTransactions } from "./integrations/openbanking/contracts/transactions.js";
+import { OpenBankingGetBalances, OpenBankingRefreshBalances } from "./integrations/openbanking/contracts/balances.js";
+import { OpenBankingFeature } from "./integrations/openbanking/openbanking.feature.js";
+import { registerOpenBankingContracts } from "./integrations/openbanking/contracts/index.js";
+import { assertPrimaryOpenBankingReady, ensurePrimaryOpenBankingIntegration } from "./integrations/openbanking/guards.js";
+import "./integrations/index.js";
+import { KnowledgeSpaceRegistry, makeKnowledgeSpaceKey } from "./knowledge/spec.js";
+import { productCanonKnowledgeSpace, registerProductCanonKnowledgeSpace } from "./knowledge/spaces/product-canon.js";
+import { registerSupportFaqKnowledgeSpace, supportFaqKnowledgeSpace } from "./knowledge/spaces/support-faq.js";
+import { emailThreadsKnowledgeSpace, registerEmailThreadsKnowledgeSpace } from "./knowledge/spaces/email-threads.js";
+import { registerUploadedDocsKnowledgeSpace, uploadedDocsKnowledgeSpace } from "./knowledge/spaces/uploaded-docs.js";
+import { financialDocsKnowledgeSpace, registerFinancialDocsKnowledgeSpace } from "./knowledge/spaces/financial-docs.js";
+import { financialOverviewKnowledgeSpace, registerFinancialOverviewKnowledgeSpace } from "./knowledge/spaces/financial-overview.js";
+import "./knowledge/index.js";
+import { CreateIntegrationConnection, DeleteIntegrationConnection, ListIntegrationConnections, TestIntegrationConnection, UpdateIntegrationConnection, integrationContracts, registerIntegrationContracts } from "./integrations/contracts.js";
+import { CreateKnowledgeSource, DeleteKnowledgeSource, ListKnowledgeSources, TriggerKnowledgeSourceSync, UpdateKnowledgeSource, knowledgeContracts, registerKnowledgeContracts } from "./knowledge/contracts.js";
+import { behaviorToEnvelope, errorToEnvelope, telemetryToEnvelope } from "./regenerator/utils.js";
+import { RegeneratorService } from "./regenerator/service.js";
+import { ProposalExecutor } from "./regenerator/executor.js";
+import { ExecutorProposalSink } from "./regenerator/sinks.js";
+import "./regenerator/index.js";
+import { WorkflowRegistry } from "./workflow/spec.js";
+import { WorkflowValidationError, assertWorkflowSpecValid, validateWorkflowSpec } from "./workflow/validation.js";
+import { evaluateExpression } from "./workflow/expression.js";
+import { WorkflowPreFlightError, WorkflowRunner } from "./workflow/runner.js";
+import { InMemoryStateStore } from "./workflow/adapters/memory-store.js";
+import { PrismaStateStore } from "./workflow/adapters/db-adapter.js";
+import { createFileStateStore } from "./workflow/adapters/file-adapter.js";
+import "./workflow/index.js";
+import { techContractsDocs } from "./docs/tech-contracts.docs.js";
+import { metaDocs } from "./docs/meta.docs.js";
+import "./docs/index.js";
+import { docBlockToMarkdown, eventToMarkdown, exportFeature, exportSpec, featureToMarkdown, presentationToMarkdown, specToAgentPrompt, specToContextMarkdown, specToFullMarkdown } from "./llm/exporters.js";
+import { AGENT_SYSTEM_PROMPTS, formatPlanForAgent, generateFixViolationsPrompt, generateImplementationPlan, generateImplementationPrompt, generateReviewPrompt, generateTestPrompt, generateVerificationPrompt } from "./llm/prompts.js";
+import "./llm/index.js";
+
+export { AGENT_SYSTEM_PROMPTS, AccountBalanceRecord, AppBlueprintRegistry, BankAccountRecord, BankTransactionRecord, CapabilityRegistry, CompleteOnboardingBaseInput, CompleteOnboardingBaseOutput, CompleteOnboardingBaseSpec, ContractRegistryFileSchema, ContractRegistryItemSchema, ContractRegistryItemTypeSchema, ContractRegistryManifestSchema, CreateIntegrationConnection, CreateKnowledgeSource, DataViewRegistry, DeleteIntegrationConnection, DeleteKnowledgeSource, DeleteOnboardingDraftBaseSpec, DeleteOnboardingDraftOutput, DocRegistry, ExecutorProposalSink, ExperimentEvaluator, ExperimentRegistry, FeatureRegistry, FormRegistry, GetOnboardingDraftBaseSpec, GetOnboardingDraftOutput, InMemoryStateStore, IntegrationSpecRegistry, KnowledgeSpaceRegistry, ListIntegrationConnections, ListKnowledgeSources, MigrationRegistry, OPAPolicyAdapter, OPENBANKING_PII_FIELDS, OPENBANKING_TELEMETRY_EVENTS, OpenBankingFeature, OpenBankingGetAccount, OpenBankingGetBalances, OpenBankingListAccounts, OpenBankingListTransactions, OpenBankingRefreshBalances, OpenBankingSyncAccounts, OpenBankingSyncTransactions, Owners, OwnersEnum, PolicyEngine, PolicyRegistry, PresentationRegistry, PrismaStateStore, PromptRegistry, ProposalExecutor, RegeneratorService, ResourceRegistry, SaveOnboardingDraftBaseSpec, SaveOnboardingDraftInput, SaveOnboardingDraftOutput, SpecRegistry, StabilityEnum, Tags, TagsEnum, TelemetryAnomalyMonitor, TelemetryRegistry, TelemetryTracker, TestIntegrationConnection, TestRegistry, TestRunner, ThemeRegistry, TransformEngine, TriggerKnowledgeSourceSync, UpdateIntegrationConnection, UpdateKnowledgeSource, WorkflowPreFlightError, WorkflowRegistry, WorkflowRunner, WorkflowValidationError, assertPrimaryOpenBankingReady, assertWorkflowSpecValid, behaviorToEnvelope, buildOPAInput, buildZodWithRelations, capabilityKey, composeAppConfig, createDefaultIntegrationSpecRegistry, createDefaultTransformEngine, createEngineWithDefaults, createFeatureModule, createFetchHandler, createFileStateStore, createFormRenderer, createMcpServer, dataViewKey, defaultDocRegistry, defaultGqlField, defaultMcpTool, defaultRestPath, defineCapability, defineCommand, defineEvent, defineFormSpec, definePrompt, defineQuery, defineResourceTemplate, defineSchemaModel, docBlockToMarkdown, docBlockToPresentationSpec, docBlockToPresentationV2, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, docId, elevenLabsIntegrationSpec, elysiaPlugin, emailThreadsKnowledgeSpace, ensurePrimaryOpenBankingIntegration, errorToEnvelope, evalPredicate, evaluateExpression, eventKey, eventToMarkdown, exportFeature, exportSpec, expressRouter, featureToMarkdown, financialDocsKnowledgeSpace, financialOverviewKnowledgeSpace, formatPlanForAgent, gcsStorageIntegrationSpec, generateFixViolationsPrompt, generateImplementationPlan, generateImplementationPrompt, generateReviewPrompt, generateTestPrompt, generateVerificationPrompt, gmailIntegrationSpec, googleCalendarIntegrationSpec, installFeature, installOp, integrationContracts, isEmitDeclRef, isResourceRef, jsonSchemaForPresentation, jsonSchemaForSpec, knowledgeContracts, listRegisteredDocBlocks, makeAppBlueprintKey, makeEmit, makeExperimentKey, makeIntegrationSpecKey, makeKnowledgeSpaceKey, makeNextAppHandler, makeNextPagesHandler, makePolicyKey, makeTelemetryKey, makeTestKey, makeThemeRef, mapDocRoutes, metaDocs, mistralIntegrationSpec, op, opKey, openApiForRegistry, openBankingAccountsReadCapability, openBankingBalancesReadCapability, openBankingTransactionsReadCapability, postmarkIntegrationSpec, powensIntegrationSpec, presentationToMarkdown, productCanonKnowledgeSpace, qdrantIntegrationSpec, redactOpenBankingTelemetryPayload, registerBasicValidation, registerContractsOnBuilder, registerDefaultReactRenderer, registerDocBlocks, registerElevenLabsIntegration, registerEmailThreadsKnowledgeSpace, registerFeature, registerFinancialDocsKnowledgeSpace, registerFinancialOverviewKnowledgeSpace, registerGcsStorageIntegration, registerGmailIntegration, registerGoogleCalendarIntegration, registerIntegrationContracts, registerKnowledgeContracts, registerMistralIntegration, registerOpenBankingCapabilities, registerOpenBankingContracts, registerPostmarkIntegration, registerPowensIntegration, registerProductCanonKnowledgeSpace, registerQdrantIntegration, registerReactToMarkdownRenderer, registerStripeIntegration, registerSupportFaqKnowledgeSpace, registerTwilioSmsIntegration, registerUploadedDocsKnowledgeSpace, renderFeaturePresentation, resolveAppConfig, resourceRef, rnReusablesDriver, schemaToMarkdown, schemaToMarkdownDetail, schemaToMarkdownList, schemaToMarkdownSummary, schemaToMarkdownTable, shadcnDriver, specToAgentPrompt, specToContextMarkdown, specToFullMarkdown, stripeIntegrationSpec, supportFaqKnowledgeSpace, techContractsDocs, telemetryToEnvelope, toV2FromV1, twilioSmsIntegrationSpec, uploadedDocsKnowledgeSpace, validateFeatureTargetsV2, validateWorkflowSpec };

package/dist/install.js

@@ -1 +1,40 @@
-import"./registry.js";import"zod";function e(e,t){return{ref:async(e,n)=>{await t.__emitGuard__?.(e.name,e.version,n)},named:async(e,n,r)=>{await t.__emitGuard__?.(e,n,r)},object:async e=>{await t.__emitGuard__?.(e.name,e.version,e.payload)}}}function t(e,t,n){return e.register(t).bind(t,n)}function n(e,n){return{spec:e,handler:n,install:r=>t(r,e,n)}}export{t as installOp,e as makeEmit,n as op};
+import "./registry.js";
+import "zod";
+
+//#region src/install.ts
+/** Typed emit for a given spec (validates at runtime through ctx.__emitGuard__). */
+function makeEmit(_spec, ctx) {
+	return {
+		ref: async (ev, payload) => {
+			await ctx.__emitGuard__?.(ev.name, ev.version, payload);
+		},
+		named: async (name, version, payload) => {
+			await ctx.__emitGuard__?.(name, version, payload);
+		},
+		object: async (evt) => {
+			await ctx.__emitGuard__?.(evt.name, evt.version, evt.payload);
+		}
+	};
+}
+/**
+* Register the Spec and bind the handler in one call, with full type inference.
+* Returns the registry for chaining.
+*/
+function installOp(reg, spec, handler) {
+	return reg.register(spec).bind(spec, handler);
+}
+/**
+* Curried variant if you prefer building a module installer.
+*   const install = op(BeginSignupSpec, handler);
+*   install(reg);
+*/
+function op(spec, handler) {
+	return {
+		spec,
+		handler,
+		install: (reg) => installOp(reg, spec, handler)
+	};
+}
+
+//#endregion
+export { installOp, makeEmit, op };