@lssm/lib.contracts 0.0.0-canary-20251120170226

package/dist/presentations.d.ts

@@ -0,0 +1,97 @@
+import { Stability } from "./ownership.js";
+import z$1 from "zod";
+import { AnySchemaModel } from "@lssm/lib.schema";
+
+//#region src/presentations.d.ts
+/** V1 presentation kinds (back-compat). Prefer V2 descriptors for new work. */
+type PresentationKind = 'web_component' | 'markdown' | 'data';
+/** Minimal metadata for presentations (V1). */
+interface PresentationMeta {
+  name: string;
+  version: number;
+  stability?: Stability;
+  owners?: string[];
+  tags?: string[];
+  description?: string;
+}
+/** Policy for presentations (flags, pii). */
+interface PresentationPolicy {
+  flags?: string[];
+  pii?: string[];
+}
+/** Web component presentation (V1). */
+interface WebComponentPresentation {
+  kind: 'web_component';
+  framework: 'react';
+  /** Symbolic key resolved by host via component map */
+  componentKey: string;
+  /** Props schema (validated at runtime) */
+  props: AnySchemaModel;
+  analytics?: string[];
+}
+/** Markdown presentation (V1). */
+interface MarkdownPresentation {
+  kind: 'markdown';
+  /** Inline markdown/MDX content */
+  content?: string;
+  /** Or a resolvable resource URI handled by ResourceRegistry */
+  resourceUri?: string;
+}
+/** Data presentation (V1): structured export description. */
+interface DataPresentation {
+  kind: 'data';
+  mimeType: string;
+  /** Structured data schema */
+  model: AnySchemaModel;
+}
+type PresentationContent = WebComponentPresentation | MarkdownPresentation | DataPresentation;
+interface PresentationSpec {
+  meta: PresentationMeta;
+  policy?: PresentationPolicy;
+  content: PresentationContent;
+}
+/** In-memory registry for V1 PresentationSpec. */
+declare class PresentationRegistry {
+  private items;
+  register(p: PresentationSpec): this;
+  list(): PresentationSpec[];
+  get(name: string, version?: number): PresentationSpec | undefined;
+}
+declare function jsonSchemaForPresentation(p: PresentationSpec): {
+  framework: "react";
+  componentKey: string;
+  props: z$1.core.JSONSchema.JSONSchema;
+  meta: {
+    readonly name: string;
+    readonly version: number;
+    readonly stability: Stability;
+    readonly tags: string[];
+    readonly description: string;
+  };
+  kind: PresentationKind;
+} | {
+  content: string | undefined;
+  resourceUri: string | undefined;
+  meta: {
+    readonly name: string;
+    readonly version: number;
+    readonly stability: Stability;
+    readonly tags: string[];
+    readonly description: string;
+  };
+  kind: PresentationKind;
+} | {
+  mimeType: string;
+  model: z$1.core.JSONSchema.JSONSchema;
+  meta: {
+    readonly name: string;
+    readonly version: number;
+    readonly stability: Stability;
+    readonly tags: string[];
+    readonly description: string;
+  };
+  kind: PresentationKind;
+};
+//#endregion
+export { DataPresentation, MarkdownPresentation, PresentationContent, PresentationKind, PresentationMeta, PresentationPolicy, PresentationRegistry, PresentationSpec, WebComponentPresentation, jsonSchemaForPresentation };
+//# sourceMappingURL=presentations.d.ts.map

package/dist/presentations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentations.d.ts","names":[],"sources":["../src/presentations.ts"],"sourcesContent":[],"mappings":";;;;;;KAKY,gBAAA;AAAZ;AAGiB,UAAA,gBAAA,CAAgB;EAUhB,IAAA,EAAA,MAAA;EAMA,OAAA,EAAA,MAAA;EAWA,SAAA,CAAA,EAxBH,SAwBG;EASA,MAAA,CAAA,EAAA,MAAA,EAAA;EAOL,IAAA,CAAA,EAAA,MAAA,EAAA;EACR,WAAA,CAAA,EAAA,MAAA;;;AAEgB,UApCH,kBAAA,CAoCG;EAEH,KAAA,CAAA,EAAA,MAAA,EAAA;EACT,GAAA,CAAA,EAAA,MAAA,EAAA;;;AAEsB,UAnCb,wBAAA,CAmCa;EAQjB,IAAA,EAAA,eAAA;EAGC,SAAA,EAAA,OAAA;EAOJ;EAI6B,YAAA,EAAA,MAAA;EAAgB;EAevC,KAAA,EAlEP,cAkEO;EAA6B,SAAA,CAAA,EAAA,MAAA,EAAA;;;AASR,UAtEpB,oBAAA,CAsEoB;;EAAA;;;EAAA,WAAA,CAAA,EAAA,MAAA;;;UA7DpB,gBAAA;;;;SAIR;;KAGG,mBAAA,GACR,2BACA,uBACA;UAEa,gBAAA;QACT;WACG;WACA;;;cAQE,oBAAA;;cAGC;UAOJ;uCAI6B;;iBAevB,yBAAA,IAA6B;;;;;;;;;;;QASR;;;;;;;;;;;QAAA;;;;;;;;;;;QAAA"}

package/dist/presentations.js

@@ -0,0 +1,2 @@
+import e from"zod";function t(e){return`${e.meta.name}.v${e.meta.version}`}var n=class{items=new Map;register(e){let n=t(e);if(this.items.has(n))throw Error(`Duplicate presentation ${n}`);return this.items.set(n,e),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 r(t){let n={meta:{name:t.meta.name,version:t.meta.version,stability:t.meta.stability??`stable`,tags:t.meta.tags??[],description:t.meta.description??``},kind:t.content.kind};return t.content.kind===`web_component`?{...n,framework:t.content.framework,componentKey:t.content.componentKey,props:e.toJSONSchema(t.content.props.getZod())}:t.content.kind===`markdown`?{...n,content:t.content.content,resourceUri:t.content.resourceUri}:{...n,mimeType:t.content.mimeType,model:e.toJSONSchema(t.content.model.getZod())}}export{n as PresentationRegistry,r as jsonSchemaForPresentation};
+//# sourceMappingURL=presentations.js.map

package/dist/presentations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentations.js","names":["candidate: PresentationSpec | undefined","z"],"sources":["../src/presentations.ts"],"sourcesContent":["import type { AnySchemaModel } from '@lssm/lib.schema';\nimport type { Stability } from './ownership';\nimport z from 'zod';\n\n/** V1 presentation kinds (back-compat). Prefer V2 descriptors for new work. */\nexport type PresentationKind = 'web_component' | 'markdown' | 'data';\n\n/** Minimal metadata for presentations (V1). */\nexport interface PresentationMeta {\n  name: string;\n  version: number;\n  stability?: Stability;\n  owners?: string[];\n  tags?: string[];\n  description?: string;\n}\n\n/** Policy for presentations (flags, pii). */\nexport interface PresentationPolicy {\n  flags?: string[];\n  pii?: string[];\n}\n\n/** Web component presentation (V1). */\nexport interface WebComponentPresentation {\n  kind: 'web_component';\n  framework: 'react'; // future: 'vue' | 'angular'\n  /** Symbolic key resolved by host via component map */\n  componentKey: string;\n  /** Props schema (validated at runtime) */\n  props: AnySchemaModel;\n  analytics?: string[];\n}\n\n/** Markdown presentation (V1). */\nexport interface MarkdownPresentation {\n  kind: 'markdown';\n  /** Inline markdown/MDX content */\n  content?: string;\n  /** Or a resolvable resource URI handled by ResourceRegistry */\n  resourceUri?: string;\n}\n\n/** Data presentation (V1): structured export description. */\nexport interface DataPresentation {\n  kind: 'data';\n  mimeType: string; // e.g., application/json, application/xml\n  /** Structured data schema */\n  model: AnySchemaModel;\n}\n\nexport type PresentationContent =\n  | WebComponentPresentation\n  | MarkdownPresentation\n  | DataPresentation;\n\nexport interface PresentationSpec {\n  meta: PresentationMeta;\n  policy?: PresentationPolicy;\n  content: PresentationContent;\n}\n\nfunction keyOf(p: PresentationSpec) {\n  return `${p.meta.name}.v${p.meta.version}`;\n}\n\n/** In-memory registry for V1 PresentationSpec. */\nexport class PresentationRegistry {\n  private items = new Map<string, PresentationSpec>();\n\n  register(p: PresentationSpec): this {\n    const key = keyOf(p);\n    if (this.items.has(key)) throw new Error(`Duplicate presentation ${key}`);\n    this.items.set(key, p);\n    return this;\n  }\n\n  list(): PresentationSpec[] {\n    return [...this.items.values()];\n  }\n\n  get(name: string, version?: number): PresentationSpec | undefined {\n    if (version != null) return this.items.get(`${name}.v${version}`);\n    let candidate: PresentationSpec | undefined;\n    let max = -Infinity;\n    for (const [k, p] of this.items.entries()) {\n      if (!k.startsWith(`${name}.v`)) continue;\n      if (p.meta.version > max) {\n        max = p.meta.version;\n        candidate = p;\n      }\n    }\n    return candidate;\n  }\n}\n\nexport function jsonSchemaForPresentation(p: PresentationSpec) {\n  const base = {\n    meta: {\n      name: p.meta.name,\n      version: p.meta.version,\n      stability: p.meta.stability ?? 'stable',\n      tags: p.meta.tags ?? [],\n      description: p.meta.description ?? '',\n    },\n    kind: (p.content as any).kind as PresentationKind,\n  } as const;\n\n  if (p.content.kind === 'web_component') {\n    return {\n      ...base,\n      framework: p.content.framework,\n      componentKey: p.content.componentKey,\n      props: z.toJSONSchema(p.content.props.getZod()),\n    };\n  }\n  if (p.content.kind === 'markdown') {\n    return {\n      ...base,\n      content: p.content.content,\n      resourceUri: p.content.resourceUri,\n    };\n  }\n  return {\n    ...base,\n    mimeType: p.content.mimeType,\n    model: z.toJSONSchema(p.content.model.getZod()),\n  };\n}\n"],"mappings":"mBA8DA,SAAS,EAAM,EAAqB,CAClC,MAAO,GAAG,EAAE,KAAK,KAAK,IAAI,EAAE,KAAK,UAInC,IAAa,EAAb,KAAkC,CAChC,MAAgB,IAAI,IAEpB,SAAS,EAA2B,CAClC,IAAM,EAAM,EAAM,EAAE,CACpB,GAAI,KAAK,MAAM,IAAI,EAAI,CAAE,MAAU,MAAM,0BAA0B,IAAM,CAEzE,OADA,KAAK,MAAM,IAAI,EAAK,EAAE,CACf,KAGT,MAA2B,CACzB,MAAO,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC,CAGjC,IAAI,EAAc,EAAgD,CAChE,GAAI,GAAW,KAAM,OAAO,KAAK,MAAM,IAAI,GAAG,EAAK,IAAI,IAAU,CACjE,IAAIA,EACA,EAAM,KACV,IAAK,GAAM,CAAC,EAAG,KAAM,KAAK,MAAM,SAAS,CAClC,EAAE,WAAW,GAAG,EAAK,IAAI,EAC1B,EAAE,KAAK,QAAU,IACnB,EAAM,EAAE,KAAK,QACb,EAAY,GAGhB,OAAO,IAIX,SAAgB,EAA0B,EAAqB,CAC7D,IAAM,EAAO,CACX,KAAM,CACJ,KAAM,EAAE,KAAK,KACb,QAAS,EAAE,KAAK,QAChB,UAAW,EAAE,KAAK,WAAa,SAC/B,KAAM,EAAE,KAAK,MAAQ,EAAE,CACvB,YAAa,EAAE,KAAK,aAAe,GACpC,CACD,KAAO,EAAE,QAAgB,KAC1B,CAiBD,OAfI,EAAE,QAAQ,OAAS,gBACd,CACL,GAAG,EACH,UAAW,EAAE,QAAQ,UACrB,aAAc,EAAE,QAAQ,aACxB,MAAOC,EAAE,aAAa,EAAE,QAAQ,MAAM,QAAQ,CAAC,CAChD,CAEC,EAAE,QAAQ,OAAS,WACd,CACL,GAAG,EACH,QAAS,EAAE,QAAQ,QACnB,YAAa,EAAE,QAAQ,YACxB,CAEI,CACL,GAAG,EACH,SAAU,EAAE,QAAQ,SACpB,MAAOA,EAAE,aAAa,EAAE,QAAQ,MAAM,QAAQ,CAAC,CAChD"}

package/dist/presentations.v2.d.ts

@@ -0,0 +1,96 @@
+import { OwnerShipMeta } from "./ownership.js";
+import { AnySchemaModel } from "@lssm/lib.schema";
+import { BlockConfig } from "@blocknote/core";
+
+//#region src/presentations.v2.d.ts
+/** Supported render targets for the transform engine and descriptors. */
+type PresentationTarget = 'react' | 'markdown' | 'application/json' | 'application/xml';
+interface PresentationV2Meta extends Partial<OwnerShipMeta> {
+  /** Fully-qualified presentation name (e.g., "sigil.auth.webauth_tabs_v2"). */
+  name: string;
+  /** Version of this descriptor. Increment on breaking changes. */
+  version: number;
+  /** Human-readable description for docs/a11y. Required by validators. */
+  description?: string;
+}
+/** React component presentation source. */
+interface PresentationSourceComponentReact {
+  /** Source marker for React component presentations. */
+  type: 'component';
+  /** Framework for the component source (currently only 'react'). */
+  framework: 'react';
+  /** Component key resolved by host `componentMap`. */
+  componentKey: string;
+  /** Optional props schema to validate against. */
+  props?: AnySchemaModel;
+}
+/** BlockNoteJS document presentation source. */
+interface PresentationSourceBlocknotejs {
+  /** Source marker for BlockNoteJS document presentations. */
+  type: 'blocknotejs';
+  /** BlockNoteJS JSON document. */
+  docJson: unknown;
+  /** Optional BlockNote config to guide rendering. */
+  blockConfig?: BlockConfig;
+}
+type PresentationSource = PresentationSourceComponentReact | PresentationSourceBlocknotejs;
+/**
+ * Normalized presentation descriptor decoupled from framework/adapters.
+ * Renderers and validators are provided via TransformEngine.
+ */
+interface PresentationDescriptorV2 {
+  meta: PresentationV2Meta;
+  policy?: {
+    flags?: string[];
+    pii?: string[];
+  };
+  source: PresentationSource;
+  targets: PresentationTarget[];
+}
+interface RenderContext {
+  /** Optional locale hint (i18n). */
+  locale?: string;
+  /** Enabled feature flags to drive conditional rendering. */
+  featureFlags?: string[];
+  /** Redaction hook for custom PII handling. */
+  redact?: (path: string, value: unknown) => unknown;
+}
+interface PresentationRenderer<TOut> {
+  target: PresentationTarget;
+  render: (desc: PresentationDescriptorV2, ctx?: RenderContext) => Promise<TOut>;
+}
+interface PresentationValidator {
+  validate: (desc: PresentationDescriptorV2, target: PresentationTarget, ctx?: RenderContext) => Promise<void> | void;
+}
+/**
+ * Pluggable transform engine that renders descriptors to various targets
+ * and runs validators (e.g., basic metadata checks, PII redaction policies).
+ */
+declare class TransformEngine {
+  private renderers;
+  private validators;
+  register<TOut>(renderer: PresentationRenderer<TOut>): this;
+  addValidator(v: PresentationValidator): this;
+  render<TOut = unknown>(target: PresentationTarget, desc: PresentationDescriptorV2, ctx?: RenderContext): Promise<TOut>;
+}
+/** Create a TransformEngine instance with default markdown/json/xml renderers. */
+declare function createDefaultTransformEngine(): TransformEngine;
+/** Serializable render descriptor for React hosts. */
+type ReactRenderDescriptor = {
+  kind: 'react_component';
+  componentKey: string;
+  props?: Record<string, unknown>;
+} | {
+  kind: 'blocknotejs';
+  docJson: unknown;
+  blockConfig?: BlockConfig;
+};
+/** Register a default React target renderer that returns a serializable descriptor. */
+declare function registerDefaultReactRenderer(engine: TransformEngine): TransformEngine;
+/**
+ * Add basic validators (e.g., meta.description presence) to the engine.
+ */
+declare function registerBasicValidation(engine: TransformEngine): TransformEngine;
+//#endregion
+export { PresentationDescriptorV2, PresentationRenderer, PresentationSource, PresentationSourceBlocknotejs, PresentationSourceComponentReact, PresentationTarget, PresentationV2Meta, PresentationValidator, ReactRenderDescriptor, RenderContext, TransformEngine, createDefaultTransformEngine, registerBasicValidation, registerDefaultReactRenderer };
+//# sourceMappingURL=presentations.v2.d.ts.map

package/dist/presentations.v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentations.v2.d.ts","names":[],"sources":["../src/presentations.v2.ts"],"sourcesContent":[],"mappings":";;;;;;KAKY,kBAAA;AAAA,UAMK,kBAAA,SAA2B,OANd,CAMsB,aANtB,CAAA,CAAA;EAMb;EAUA,IAAA,EAAA,MAAA;EAYA;EASL,OAAA,EAAA,MAAA;EAQK;EACT,WAAA,CAAA,EAAA,MAAA;;;AAGqB,UAjCZ,gCAAA,CAiCY;EAGZ;EASA,IAAA,EAAA,WAAA;EACP;EAEA,SAAA,EAAA,OAAA;EACA;EACK,YAAA,EAAA,MAAA;EAAR;EAAO,KAAA,CAAA,EA1CJ,cA0CI;AAGd;;AAGY,UA5CK,6BAAA,CA4CL;EACF;EACH,IAAA,EAAA,aAAA;EAAO;EAOD,OAAA,EAAA,OAAA;EAOmC;EAArB,WAAA,CAAA,EAtDX,WAsDW;;AAaf,KAhEA,kBAAA,GACR,gCA+DQ,GA9DR,6BA8DQ;;;;;AAGA,UA3DK,wBAAA,CA2DL;EAsBI,IAAA,EAhFR,kBAgFQ;EA4FJ,MAAA,CAAA,EAAA;IASI,KAAA,CAAA,EAAA,MAAA,EAAA;IA8BA,GAAA,CAAA,EAAA,MAAA,EAAA;;UAjNN;WACC;;UAGM,aAAA;;;;;;;;UASA;UACP;iBAEA,gCACA,kBACH,QAAQ;;UAGE,qBAAA;mBAEP,kCACE,0BACF,kBACH;;;;;;cAOM,eAAA;;;2BAOc,qBAAqB;kBAO9B;iCAMN,0BACF,gCACA,gBACL,QAAQ;;;iBAsBG,4BAAA,CAAA,GAA4B;;KA4FhC,qBAAA;;;UAIE;;;;gBAE6C;;;iBAG3C,4BAAA,SAAqC,kBAAe;;;;iBA8BpD,uBAAA,SAAgC,kBAAe"}

package/dist/presentations.v2.js

@@ -0,0 +1,2 @@
+var e=class{renderers=new Map;validators=[];register(e){let t=this.renderers.get(e.target)??[];return t.push(e),this.renderers.set(e.target,t),this}addValidator(e){return this.validators.push(e),this}async render(e,t,n){if(!t.targets.includes(e))throw Error(`Target ${e} not declared for ${t.meta.name}.v${t.meta.version}`);for(let r of this.validators)await r.validate(t,e,n);let r=this.renderers.get(e)??[];for(let e of r)try{return await e.render(t,n)}catch{}throw Error(`No renderer available for ${e}`)}};function t(){let t=new e,n=(e,t)=>{let n=JSON.parse(JSON.stringify(t)),r=e.policy?.pii??[],i=(e,t)=>{let n=t.replace(/^\//,``).replace(/\[(\d+)\]/g,`.$1`).split(`.`).filter(Boolean),r=e;for(let e=0;e<n.length-1;e++){let t=n[e];if(r&&typeof r==`object`&&t in r)r=r[t];else return}let i=n[n.length-1];r&&typeof r==`object`&&i&&i in r&&(r[i]=`[REDACTED]`)};for(let e of r)i(n,e);return n};return t.register({target:`markdown`,async render(e){if(e.source.type===`blocknotejs`){let t=n(e,{text:typeof e.source.docJson==`string`?e.source.docJson:JSON.stringify(e.source.docJson)});return{mimeType:`text/markdown`,body:String(t.text)}}if(e.source.type===`component`)return{mimeType:`text/markdown`,body:`${`# ${e.meta.name} v${e.meta.version}`}${e.meta.description?`\n\n${e.meta.description}`:``}${e.meta.tags&&e.meta.tags.length?`\n\nTags: ${e.meta.tags.join(`, `)}`:``}${e.meta.owners&&e.meta.owners.length?`\n\nOwners: ${e.meta.owners.join(`, `)}`:``}${`\n\nComponent: \`${e.source.componentKey}\``}${e.policy?.pii?.length?`\n\nRedacted paths: ${e.policy.pii.map(e=>`\`${e}\``).join(`, `)}`:``}`};throw Error(`unsupported`)}}),t.register({target:`application/json`,async render(e){let t=n(e,{meta:e.meta,source:e.source});return{mimeType:`application/json`,body:JSON.stringify(t,null,2)}}}),t.register({target:`application/xml`,async render(e){let t=n(e,{meta:e.meta,source:e.source});return{mimeType:`application/xml`,body:`<presentation name="${e.meta.name}" version="${e.meta.version}"><json>${encodeURIComponent(JSON.stringify(t))}</json></presentation>`}}}),t}function n(e){return e.register({target:`react`,async render(e){if(e.source.type===`component`){let t=e.source.props&&e.source.props.getZod().safeParse({}).success?{}:void 0;return{kind:`react_component`,componentKey:e.source.componentKey,props:t}}return{kind:`blocknotejs`,docJson:e.source.docJson,blockConfig:e.source.blockConfig}}}),e}function r(e){return e.addValidator({validate(e){if(!e.meta.description||e.meta.description.length<3)throw Error(`Presentation ${e.meta.name}.v${e.meta.version} missing meta.description`)}}),e}export{e as TransformEngine,t as createDefaultTransformEngine,r as registerBasicValidation,n as registerDefaultReactRenderer};
+//# sourceMappingURL=presentations.v2.js.map

package/dist/presentations.v2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentations.v2.js","names":[],"sources":["../src/presentations.v2.ts"],"sourcesContent":["import type { AnySchemaModel } from '@lssm/lib.schema';\nimport type { OwnerShipMeta } from './ownership';\nimport type { BlockConfig } from '@blocknote/core';\n\n/** Supported render targets for the transform engine and descriptors. */\nexport type PresentationTarget =\n  | 'react'\n  | 'markdown'\n  | 'application/json'\n  | 'application/xml';\n\nexport interface PresentationV2Meta extends Partial<OwnerShipMeta> {\n  /** Fully-qualified presentation name (e.g., \"sigil.auth.webauth_tabs_v2\"). */\n  name: string;\n  /** Version of this descriptor. Increment on breaking changes. */\n  version: number;\n  /** Human-readable description for docs/a11y. Required by validators. */\n  description?: string;\n}\n\n/** React component presentation source. */\nexport interface PresentationSourceComponentReact {\n  /** Source marker for React component presentations. */\n  type: 'component';\n  /** Framework for the component source (currently only 'react'). */\n  framework: 'react';\n  /** Component key resolved by host `componentMap`. */\n  componentKey: string;\n  /** Optional props schema to validate against. */\n  props?: AnySchemaModel;\n}\n\n/** BlockNoteJS document presentation source. */\nexport interface PresentationSourceBlocknotejs {\n  /** Source marker for BlockNoteJS document presentations. */\n  type: 'blocknotejs';\n  /** BlockNoteJS JSON document. */\n  docJson: unknown;\n  /** Optional BlockNote config to guide rendering. */\n  blockConfig?: BlockConfig;\n}\n\nexport type PresentationSource =\n  | PresentationSourceComponentReact\n  | PresentationSourceBlocknotejs;\n\n/**\n * Normalized presentation descriptor decoupled from framework/adapters.\n * Renderers and validators are provided via TransformEngine.\n */\nexport interface PresentationDescriptorV2 {\n  meta: PresentationV2Meta;\n  policy?: { flags?: string[]; pii?: string[] };\n  source: PresentationSource;\n  targets: PresentationTarget[]; // which outputs are supported by transforms\n}\n\nexport interface RenderContext {\n  /** Optional locale hint (i18n). */\n  locale?: string;\n  /** Enabled feature flags to drive conditional rendering. */\n  featureFlags?: string[];\n  /** Redaction hook for custom PII handling. */\n  redact?: (path: string, value: unknown) => unknown;\n}\n\nexport interface PresentationRenderer<TOut> {\n  target: PresentationTarget;\n  render: (\n    desc: PresentationDescriptorV2,\n    ctx?: RenderContext\n  ) => Promise<TOut>;\n}\n\nexport interface PresentationValidator {\n  validate: (\n    desc: PresentationDescriptorV2,\n    target: PresentationTarget,\n    ctx?: RenderContext\n  ) => Promise<void> | void;\n}\n\n/**\n * Pluggable transform engine that renders descriptors to various targets\n * and runs validators (e.g., basic metadata checks, PII redaction policies).\n */\nexport class TransformEngine {\n  private renderers = new Map<\n    PresentationTarget,\n    PresentationRenderer<any>[]\n  >();\n  private validators: PresentationValidator[] = [];\n\n  register<TOut>(renderer: PresentationRenderer<TOut>): this {\n    const arr = this.renderers.get(renderer.target) ?? [];\n    arr.push(renderer);\n    this.renderers.set(renderer.target, arr);\n    return this;\n  }\n\n  addValidator(v: PresentationValidator): this {\n    this.validators.push(v);\n    return this;\n  }\n\n  async render<TOut = unknown>(\n    target: PresentationTarget,\n    desc: PresentationDescriptorV2,\n    ctx?: RenderContext\n  ): Promise<TOut> {\n    if (!desc.targets.includes(target))\n      throw new Error(\n        `Target ${target} not declared for ${desc.meta.name}.v${desc.meta.version}`\n      );\n    for (const v of this.validators) await v.validate(desc, target, ctx);\n    const arr = this.renderers.get(target) ?? [];\n    for (const r of arr) {\n      try {\n        const out = await r.render(desc, ctx);\n        // first successful renderer wins\n        return out as TOut;\n      } catch (_e) {\n        // try next\n      }\n    }\n    throw new Error(`No renderer available for ${target}`);\n  }\n}\n\n// Minimal built-ins (stubs). Host apps can register concrete adapters.\n/** Create a TransformEngine instance with default markdown/json/xml renderers. */\nexport function createDefaultTransformEngine() {\n  const engine = new TransformEngine();\n\n  const applyPii = (desc: PresentationDescriptorV2, obj: any) => {\n    const clone = JSON.parse(JSON.stringify(obj));\n    const paths = desc.policy?.pii ?? [];\n    const setAtPath = (root: any, path: string) => {\n      const segs = path\n        .replace(/^\\//, '')\n        .replace(/\\[(\\d+)\\]/g, '.$1')\n        .split('.')\n        .filter(Boolean);\n      let cur = root;\n      for (let i = 0; i < segs.length - 1; i++) {\n        const k = segs[i]!;\n        if (cur && typeof cur === 'object' && k in cur) cur = cur[k];\n        else return;\n      }\n      const last = segs[segs.length - 1];\n      if (cur && typeof cur === 'object' && last && last in cur)\n        cur[last] = '[REDACTED]';\n    };\n    for (const p of paths) setAtPath(clone, p);\n    return clone;\n  };\n\n  // markdown output for both blocknote and component\n  engine.register<{ mimeType: 'text/markdown'; body: string }>({\n    target: 'markdown',\n    async render(desc) {\n      if (desc.source.type === 'blocknotejs') {\n        // TODO: convert BlockNote doc JSON → markdown (placeholder for now)\n        const raw =\n          typeof desc.source.docJson === 'string'\n            ? desc.source.docJson\n            : JSON.stringify(desc.source.docJson);\n        const redacted = applyPii(desc, { text: raw });\n        return { mimeType: 'text/markdown', body: String(redacted.text) };\n      }\n      if (desc.source.type === 'component') {\n        const header = `# ${desc.meta.name} v${desc.meta.version}`;\n        const about = desc.meta.description\n          ? `\\n\\n${desc.meta.description}`\n          : '';\n        const tags =\n          desc.meta.tags && desc.meta.tags.length\n            ? `\\n\\nTags: ${desc.meta.tags.join(', ')}`\n            : '';\n        const owners =\n          desc.meta.owners && desc.meta.owners.length\n            ? `\\n\\nOwners: ${desc.meta.owners.join(', ')}`\n            : '';\n        const comp = `\\n\\nComponent: \\`${desc.source.componentKey}\\``;\n        const policy = desc.policy?.pii?.length\n          ? `\\n\\nRedacted paths: ${desc.policy.pii.map((p) => `\\`${p}\\``).join(', ')}`\n          : '';\n        const body = `${header}${about}${tags}${owners}${comp}${policy}`;\n        return { mimeType: 'text/markdown', body };\n      }\n      throw new Error('unsupported');\n    },\n  });\n\n  // json snapshot of source\n  engine.register<{ mimeType: 'application/json'; body: string }>({\n    target: 'application/json',\n    async render(desc) {\n      const payload = applyPii(desc, { meta: desc.meta, source: desc.source });\n      return {\n        mimeType: 'application/json',\n        body: JSON.stringify(payload, null, 2),\n      };\n    },\n  });\n\n  // xml (simple wrapper around json for now)\n  engine.register<{ mimeType: 'application/xml'; body: string }>({\n    target: 'application/xml',\n    async render(desc) {\n      const json = applyPii(desc, { meta: desc.meta, source: desc.source });\n      const body = `<presentation name=\"${desc.meta.name}\" version=\"${desc.meta.version}\"><json>${encodeURIComponent(\n        JSON.stringify(json)\n      )}</json></presentation>`;\n      return { mimeType: 'application/xml', body };\n    },\n  });\n\n  return engine;\n}\n\n// React target returns a serializable descriptor the host can render.\n/** Serializable render descriptor for React hosts. */\nexport type ReactRenderDescriptor =\n  | {\n      kind: 'react_component';\n      componentKey: string;\n      props?: Record<string, unknown>;\n    }\n  | { kind: 'blocknotejs'; docJson: unknown; blockConfig?: BlockConfig };\n\n/** Register a default React target renderer that returns a serializable descriptor. */\nexport function registerDefaultReactRenderer(engine: TransformEngine) {\n  engine.register<ReactRenderDescriptor>({\n    target: 'react',\n    async render(desc) {\n      if (desc.source.type === 'component') {\n        const props = desc.source.props\n          ? desc.source.props.getZod().safeParse({}).success\n            ? {}\n            : undefined\n          : undefined;\n        return {\n          kind: 'react_component',\n          componentKey: desc.source.componentKey,\n          props,\n        } as ReactRenderDescriptor;\n      }\n      // blocknote\n      return {\n        kind: 'blocknotejs',\n        docJson: desc.source.docJson,\n        blockConfig: desc.source.blockConfig,\n      } as ReactRenderDescriptor;\n    },\n  });\n  return engine;\n}\n\n/**\n * Add basic validators (e.g., meta.description presence) to the engine.\n */\nexport function registerBasicValidation(engine: TransformEngine) {\n  // Ensure description is provided for a11y/i18n/docs\n  engine.addValidator({\n    validate(desc) {\n      if (!desc.meta.description || desc.meta.description.length < 3)\n        throw new Error(\n          `Presentation ${desc.meta.name}.v${desc.meta.version} missing meta.description`\n        );\n    },\n  });\n  return engine;\n}\n"],"mappings":"AAsFA,IAAa,EAAb,KAA6B,CAC3B,UAAoB,IAAI,IAIxB,WAA8C,EAAE,CAEhD,SAAe,EAA4C,CACzD,IAAM,EAAM,KAAK,UAAU,IAAI,EAAS,OAAO,EAAI,EAAE,CAGrD,OAFA,EAAI,KAAK,EAAS,CAClB,KAAK,UAAU,IAAI,EAAS,OAAQ,EAAI,CACjC,KAGT,aAAa,EAAgC,CAE3C,OADA,KAAK,WAAW,KAAK,EAAE,CAChB,KAGT,MAAM,OACJ,EACA,EACA,EACe,CACf,GAAI,CAAC,EAAK,QAAQ,SAAS,EAAO,CAChC,MAAU,MACR,UAAU,EAAO,oBAAoB,EAAK,KAAK,KAAK,IAAI,EAAK,KAAK,UACnE,CACH,IAAK,IAAM,KAAK,KAAK,WAAY,MAAM,EAAE,SAAS,EAAM,EAAQ,EAAI,CACpE,IAAM,EAAM,KAAK,UAAU,IAAI,EAAO,EAAI,EAAE,CAC5C,IAAK,IAAM,KAAK,EACd,GAAI,CAGF,OAFY,MAAM,EAAE,OAAO,EAAM,EAAI,MAG1B,EAIf,MAAU,MAAM,6BAA6B,IAAS,GAM1D,SAAgB,GAA+B,CAC7C,IAAM,EAAS,IAAI,EAEb,GAAY,EAAgC,IAAa,CAC7D,IAAM,EAAQ,KAAK,MAAM,KAAK,UAAU,EAAI,CAAC,CACvC,EAAQ,EAAK,QAAQ,KAAO,EAAE,CAC9B,GAAa,EAAW,IAAiB,CAC7C,IAAM,EAAO,EACV,QAAQ,MAAO,GAAG,CAClB,QAAQ,aAAc,MAAM,CAC5B,MAAM,IAAI,CACV,OAAO,QAAQ,CACd,EAAM,EACV,IAAK,IAAI,EAAI,EAAG,EAAI,EAAK,OAAS,EAAG,IAAK,CACxC,IAAM,EAAI,EAAK,GACf,GAAI,GAAO,OAAO,GAAQ,UAAY,KAAK,EAAK,EAAM,EAAI,QACrD,OAEP,IAAM,EAAO,EAAK,EAAK,OAAS,GAC5B,GAAO,OAAO,GAAQ,UAAY,GAAQ,KAAQ,IACpD,EAAI,GAAQ,eAEhB,IAAK,IAAM,KAAK,EAAO,EAAU,EAAO,EAAE,CAC1C,OAAO,GAgET,OA5DA,EAAO,SAAsD,CAC3D,OAAQ,WACR,MAAM,OAAO,EAAM,CACjB,GAAI,EAAK,OAAO,OAAS,cAAe,CAMtC,IAAM,EAAW,EAAS,EAAM,CAAE,KAHhC,OAAO,EAAK,OAAO,SAAY,SAC3B,EAAK,OAAO,QACZ,KAAK,UAAU,EAAK,OAAO,QAAQ,CACI,CAAC,CAC9C,MAAO,CAAE,SAAU,gBAAiB,KAAM,OAAO,EAAS,KAAK,CAAE,CAEnE,GAAI,EAAK,OAAO,OAAS,YAkBvB,MAAO,CAAE,SAAU,gBAAiB,KADvB,GAhBE,KAAK,EAAK,KAAK,KAAK,IAAI,EAAK,KAAK,YACnC,EAAK,KAAK,YACpB,OAAO,EAAK,KAAK,cACjB,KAEF,EAAK,KAAK,MAAQ,EAAK,KAAK,KAAK,OAC7B,aAAa,EAAK,KAAK,KAAK,KAAK,KAAK,GACtC,KAEJ,EAAK,KAAK,QAAU,EAAK,KAAK,OAAO,OACjC,eAAe,EAAK,KAAK,OAAO,KAAK,KAAK,GAC1C,KACO,oBAAoB,EAAK,OAAO,aAAa,MAC3C,EAAK,QAAQ,KAAK,OAC7B,uBAAuB,EAAK,OAAO,IAAI,IAAK,GAAM,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,GACxE,KAEsC,CAE5C,MAAU,MAAM,cAAc,EAEjC,CAAC,CAGF,EAAO,SAAyD,CAC9D,OAAQ,mBACR,MAAM,OAAO,EAAM,CACjB,IAAM,EAAU,EAAS,EAAM,CAAE,KAAM,EAAK,KAAM,OAAQ,EAAK,OAAQ,CAAC,CACxE,MAAO,CACL,SAAU,mBACV,KAAM,KAAK,UAAU,EAAS,KAAM,EAAE,CACvC,EAEJ,CAAC,CAGF,EAAO,SAAwD,CAC7D,OAAQ,kBACR,MAAM,OAAO,EAAM,CACjB,IAAM,EAAO,EAAS,EAAM,CAAE,KAAM,EAAK,KAAM,OAAQ,EAAK,OAAQ,CAAC,CAIrE,MAAO,CAAE,SAAU,kBAAmB,KAHzB,uBAAuB,EAAK,KAAK,KAAK,aAAa,EAAK,KAAK,QAAQ,UAAU,mBAC1F,KAAK,UAAU,EAAK,CACrB,CAAC,wBAC0C,EAE/C,CAAC,CAEK,EAcT,SAAgB,EAA6B,EAAyB,CAwBpE,OAvBA,EAAO,SAAgC,CACrC,OAAQ,QACR,MAAM,OAAO,EAAM,CACjB,GAAI,EAAK,OAAO,OAAS,YAAa,CACpC,IAAM,EAAQ,EAAK,OAAO,OACtB,EAAK,OAAO,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,QACvC,EAAE,CACF,IAAA,GAEN,MAAO,CACL,KAAM,kBACN,aAAc,EAAK,OAAO,aAC1B,QACD,CAGH,MAAO,CACL,KAAM,cACN,QAAS,EAAK,OAAO,QACrB,YAAa,EAAK,OAAO,YAC1B,EAEJ,CAAC,CACK,EAMT,SAAgB,EAAwB,EAAyB,CAU/D,OARA,EAAO,aAAa,CAClB,SAAS,EAAM,CACb,GAAI,CAAC,EAAK,KAAK,aAAe,EAAK,KAAK,YAAY,OAAS,EAC3D,MAAU,MACR,gBAAgB,EAAK,KAAK,KAAK,IAAI,EAAK,KAAK,QAAQ,2BACtD,EAEN,CAAC,CACK"}

package/dist/prompt.d.ts

@@ -0,0 +1,61 @@
+import { z } from "zod";
+
+//#region src/prompt.d.ts
+type PromptStability = 'experimental' | 'beta' | 'stable' | 'deprecated';
+/** Parameter definition for a prompt argument. */
+interface PromptArg {
+  name: string;
+  description?: string;
+  required?: boolean;
+  schema: z.ZodType;
+  completeWith?: string;
+}
+/**
+ * Rendered content part for a prompt. Clients (MCP) can fetch referenced resources.
+ */
+type PromptContentPart = {
+  type: 'text';
+  text: string;
+} | {
+  type: 'resource';
+  uri: string;
+  title?: string;
+};
+/** Prompt metadata for discoverability and governance. */
+interface PromptMeta {
+  name: string;
+  version: number;
+  title: string;
+  description: string;
+  tags?: string[];
+  stability?: PromptStability;
+  owners?: string[];
+}
+/** Policy constraints for prompts (flags, PII paths, rate limits). */
+interface PromptPolicy {
+  flags?: string[];
+  pii?: string[];
+  rateLimit?: {
+    rpm: number;
+    key: 'user' | 'org' | 'global';
+  };
+}
+/** Full prompt specification including args schema and render function. */
+interface PromptSpec<I extends z.ZodType> {
+  meta: PromptMeta;
+  args: PromptArg[];
+  input: I;
+  policy?: PromptPolicy;
+  /** Render MCP-friendly content parts. DO NOT perform side effects here. */
+  render: (args: z.infer<I>, ctx: {
+    userId?: string | null;
+    orgId?: string | null;
+    locale?: string;
+    link: (template: string, vars: Record<string, string | number>) => string;
+  }) => Promise<PromptContentPart[]>;
+}
+/** Identity helper that preserves generic inference when declaring prompts. */
+declare function definePrompt<I extends z.ZodType>(spec: PromptSpec<I>): PromptSpec<I>;
+//#endregion
+export { PromptArg, PromptContentPart, PromptMeta, PromptPolicy, PromptSpec, PromptStability, definePrompt };
+//# sourceMappingURL=prompt.d.ts.map

package/dist/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","names":[],"sources":["../src/prompt.ts"],"sourcesContent":[],"mappings":";;;KAEY,eAAA;;AAAA,UAGK,SAAA,CAHU;EAGV,IAAA,EAAA,MAAS;EAWd,WAAA,CAAA,EAAA,MAAiB;EAKZ,QAAA,CAAA,EAAA,OAAU;EAWV,MAAA,EAvBP,CAAA,CAAE,OAuBiB;EAOZ,YAAA,CAAU,EAAA,MAAA;;;;;AAIhB,KA3BC,iBAAA,GA2BD;EAIO,IAAA,EAAA,MAAA;EAAN,IAAA,EAAA,MAAA;CAKyB,GAAA;EAEtB,IAAA,EAAA,UAAA;EAAR,GAAA,EAAA,MAAA;EAAO,KAAA,CAAA,EAAA,MAAA;AAId,CAAA;;AACmB,UAtCF,UAAA,CAsCE;EAAX,IAAA,EAAA,MAAA;EACM,OAAA,EAAA,MAAA;EAAX,KAAA,EAAA,MAAA;EAAU,WAAA,EAAA,MAAA;;cAjCC;;;;UAKG,YAAA;;;;;;;;;UAOA,qBAAqB,CAAA,CAAE;QAChC;QACA;SACC;WACE;;iBAID,CAAA,CAAE,MAAM;;;;mCAKmB;QAE9B,QAAQ;;;iBAIC,uBAAuB,CAAA,CAAE,eACjC,WAAW,KAChB,WAAW"}

package/dist/prompt.js

@@ -0,0 +1,2 @@
+import{z as e}from"zod";function t(e){return e}export{t as definePrompt};
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","names":[],"sources":["../src/prompt.ts"],"sourcesContent":["import { z } from 'zod';\n\nexport type PromptStability = 'experimental' | 'beta' | 'stable' | 'deprecated';\n\n/** Parameter definition for a prompt argument. */\nexport interface PromptArg {\n  name: string;\n  description?: string;\n  required?: boolean;\n  schema: z.ZodType; // zod schema for this argument\n  completeWith?: string; // optional completion source name\n}\n\n/**\n * Rendered content part for a prompt. Clients (MCP) can fetch referenced resources.\n */\nexport type PromptContentPart =\n  | { type: 'text'; text: string }\n  | { type: 'resource'; uri: string; title?: string };\n\n/** Prompt metadata for discoverability and governance. */\nexport interface PromptMeta {\n  name: string; // e.g. \"sigil.signup-help\"\n  version: number; // bump on breaking change\n  title: string;\n  description: string;\n  tags?: string[];\n  stability?: PromptStability;\n  owners?: string[];\n}\n\n/** Policy constraints for prompts (flags, PII paths, rate limits). */\nexport interface PromptPolicy {\n  flags?: string[];\n  pii?: string[]; // JSON-like paths within args to redact in logs/prompts\n  rateLimit?: { rpm: number; key: 'user' | 'org' | 'global' };\n}\n\n/** Full prompt specification including args schema and render function. */\nexport interface PromptSpec<I extends z.ZodType> {\n  meta: PromptMeta;\n  args: PromptArg[];\n  input: I; // full args object schema (zod)\n  policy?: PromptPolicy;\n\n  /** Render MCP-friendly content parts. DO NOT perform side effects here. */\n  render: (\n    args: z.infer<I>,\n    ctx: {\n      userId?: string | null;\n      orgId?: string | null;\n      locale?: string;\n      link: (template: string, vars: Record<string, string | number>) => string;\n    }\n  ) => Promise<PromptContentPart[]>;\n}\n\n/** Identity helper that preserves generic inference when declaring prompts. */\nexport function definePrompt<I extends z.ZodType>(\n  spec: PromptSpec<I>\n): PromptSpec<I> {\n  return spec;\n}\n"],"mappings":"wBA0DA,SAAgB,EACd,EACe,CACf,OAAO"}

package/dist/promptRegistry.d.ts

@@ -0,0 +1,16 @@
+import { PromptSpec } from "./prompt.js";
+import { z } from "zod";
+
+//#region src/promptRegistry.d.ts
+declare class PromptRegistry {
+  private prompts;
+  /** Register a prompt. Throws on duplicate name+version. */
+  register<I extends z.ZodType>(p: PromptSpec<I>): this;
+  /** List all registered prompts. */
+  list(): PromptSpec<any>[];
+  /** Get prompt by name; when version omitted, returns highest version. */
+  get(name: string, version?: number): PromptSpec<any> | undefined;
+}
+//#endregion
+export { PromptRegistry };
+//# sourceMappingURL=promptRegistry.d.ts.map

package/dist/promptRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptRegistry.d.ts","names":[],"sources":["../src/promptRegistry.ts"],"sourcesContent":[],"mappings":";;;;cAGa,cAAA;;EAAA;EAIU,QAAA,CAAA,UAAF,CAAA,CAAE,OAAA,CAAA,CAAA,CAAA,EAAY,UAAZ,CAAuB,CAAvB,CAAA,CAAA,EAAA,IAAA;EAAuB;EAAX,IAAA,CAAA,CAAA,EAQ7B,UAR6B,CAAA,GAAA,CAAA,EAAA;EAQ7B;EAK8B,GAAA,CAAA,IAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAAA,MAAA,CAAA,EAAA,UAAA,CAAA,GAAA,CAAA,GAAA,SAAA"}

package/dist/promptRegistry.js

@@ -0,0 +1,2 @@
+import{z as e}from"zod";var t=class{prompts=new Map;register(e){let t=`${e.meta.name}.v${e.meta.version}`;if(this.prompts.has(t))throw Error(`Duplicate prompt ${t}`);return this.prompts.set(t,e),this}list(){return[...this.prompts.values()]}get(e,t){if(t!=null)return this.prompts.get(`${e}.v${t}`);let n,r=-1/0;for(let[t,i]of this.prompts.entries())t.startsWith(`${e}.v`)&&i.meta.version>r&&(r=i.meta.version,n=i);return n}};export{t as PromptRegistry};
+//# sourceMappingURL=promptRegistry.js.map

package/dist/promptRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptRegistry.js","names":["candidate: PromptSpec<any> | undefined"],"sources":["../src/promptRegistry.ts"],"sourcesContent":["import type { PromptSpec } from './prompt';\nimport { z } from 'zod';\n\nexport class PromptRegistry {\n  private prompts = new Map<string, PromptSpec<any>>(); // key = name.vX\n\n  /** Register a prompt. Throws on duplicate name+version. */\n  register<I extends z.ZodType>(p: PromptSpec<I>): this {\n    const key = `${p.meta.name}.v${p.meta.version}`;\n    if (this.prompts.has(key)) throw new Error(`Duplicate prompt ${key}`);\n    this.prompts.set(key, p);\n    return this;\n  }\n\n  /** List all registered prompts. */\n  list() {\n    return [...this.prompts.values()];\n  }\n\n  /** Get prompt by name; when version omitted, returns highest version. */\n  get(name: string, version?: number) {\n    if (version != null) return this.prompts.get(`${name}.v${version}`);\n    // latest by highest version\n    let candidate: PromptSpec<any> | undefined;\n    let max = -Infinity;\n    for (const [k, p] of this.prompts.entries()) {\n      if (!k.startsWith(`${name}.v`)) continue;\n      if (p.meta.version > max) {\n        max = p.meta.version;\n        candidate = p;\n      }\n    }\n    return candidate;\n  }\n}\n"],"mappings":"wBAGA,IAAa,EAAb,KAA4B,CAC1B,QAAkB,IAAI,IAGtB,SAA8B,EAAwB,CACpD,IAAM,EAAM,GAAG,EAAE,KAAK,KAAK,IAAI,EAAE,KAAK,UACtC,GAAI,KAAK,QAAQ,IAAI,EAAI,CAAE,MAAU,MAAM,oBAAoB,IAAM,CAErE,OADA,KAAK,QAAQ,IAAI,EAAK,EAAE,CACjB,KAIT,MAAO,CACL,MAAO,CAAC,GAAG,KAAK,QAAQ,QAAQ,CAAC,CAInC,IAAI,EAAc,EAAkB,CAClC,GAAI,GAAW,KAAM,OAAO,KAAK,QAAQ,IAAI,GAAG,EAAK,IAAI,IAAU,CAEnE,IAAIA,EACA,EAAM,KACV,IAAK,GAAM,CAAC,EAAG,KAAM,KAAK,QAAQ,SAAS,CACpC,EAAE,WAAW,GAAG,EAAK,IAAI,EAC1B,EAAE,KAAK,QAAU,IACnB,EAAM,EAAE,KAAK,QACb,EAAY,GAGhB,OAAO"}

package/dist/regenerator/adapters.d.ts

@@ -0,0 +1,20 @@
+import { BehaviorSignal, ErrorSignal, RegenerationContext, TelemetrySignal } from "./types.js";
+
+//#region src/regenerator/adapters.d.ts
+interface TelemetrySignalProvider {
+  pollTelemetry(context: RegenerationContext, since: Date, until: Date): Promise<TelemetrySignal[]>;
+}
+interface ErrorSignalProvider {
+  pollErrors(context: RegenerationContext, since: Date, until: Date): Promise<ErrorSignal[]>;
+}
+interface BehaviorSignalProvider {
+  pollBehavior(context: RegenerationContext, since: Date, until: Date): Promise<BehaviorSignal[]>;
+}
+interface SignalAdapters {
+  telemetry?: TelemetrySignalProvider;
+  errors?: ErrorSignalProvider;
+  behavior?: BehaviorSignalProvider;
+}
+//#endregion
+export { BehaviorSignalProvider, ErrorSignalProvider, SignalAdapters, TelemetrySignalProvider };
+//# sourceMappingURL=adapters.d.ts.map

package/dist/regenerator/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","names":[],"sources":["../../src/regenerator/adapters.ts"],"sourcesContent":[],"mappings":";;;UAOiB,uBAAA;yBAEJ,4BACF,aACA,OACN,QAAQ;AALb;AAEa,UAMI,mBAAA,CANJ;EACF,UAAA,CAAA,OAAA,EAOE,mBAPF,EAAA,KAAA,EAQA,IARA,EAAA,KAAA,EASA,IATA,CAAA,EAUN,OAVM,CAUE,WAVF,EAAA,CAAA;;AAEE,UAWI,sBAAA,CAXJ;EAAR,YAAA,CAAA,OAAA,EAaQ,mBAbR,EAAA,KAAA,EAcM,IAdN,EAAA,KAAA,EAeM,IAfN,CAAA,EAgBA,OAhBA,CAgBQ,cAhBR,EAAA,CAAA;;AAGY,UAgBA,cAAA,CAhBmB;EAEvB,SAAA,CAAA,EAeC,uBAfD;EACF,MAAA,CAAA,EAeA,mBAfA;EACA,QAAA,CAAA,EAeE,sBAfF"}

package/dist/regenerator/executor.d.ts

@@ -0,0 +1,71 @@
+import { ProposalAction, RegenerationContext, SpecChangeProposal } from "./types.js";
+
+//#region src/regenerator/executor.d.ts
+type ExecutionStatus = 'success' | 'skipped' | 'failed';
+interface ActionExecutionResult {
+  index: number;
+  action: ProposalAction;
+  status: ExecutionStatus;
+  startedAt: Date;
+  finishedAt: Date;
+  reason?: string;
+  error?: Error;
+  output?: unknown;
+}
+interface ProposalExecutionResult {
+  proposalId: string;
+  contextId: string;
+  startedAt: Date;
+  finishedAt: Date;
+  status: 'success' | 'partial' | 'failed';
+  actions: ActionExecutionResult[];
+}
+type UpdateBlueprintAction = Extract<ProposalAction, {
+  kind: 'update_blueprint';
+}>;
+type UpdateTenantConfigAction = Extract<ProposalAction, {
+  kind: 'update_tenant_config';
+}>;
+type RunTestsAction = Extract<ProposalAction, {
+  kind: 'run_tests';
+}>;
+type RunMigrationsAction = Extract<ProposalAction, {
+  kind: 'run_migrations';
+}>;
+type TriggerRegenerationAction = Extract<ProposalAction, {
+  kind: 'trigger_regeneration';
+}>;
+interface BlueprintUpdater {
+  applyBlueprintUpdate(context: RegenerationContext, proposal: SpecChangeProposal, action: UpdateBlueprintAction): Promise<unknown>;
+}
+interface TenantConfigUpdater {
+  applyTenantConfigUpdate(context: RegenerationContext, proposal: SpecChangeProposal, action: UpdateTenantConfigAction): Promise<unknown>;
+}
+interface TestExecutor {
+  runTests(context: RegenerationContext, proposal: SpecChangeProposal, action: RunTestsAction): Promise<unknown>;
+}
+interface MigrationExecutor {
+  runMigrations(context: RegenerationContext, proposal: SpecChangeProposal, action: RunMigrationsAction): Promise<unknown>;
+}
+interface RegenerationTrigger {
+  triggerRegeneration(context: RegenerationContext, proposal: SpecChangeProposal, action: TriggerRegenerationAction): Promise<unknown>;
+}
+interface ProposalExecutorOptions {
+  dryRun?: boolean;
+}
+interface ProposalExecutorDeps {
+  blueprintUpdater?: BlueprintUpdater;
+  tenantConfigUpdater?: TenantConfigUpdater;
+  testExecutor?: TestExecutor;
+  migrationExecutor?: MigrationExecutor;
+  regenerationTrigger?: RegenerationTrigger;
+}
+declare class ProposalExecutor {
+  private readonly deps;
+  constructor(deps?: ProposalExecutorDeps);
+  execute(context: RegenerationContext, proposal: SpecChangeProposal, options?: ProposalExecutorOptions): Promise<ProposalExecutionResult>;
+  private executeAction;
+}
+//#endregion
+export { ActionExecutionResult, BlueprintUpdater, ExecutionStatus, MigrationExecutor, ProposalExecutionResult, ProposalExecutor, ProposalExecutorDeps, ProposalExecutorOptions, RegenerationTrigger, RunMigrationsAction, RunTestsAction, TenantConfigUpdater, TestExecutor, TriggerRegenerationAction, UpdateBlueprintAction, UpdateTenantConfigAction };
+//# sourceMappingURL=executor.d.ts.map

package/dist/regenerator/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","names":[],"sources":["../../src/regenerator/executor.ts"],"sourcesContent":[],"mappings":";;;KAEY,eAAA;UAEK,qBAAA;EAFL,KAAA,EAAA,MAAA;EAEK,MAAA,EAEP,cAFO;EAEP,MAAA,EACA,eADA;EACA,SAAA,EACG,IADH;EACG,UAAA,EACC,IADD;EACC,MAAA,CAAA,EAAA,MAAA;EAEJ,KAAA,CAAA,EAAA,KAAA;EAAK,MAAA,CAAA,EAAA,OAAA;AAIf;AAGa,UAHI,uBAAA,CAGJ;EACC,UAAA,EAAA,MAAA;EAEH,SAAA,EAAA,MAAA;EAAqB,SAAA,EAHnB,IAGmB;EAGpB,UAAA,EALE,IAKF;EACA,MAAA,EAAA,SAAA,GAAA,SAAwB,GAAA,QAAW;EACnC,OAAA,EALD,qBAK0B,EAAA;AACrC;AACY,KAJA,qBAAA,GAAwB,OAIC,CAJO,cAII,EAAA;EAE/B,IAAA,EAAA,kBAAgB;CAEpB,CAAA;AACC,KARF,wBAAA,GAA2B,OAQzB,CARiC,cAQjC,EAAA;EACF,IAAA,EAAA,sBAAA;CACP,CAAA;AAAO,KATA,cAAA,GAAiB,OASjB,CATyB,cASzB,EAAA;EAGK,IAAA,EAAA,WAAA;CAEJ,CAAA;AACC,KAdF,mBAAA,GAAsB,OAcpB,CAd4B,cAc5B,EAAA;EACF,IAAA,EAAA,gBAAA;CACP,CAAA;AAAO,KAfA,yBAAA,GAA4B,OAe5B,CAfoC,cAepC,EAAA;EAGK,IAAA,EAAA,sBAAY;CAEhB,CAAA;AACC,UAnBG,gBAAA,CAmBH;EACF,oBAAA,CAAA,OAAA,EAlBC,mBAkBD,EAAA,QAAA,EAjBE,kBAiBF,EAAA,MAAA,EAhBA,qBAgBA,CAAA,EAfP,OAeO,CAAA,OAAA,CAAA;;AACA,UAbK,mBAAA,CAaL;EAGK,uBAAiB,CAAA,OAAA,EAdrB,mBAcqB,EAAA,QAAA,EAbpB,kBAaoB,EAAA,MAAA,EAZtB,wBAYsB,CAAA,EAX7B,OAW6B,CAAA,OAAA,CAAA;;AAGpB,UAXG,YAAA,CAWH;EACF,QAAA,CAAA,OAAA,EAVC,mBAUD,EAAA,QAAA,EATE,kBASF,EAAA,MAAA,EARA,cAQA,CAAA,EAPP,OAOO,CAAA,OAAA,CAAA;;AACA,UALK,iBAAA,CAKL;EAGK,aAAA,CAAA,OAAA,EANJ,mBAMuB,EAAA,QAAA,EALtB,kBAKsB,EAAA,MAAA,EAJxB,mBAIwB,CAAA,EAH/B,OAG+B,CAAA,OAAA,CAAA;;AAGtB,UAHG,mBAAA,CAGH;EACF,mBAAA,CAAA,OAAA,EAFC,mBAED,EAAA,QAAA,EADE,kBACF,EAAA,MAAA,EAAA,yBAAA,CAAA,EACP,OADO,CAAA,OAAA,CAAA;;AACA,UAGK,uBAAA,CAHL;EAGK,MAAA,CAAA,EAAA,OAAA;AAIjB;AACqB,UADJ,oBAAA,CACI;EACG,gBAAA,CAAA,EADH,gBACG;EACP,mBAAA,CAAA,EADO,mBACP;EACK,YAAA,CAAA,EADL,YACK;EACE,iBAAA,CAAA,EADF,iBACE;EAAmB,mBAAA,CAAA,EAAnB,mBAAmB;AAG3C;AACqC,cADxB,gBAAA,CACwB;EAGxB,iBAAA,IAAA;EACC,WAAA,CAAA,IAAA,CAAA,EAJuB,oBAIvB;EACD,OAAA,CAAA,OAAA,EAFA,mBAEA,EAAA,QAAA,EADC,kBACD,EAAA,OAAA,CAAA,EAAA,uBAAA,CAAA,EACR,OADQ,CACA,uBADA,CAAA;EACA,QAAA,aAAA"}

package/dist/regenerator/executor.js

@@ -0,0 +1,2 @@
+var e=class{constructor(e={}){this.deps=e}async execute(e,n,r={}){let i=new Date,a=[];for(let[t,i]of n.actions.entries()){let o=await this.executeAction({index:t,action:i,context:e,proposal:n,options:r});a.push(o)}let o=new Date,s=t(a);return{proposalId:n.id,contextId:e.id,startedAt:i,finishedAt:o,status:s,actions:a}}async executeAction({index:e,action:t,context:n,proposal:r,options:i}){let a=new Date,o=i.dryRun??!1,s=(n,r={})=>({index:e,action:t,status:n,startedAt:a,finishedAt:new Date,reason:r.reason,output:r.output,error:r.error});if(o)return s(`skipped`,{reason:`dry_run`});try{switch(t.kind){case`update_blueprint`:{let e=this.deps.blueprintUpdater;return e?s(`success`,{output:await e.applyBlueprintUpdate(n,r,t)}):s(`skipped`,{reason:`missing_blueprint_updater`})}case`update_tenant_config`:{let e=this.deps.tenantConfigUpdater;return e?s(`success`,{output:await e.applyTenantConfigUpdate(n,r,t)}):s(`skipped`,{reason:`missing_tenant_config_updater`})}case`run_tests`:{let e=this.deps.testExecutor;return e?s(`success`,{output:await e.runTests(n,r,t)}):s(`skipped`,{reason:`missing_test_executor`})}case`run_migrations`:{let e=this.deps.migrationExecutor;return e?s(`success`,{output:await e.runMigrations(n,r,t)}):s(`skipped`,{reason:`missing_migration_executor`})}case`trigger_regeneration`:{let e=this.deps.regenerationTrigger;return e?s(`success`,{output:await e.triggerRegeneration(n,r,t)}):s(`skipped`,{reason:`missing_regeneration_trigger`})}default:return s(`skipped`,{reason:`unknown_action`})}}catch(e){return s(`failed`,{error:e instanceof Error?e:Error(String(e))})}}};function t(e){return e.some(e=>e.status===`failed`)?`failed`:e.some(e=>e.status===`success`)&&e.some(e=>e.status===`skipped`)||e.every(e=>e.status===`skipped`)?`partial`:`success`}export{e as ProposalExecutor};
+//# sourceMappingURL=executor.js.map

package/dist/regenerator/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","names":["deps: ProposalExecutorDeps","actionResults: ActionExecutionResult[]"],"sources":["../../src/regenerator/executor.ts"],"sourcesContent":["import type { SpecChangeProposal, ProposalAction, RegenerationContext } from './types';\n\nexport type ExecutionStatus = 'success' | 'skipped' | 'failed';\n\nexport interface ActionExecutionResult {\n  index: number;\n  action: ProposalAction;\n  status: ExecutionStatus;\n  startedAt: Date;\n  finishedAt: Date;\n  reason?: string;\n  error?: Error;\n  output?: unknown;\n}\n\nexport interface ProposalExecutionResult {\n  proposalId: string;\n  contextId: string;\n  startedAt: Date;\n  finishedAt: Date;\n  status: 'success' | 'partial' | 'failed';\n  actions: ActionExecutionResult[];\n}\n\nexport type UpdateBlueprintAction = Extract<ProposalAction, { kind: 'update_blueprint' }>;\nexport type UpdateTenantConfigAction = Extract<ProposalAction, { kind: 'update_tenant_config' }>;\nexport type RunTestsAction = Extract<ProposalAction, { kind: 'run_tests' }>;\nexport type RunMigrationsAction = Extract<ProposalAction, { kind: 'run_migrations' }>;\nexport type TriggerRegenerationAction = Extract<ProposalAction, { kind: 'trigger_regeneration' }>;\n\nexport interface BlueprintUpdater {\n  applyBlueprintUpdate(\n    context: RegenerationContext,\n    proposal: SpecChangeProposal,\n    action: UpdateBlueprintAction\n  ): Promise<unknown>;\n}\n\nexport interface TenantConfigUpdater {\n  applyTenantConfigUpdate(\n    context: RegenerationContext,\n    proposal: SpecChangeProposal,\n    action: UpdateTenantConfigAction\n  ): Promise<unknown>;\n}\n\nexport interface TestExecutor {\n  runTests(\n    context: RegenerationContext,\n    proposal: SpecChangeProposal,\n    action: RunTestsAction\n  ): Promise<unknown>;\n}\n\nexport interface MigrationExecutor {\n  runMigrations(\n    context: RegenerationContext,\n    proposal: SpecChangeProposal,\n    action: RunMigrationsAction\n  ): Promise<unknown>;\n}\n\nexport interface RegenerationTrigger {\n  triggerRegeneration(\n    context: RegenerationContext,\n    proposal: SpecChangeProposal,\n    action: TriggerRegenerationAction\n  ): Promise<unknown>;\n}\n\nexport interface ProposalExecutorOptions {\n  dryRun?: boolean;\n}\n\nexport interface ProposalExecutorDeps {\n  blueprintUpdater?: BlueprintUpdater;\n  tenantConfigUpdater?: TenantConfigUpdater;\n  testExecutor?: TestExecutor;\n  migrationExecutor?: MigrationExecutor;\n  regenerationTrigger?: RegenerationTrigger;\n}\n\nexport class ProposalExecutor {\n  constructor(private readonly deps: ProposalExecutorDeps = {}) {}\n\n  async execute(\n    context: RegenerationContext,\n    proposal: SpecChangeProposal,\n    options: ProposalExecutorOptions = {}\n  ): Promise<ProposalExecutionResult> {\n    const startedAt = new Date();\n    const actionResults: ActionExecutionResult[] = [];\n\n    for (const [index, action] of proposal.actions.entries()) {\n      // eslint-disable-next-line no-await-in-loop\n      const result = await this.executeAction({\n        index,\n        action,\n        context,\n        proposal,\n        options,\n      });\n      actionResults.push(result);\n    }\n\n    const finishedAt = new Date();\n    const summaryStatus = summarizeStatus(actionResults);\n\n    return {\n      proposalId: proposal.id,\n      contextId: context.id,\n      startedAt,\n      finishedAt,\n      status: summaryStatus,\n      actions: actionResults,\n    };\n  }\n\n  private async executeAction({\n    index,\n    action,\n    context,\n    proposal,\n    options,\n  }: {\n    index: number;\n    action: ProposalAction;\n    context: RegenerationContext;\n    proposal: SpecChangeProposal;\n    options: ProposalExecutorOptions;\n  }): Promise<ActionExecutionResult> {\n    const startedAt = new Date();\n    const dryRun = options.dryRun ?? false;\n\n    const complete = (\n      status: ExecutionStatus,\n      params: {\n        reason?: string;\n        output?: unknown;\n        error?: Error;\n      } = {}\n    ): ActionExecutionResult => ({\n      index,\n      action,\n      status,\n      startedAt,\n      finishedAt: new Date(),\n      reason: params.reason,\n      output: params.output,\n      error: params.error,\n    });\n\n    if (dryRun) {\n      return complete('skipped', { reason: 'dry_run' });\n    }\n\n    try {\n      switch (action.kind) {\n        case 'update_blueprint': {\n          const updater = this.deps.blueprintUpdater;\n          if (!updater) {\n            return complete('skipped', { reason: 'missing_blueprint_updater' });\n          }\n          const output = await updater.applyBlueprintUpdate(context, proposal, action);\n          return complete('success', { output });\n        }\n        case 'update_tenant_config': {\n          const updater = this.deps.tenantConfigUpdater;\n          if (!updater) {\n            return complete('skipped', { reason: 'missing_tenant_config_updater' });\n          }\n          const output = await updater.applyTenantConfigUpdate(context, proposal, action);\n          return complete('success', { output });\n        }\n        case 'run_tests': {\n          const executor = this.deps.testExecutor;\n          if (!executor) {\n            return complete('skipped', { reason: 'missing_test_executor' });\n          }\n          const output = await executor.runTests(context, proposal, action);\n          return complete('success', { output });\n        }\n        case 'run_migrations': {\n          const executor = this.deps.migrationExecutor;\n          if (!executor) {\n            return complete('skipped', { reason: 'missing_migration_executor' });\n          }\n          const output = await executor.runMigrations(context, proposal, action);\n          return complete('success', { output });\n        }\n        case 'trigger_regeneration': {\n          const trigger = this.deps.regenerationTrigger;\n          if (!trigger) {\n            return complete('skipped', { reason: 'missing_regeneration_trigger' });\n          }\n          const output = await trigger.triggerRegeneration(context, proposal, action);\n          return complete('success', { output });\n        }\n        default: {\n          return complete('skipped', { reason: 'unknown_action' });\n        }\n      }\n    } catch (error) {\n      return complete('failed', {\n        error: error instanceof Error ? error : new Error(String(error)),\n      });\n    }\n  }\n}\n\nfunction summarizeStatus(actionResults: ActionExecutionResult[]): ProposalExecutionResult['status'] {\n  if (actionResults.some((result) => result.status === 'failed')) {\n    return 'failed';\n  }\n  if (actionResults.some((result) => result.status === 'success') &&\n      actionResults.some((result) => result.status === 'skipped')) {\n    return 'partial';\n  }\n  if (actionResults.every((result) => result.status === 'skipped')) {\n    return 'partial';\n  }\n  return 'success';\n}\n\n\n\n\n\n\n\n"],"mappings":"AAkFA,IAAa,EAAb,KAA8B,CAC5B,YAAY,EAA8C,EAAE,CAAE,CAAjC,KAAA,KAAA,EAE7B,MAAM,QACJ,EACA,EACA,EAAmC,EAAE,CACH,CAClC,IAAM,EAAY,IAAI,KAChBC,EAAyC,EAAE,CAEjD,IAAK,GAAM,CAAC,EAAO,KAAW,EAAS,QAAQ,SAAS,CAAE,CAExD,IAAM,EAAS,MAAM,KAAK,cAAc,CACtC,QACA,SACA,UACA,WACA,UACD,CAAC,CACF,EAAc,KAAK,EAAO,CAG5B,IAAM,EAAa,IAAI,KACjB,EAAgB,EAAgB,EAAc,CAEpD,MAAO,CACL,WAAY,EAAS,GACrB,UAAW,EAAQ,GACnB,YACA,aACA,OAAQ,EACR,QAAS,EACV,CAGH,MAAc,cAAc,CAC1B,QACA,SACA,UACA,WACA,WAOiC,CACjC,IAAM,EAAY,IAAI,KAChB,EAAS,EAAQ,QAAU,GAE3B,GACJ,EACA,EAII,EAAE,IACqB,CAC3B,QACA,SACA,SACA,YACA,WAAY,IAAI,KAChB,OAAQ,EAAO,OACf,OAAQ,EAAO,OACf,MAAO,EAAO,MACf,EAED,GAAI,EACF,OAAO,EAAS,UAAW,CAAE,OAAQ,UAAW,CAAC,CAGnD,GAAI,CACF,OAAQ,EAAO,KAAf,CACE,IAAK,mBAAoB,CACvB,IAAM,EAAU,KAAK,KAAK,iBAK1B,OAJK,EAIE,EAAS,UAAW,CAAE,OADd,MAAM,EAAQ,qBAAqB,EAAS,EAAU,EAAO,CACvC,CAAC,CAH7B,EAAS,UAAW,CAAE,OAAQ,4BAA6B,CAAC,CAKvE,IAAK,uBAAwB,CAC3B,IAAM,EAAU,KAAK,KAAK,oBAK1B,OAJK,EAIE,EAAS,UAAW,CAAE,OADd,MAAM,EAAQ,wBAAwB,EAAS,EAAU,EAAO,CAC1C,CAAC,CAH7B,EAAS,UAAW,CAAE,OAAQ,gCAAiC,CAAC,CAK3E,IAAK,YAAa,CAChB,IAAM,EAAW,KAAK,KAAK,aAK3B,OAJK,EAIE,EAAS,UAAW,CAAE,OADd,MAAM,EAAS,SAAS,EAAS,EAAU,EAAO,CAC5B,CAAC,CAH7B,EAAS,UAAW,CAAE,OAAQ,wBAAyB,CAAC,CAKnE,IAAK,iBAAkB,CACrB,IAAM,EAAW,KAAK,KAAK,kBAK3B,OAJK,EAIE,EAAS,UAAW,CAAE,OADd,MAAM,EAAS,cAAc,EAAS,EAAU,EAAO,CACjC,CAAC,CAH7B,EAAS,UAAW,CAAE,OAAQ,6BAA8B,CAAC,CAKxE,IAAK,uBAAwB,CAC3B,IAAM,EAAU,KAAK,KAAK,oBAK1B,OAJK,EAIE,EAAS,UAAW,CAAE,OADd,MAAM,EAAQ,oBAAoB,EAAS,EAAU,EAAO,CACtC,CAAC,CAH7B,EAAS,UAAW,CAAE,OAAQ,+BAAgC,CAAC,CAK1E,QACE,OAAO,EAAS,UAAW,CAAE,OAAQ,iBAAkB,CAAC,QAGrD,EAAO,CACd,OAAO,EAAS,SAAU,CACxB,MAAO,aAAiB,MAAQ,EAAY,MAAM,OAAO,EAAM,CAAC,CACjE,CAAC,IAKR,SAAS,EAAgB,EAA2E,CAWlG,OAVI,EAAc,KAAM,GAAW,EAAO,SAAW,SAAS,CACrD,SAEL,EAAc,KAAM,GAAW,EAAO,SAAW,UAAU,EAC3D,EAAc,KAAM,GAAW,EAAO,SAAW,UAAU,EAG3D,EAAc,MAAO,GAAW,EAAO,SAAW,UAAU,CACvD,UAEF"}

package/dist/regenerator/index.d.ts

@@ -0,0 +1,7 @@
+import { BehaviorSignal, BehaviorSignalEnvelope, ErrorSignal, ErrorSignalEnvelope, ProposalAction, ProposalBlocker, ProposalConfidence, ProposalSink, ProposalTarget, RegenerationContext, RegenerationRule, RegeneratorSignal, SpecChangeProposal, TelemetrySignal, TelemetrySignalEnvelope } from "./types.js";
+import { BehaviorSignalProvider, ErrorSignalProvider, SignalAdapters, TelemetrySignalProvider } from "./adapters.js";
+import { RegeneratorOptions, RegeneratorService } from "./service.js";
+import { ActionExecutionResult, BlueprintUpdater, ExecutionStatus, MigrationExecutor, ProposalExecutionResult, ProposalExecutor, ProposalExecutorDeps, ProposalExecutorOptions, RegenerationTrigger, RunMigrationsAction, RunTestsAction, TenantConfigUpdater, TestExecutor, TriggerRegenerationAction, UpdateBlueprintAction, UpdateTenantConfigAction } from "./executor.js";
+import { behaviorToEnvelope, errorToEnvelope, telemetryToEnvelope } from "./utils.js";
+import { ExecutorProposalSink, ExecutorResultPayload, ExecutorSinkLogger, ExecutorSinkOptions } from "./sinks.js";
+export { ActionExecutionResult, BehaviorSignal, BehaviorSignalEnvelope, BehaviorSignalProvider, BlueprintUpdater, ErrorSignal, ErrorSignalEnvelope, ErrorSignalProvider, ExecutionStatus, ExecutorProposalSink, ExecutorResultPayload, ExecutorSinkLogger, ExecutorSinkOptions, MigrationExecutor, ProposalAction, ProposalBlocker, ProposalConfidence, ProposalExecutionResult, ProposalExecutor, ProposalExecutorDeps, ProposalExecutorOptions, ProposalSink, ProposalTarget, RegenerationContext, RegenerationRule, RegenerationTrigger, RegeneratorOptions, RegeneratorService, RegeneratorSignal, RunMigrationsAction, RunTestsAction, SignalAdapters, SpecChangeProposal, TelemetrySignal, TelemetrySignalEnvelope, TelemetrySignalProvider, TenantConfigUpdater, TestExecutor, TriggerRegenerationAction, UpdateBlueprintAction, UpdateTenantConfigAction, behaviorToEnvelope, errorToEnvelope, telemetryToEnvelope };

package/dist/regenerator/index.js

@@ -0,0 +1 @@
+import{behaviorToEnvelope as e,errorToEnvelope as t,telemetryToEnvelope as n}from"./utils.js";import{RegeneratorService as r}from"./service.js";import{ProposalExecutor as i}from"./executor.js";import{ExecutorProposalSink as a}from"./sinks.js";export{a as ExecutorProposalSink,i as ProposalExecutor,r as RegeneratorService,e as behaviorToEnvelope,t as errorToEnvelope,n as telemetryToEnvelope};

package/dist/regenerator/service.d.ts

@@ -0,0 +1,34 @@
+import { ProposalSink, RegenerationContext, RegenerationRule } from "./types.js";
+import { SignalAdapters } from "./adapters.js";
+
+//#region src/regenerator/service.d.ts
+interface RegeneratorOptions {
+  contexts: RegenerationContext[];
+  adapters: SignalAdapters;
+  rules: RegenerationRule[];
+  sink: ProposalSink;
+  pollIntervalMs?: number;
+  batchDurationMs?: number;
+  clock?: () => Date;
+}
+declare class RegeneratorService {
+  private readonly options;
+  private readonly contexts;
+  private readonly lastPoll;
+  private timer?;
+  private running;
+  private readonly pollInterval;
+  private readonly batchDuration;
+  private readonly clock;
+  constructor(options: RegeneratorOptions);
+  start(): void;
+  stop(): void;
+  runOnce(): Promise<void>;
+  private tick;
+  private evaluateContext;
+  private collectSignals;
+  private flushProposals;
+}
+//#endregion
+export { RegeneratorOptions, RegeneratorService };
+//# sourceMappingURL=service.d.ts.map

package/dist/regenerator/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","names":[],"sources":["../../src/regenerator/service.ts"],"sourcesContent":[],"mappings":";;;;UAWiB,kBAAA;YACL;EADK,QAAA,EAEL,cAFuB;EACvB,KAAA,EAEH,gBAFG,EAAA;EACA,IAAA,EAEJ,YAFI;EACH,cAAA,CAAA,EAAA,MAAA;EACD,eAAA,CAAA,EAAA,MAAA;EAGQ,KAAA,CAAA,EAAA,GAAA,GAAA,IAAA;;AAMH,cAAA,kBAAA,CAS2B;;;;;;;;;uBAAA;;;aA8BrB"}

package/dist/regenerator/service.js

@@ -0,0 +1,2 @@
+import{behaviorToEnvelope as e,errorToEnvelope as t,telemetryToEnvelope as n}from"./utils.js";import{setTimeout as r}from"node:timers/promises";var i=class{contexts;lastPoll=new Map;timer;running=!1;pollInterval;batchDuration;clock;constructor(e){if(this.options=e,this.contexts=new Map(e.contexts.map(e=>[e.id,e])),this.pollInterval=e.pollIntervalMs??6e4,this.batchDuration=e.batchDurationMs??3e5,this.clock=e.clock??(()=>new Date),this.options.rules.length===0)throw Error(`RegeneratorService requires at least one rule`)}start(){this.running||(this.running=!0,this.tick(),this.timer=setInterval(()=>{this.tick()},this.pollInterval))}stop(){this.running&&(this.running=!1,this.timer&&=(clearInterval(this.timer),void 0))}async runOnce(){await this.tick()}async tick(){let e=this.clock(),t=new Date(e.getTime()-this.batchDuration);for(let n of this.contexts.values()){let r=this.lastPoll.get(n.id)??t;await this.evaluateContext(n,r,e),this.lastPoll.set(n.id,e)}}async evaluateContext(e,t,n){let r=await this.collectSignals(e,t,n);if(r.length!==0)for(let t of this.options.rules){let n=[];try{n=await t.evaluate(e,r)}catch(e){console.error(`[regenerator] rule ${t.id} failed`,e instanceof Error?e:Error(String(e)));continue}await this.flushProposals(e,n)}}async collectSignals(r,i,a){let o=[],{adapters:s}=this.options;if(s.telemetry){let e=await s.telemetry.pollTelemetry(r,i,a);o.push(...e.map(e=>n(r.id,e,this.clock)))}if(s.errors){let e=await s.errors.pollErrors(r,i,a);o.push(...e.map(e=>t(r.id,e,this.clock)))}if(s.behavior){let t=await s.behavior.pollBehavior(r,i,a);o.push(...t.map(t=>e(r.id,t,this.clock)))}return o}async flushProposals(e,t){for(let n of t)n.signalIds.length!==0&&(await this.options.sink.submit(e,n),t.length>10&&await r(0))}};export{i as RegeneratorService};
+//# sourceMappingURL=service.js.map

package/dist/regenerator/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","names":["options: RegeneratorOptions","proposals: SpecChangeProposal[]","envelopes: RegeneratorSignal[]","delay"],"sources":["../../src/regenerator/service.ts"],"sourcesContent":["import { setTimeout as delay } from 'node:timers/promises';\nimport type {\n  ProposalSink,\n  RegeneratorSignal,\n  RegenerationRule,\n  RegenerationContext,\n  SpecChangeProposal,\n} from './types';\nimport type { SignalAdapters } from './adapters';\nimport { telemetryToEnvelope, errorToEnvelope, behaviorToEnvelope } from './utils';\n\nexport interface RegeneratorOptions {\n  contexts: RegenerationContext[];\n  adapters: SignalAdapters;\n  rules: RegenerationRule[];\n  sink: ProposalSink;\n  pollIntervalMs?: number;\n  batchDurationMs?: number;\n  clock?: () => Date;\n}\n\nconst DEFAULT_POLL_INTERVAL = 60_000;\nconst DEFAULT_BATCH_DURATION = 5 * 60_000;\n\nexport class RegeneratorService {\n  private readonly contexts: Map<string, RegenerationContext>;\n  private readonly lastPoll = new Map<string, Date>();\n  private timer?: NodeJS.Timeout;\n  private running = false;\n  private readonly pollInterval: number;\n  private readonly batchDuration: number;\n  private readonly clock: () => Date;\n\n  constructor(private readonly options: RegeneratorOptions) {\n    this.contexts = new Map(\n      options.contexts.map((ctx) => [ctx.id, ctx])\n    );\n    this.pollInterval = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL;\n    this.batchDuration = options.batchDurationMs ?? DEFAULT_BATCH_DURATION;\n    this.clock = options.clock ?? (() => new Date());\n    if (this.options.rules.length === 0) {\n      throw new Error('RegeneratorService requires at least one rule');\n    }\n  }\n\n  start() {\n    if (this.running) return;\n    this.running = true;\n    void this.tick();\n    this.timer = setInterval(() => {\n      void this.tick();\n    }, this.pollInterval);\n  }\n\n  stop() {\n    if (!this.running) return;\n    this.running = false;\n    if (this.timer) {\n      clearInterval(this.timer);\n      this.timer = undefined;\n    }\n  }\n\n  async runOnce(): Promise<void> {\n    await this.tick();\n  }\n\n  private async tick(): Promise<void> {\n    const now = this.clock();\n    const sinceDefault = new Date(now.getTime() - this.batchDuration);\n    for (const context of this.contexts.values()) {\n      const last = this.lastPoll.get(context.id) ?? sinceDefault;\n      await this.evaluateContext(context, last, now);\n      this.lastPoll.set(context.id, now);\n    }\n  }\n\n  private async evaluateContext(\n    context: RegenerationContext,\n    since: Date,\n    until: Date\n  ): Promise<void> {\n    const signals = await this.collectSignals(context, since, until);\n    if (signals.length === 0) return;\n\n    for (const rule of this.options.rules) {\n      let proposals: SpecChangeProposal[] = [];\n      try {\n        proposals = await rule.evaluate(context, signals);\n      } catch (error) {\n        // eslint-disable-next-line no-console\n        console.error(\n          `[regenerator] rule ${rule.id} failed`,\n          error instanceof Error ? error : new Error(String(error))\n        );\n        continue;\n      }\n      await this.flushProposals(context, proposals);\n    }\n  }\n\n  private async collectSignals(\n    context: RegenerationContext,\n    since: Date,\n    until: Date\n  ): Promise<RegeneratorSignal[]> {\n    const envelopes: RegeneratorSignal[] = [];\n    const { adapters } = this.options;\n    if (adapters.telemetry) {\n      const telemetrySignals = await adapters.telemetry.pollTelemetry(\n        context,\n        since,\n        until\n      );\n      envelopes.push(\n        ...telemetrySignals.map((signal) =>\n          telemetryToEnvelope(context.id, signal, this.clock)\n        )\n      );\n    }\n    if (adapters.errors) {\n      const errorSignals = await adapters.errors.pollErrors(\n        context,\n        since,\n        until\n      );\n      envelopes.push(\n        ...errorSignals.map((signal) =>\n          errorToEnvelope(context.id, signal, this.clock)\n        )\n      );\n    }\n    if (adapters.behavior) {\n      const behaviorSignals = await adapters.behavior.pollBehavior(\n        context,\n        since,\n        until\n      );\n      envelopes.push(\n        ...behaviorSignals.map((signal) =>\n          behaviorToEnvelope(context.id, signal, this.clock)\n        )\n      );\n    }\n    return envelopes;\n  }\n\n  private async flushProposals(\n    context: RegenerationContext,\n    proposals: SpecChangeProposal[]\n  ): Promise<void> {\n    for (const proposal of proposals) {\n      if (proposal.signalIds.length === 0) continue;\n      await this.options.sink.submit(context, proposal);\n      // allow event loop to breathe when large volumes\n      if (proposals.length > 10) {\n        await delay(0);\n      }\n    }\n  }\n}\n\n\n\n\n\n\n\n"],"mappings":"gJAwBA,IAAa,EAAb,KAAgC,CAC9B,SACA,SAA4B,IAAI,IAChC,MACA,QAAkB,GAClB,aACA,cACA,MAEA,YAAY,EAA8C,CAOxD,GAP2B,KAAA,QAAA,EAC3B,KAAK,SAAW,IAAI,IAClB,EAAQ,SAAS,IAAK,GAAQ,CAAC,EAAI,GAAI,EAAI,CAAC,CAC7C,CACD,KAAK,aAAe,EAAQ,gBAAkB,IAC9C,KAAK,cAAgB,EAAQ,iBAAmB,IAChD,KAAK,MAAQ,EAAQ,YAAgB,IAAI,MACrC,KAAK,QAAQ,MAAM,SAAW,EAChC,MAAU,MAAM,gDAAgD,CAIpE,OAAQ,CACF,KAAK,UACT,KAAK,QAAU,GACV,KAAK,MAAM,CAChB,KAAK,MAAQ,gBAAkB,CACxB,KAAK,MAAM,EACf,KAAK,aAAa,EAGvB,MAAO,CACA,KAAK,UACV,KAAK,QAAU,GACf,AAEE,KAAK,SADL,cAAc,KAAK,MAAM,CACZ,IAAA,KAIjB,MAAM,SAAyB,CAC7B,MAAM,KAAK,MAAM,CAGnB,MAAc,MAAsB,CAClC,IAAM,EAAM,KAAK,OAAO,CAClB,EAAe,IAAI,KAAK,EAAI,SAAS,CAAG,KAAK,cAAc,CACjE,IAAK,IAAM,KAAW,KAAK,SAAS,QAAQ,CAAE,CAC5C,IAAM,EAAO,KAAK,SAAS,IAAI,EAAQ,GAAG,EAAI,EAC9C,MAAM,KAAK,gBAAgB,EAAS,EAAM,EAAI,CAC9C,KAAK,SAAS,IAAI,EAAQ,GAAI,EAAI,EAItC,MAAc,gBACZ,EACA,EACA,EACe,CACf,IAAM,EAAU,MAAM,KAAK,eAAe,EAAS,EAAO,EAAM,CAC5D,KAAQ,SAAW,EAEvB,IAAK,IAAM,KAAQ,KAAK,QAAQ,MAAO,CACrC,IAAIC,EAAkC,EAAE,CACxC,GAAI,CACF,EAAY,MAAM,EAAK,SAAS,EAAS,EAAQ,OAC1C,EAAO,CAEd,QAAQ,MACN,sBAAsB,EAAK,GAAG,SAC9B,aAAiB,MAAQ,EAAY,MAAM,OAAO,EAAM,CAAC,CAC1D,CACD,SAEF,MAAM,KAAK,eAAe,EAAS,EAAU,EAIjD,MAAc,eACZ,EACA,EACA,EAC8B,CAC9B,IAAMC,EAAiC,EAAE,CACnC,CAAE,YAAa,KAAK,QAC1B,GAAI,EAAS,UAAW,CACtB,IAAM,EAAmB,MAAM,EAAS,UAAU,cAChD,EACA,EACA,EACD,CACD,EAAU,KACR,GAAG,EAAiB,IAAK,GACvB,EAAoB,EAAQ,GAAI,EAAQ,KAAK,MAAM,CACpD,CACF,CAEH,GAAI,EAAS,OAAQ,CACnB,IAAM,EAAe,MAAM,EAAS,OAAO,WACzC,EACA,EACA,EACD,CACD,EAAU,KACR,GAAG,EAAa,IAAK,GACnB,EAAgB,EAAQ,GAAI,EAAQ,KAAK,MAAM,CAChD,CACF,CAEH,GAAI,EAAS,SAAU,CACrB,IAAM,EAAkB,MAAM,EAAS,SAAS,aAC9C,EACA,EACA,EACD,CACD,EAAU,KACR,GAAG,EAAgB,IAAK,GACtB,EAAmB,EAAQ,GAAI,EAAQ,KAAK,MAAM,CACnD,CACF,CAEH,OAAO,EAGT,MAAc,eACZ,EACA,EACe,CACf,IAAK,IAAM,KAAY,EACjB,EAAS,UAAU,SAAW,IAClC,MAAM,KAAK,QAAQ,KAAK,OAAO,EAAS,EAAS,CAE7C,EAAU,OAAS,IACrB,MAAMC,EAAM,EAAE"}

package/dist/regenerator/sinks.d.ts

@@ -0,0 +1,27 @@
+import { ProposalSink, RegenerationContext, SpecChangeProposal } from "./types.js";
+import { ProposalExecutionResult, ProposalExecutor } from "./executor.js";
+
+//#region src/regenerator/sinks.d.ts
+interface ExecutorResultPayload {
+  context: RegenerationContext;
+  proposal: SpecChangeProposal;
+  result: ProposalExecutionResult;
+}
+interface ExecutorSinkLogger {
+  info?: (message: string, meta?: Record<string, unknown>) => void;
+  error?: (message: string, error: Error, meta?: Record<string, unknown>) => void;
+}
+interface ExecutorSinkOptions {
+  dryRun?: boolean;
+  onResult?: (payload: ExecutorResultPayload) => void | Promise<void>;
+  logger?: ExecutorSinkLogger;
+}
+declare class ExecutorProposalSink implements ProposalSink {
+  private readonly executor;
+  private readonly options;
+  constructor(executor: ProposalExecutor, options?: ExecutorSinkOptions);
+  submit(context: RegenerationContext, proposal: SpecChangeProposal): Promise<void>;
+}
+//#endregion
+export { ExecutorProposalSink, ExecutorResultPayload, ExecutorSinkLogger, ExecutorSinkOptions };
+//# sourceMappingURL=sinks.d.ts.map

package/dist/regenerator/sinks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sinks.d.ts","names":[],"sources":["../../src/regenerator/sinks.ts"],"sourcesContent":[],"mappings":";;;;UAIiB,qBAAA;EAAA,OAAA,EACN,mBAD2B;EAC3B,QAAA,EACC,kBADD;EACC,MAAA,EACF,uBADE;;AACqB,UAGhB,kBAAA,CAHgB;EAGhB,IAAA,CAAA,EAAA,CAAA,OAAA,EAAA,MAAkB,EAAA,IAAA,CAAA,EACD,MADC,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,GAAA,IAAA;EACD,KAAA,CAAA,EAAA,CAAA,OAAA,EAAA,MAAA,EAAA,KAAA,EACC,KADD,EAAA,IAAA,CAAA,EACe,MADf,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,GAAA,IAAA;;AACe,UAGhC,mBAAA,CAHgC;EAAM,MAAA,CAAA,EAAA,OAAA;EAGtC,QAAA,CAAA,EAAA,CAAA,OAAA,EAEM,qBAFa,EAAA,GAAA,IAAA,GAEoB,OAFpB,CAAA,IAAA,CAAA;EAEb,MAAA,CAAA,EACZ,kBADY;;AACZ,cAGE,oBAAA,YAAgC,YAHlC,CAAA;EAAkB,iBAAA,QAAA;EAGhB,iBAAA,OAAqB;EAEH,WAAA,CAAA,QAAA,EAAA,gBAAA,EAAA,OAAA,CAAA,EACD,mBADC;EACD,MAAA,CAAA,OAAA,EAIjB,mBAJiB,EAAA,QAAA,EAKhB,kBALgB,CAAA,EAMzB,OANyB,CAAA,IAAA,CAAA"}

package/dist/regenerator/sinks.js

@@ -0,0 +1,2 @@
+var e=class{constructor(e,t={}){this.executor=e,this.options=t}async submit(e,t){let n=this.options.dryRun??!1;try{let r=await this.executor.execute(e,t,{dryRun:n});this.options.logger?.info&&this.options.logger.info(`[regenerator] proposal executed`,{proposalId:t.id,contextId:e.id,status:r.status}),this.options.onResult&&await this.options.onResult({context:e,proposal:t,result:r})}catch(n){throw this.options.logger?.error&&this.options.logger.error(`[regenerator] proposal execution failed`,n instanceof Error?n:Error(String(n)),{proposalId:t.id,contextId:e.id}),n instanceof Error?n:Error(String(n))}}};export{e as ExecutorProposalSink};
+//# sourceMappingURL=sinks.js.map