@lssm/lib.contracts 1.11.1 → 1.41.1

package/dist/schema-to-markdown.js

@@ -0,0 +1,10 @@
+function e(e,i,a={}){let{format:o=`auto`,title:s,description:c,maxDepth:l=2}=a,u=[];s&&u.push(`# ${s}`,``),c&&u.push(`> ${c}`,``);let d=o===`auto`?Array.isArray(i)?`table`:`detail`:o;return d===`table`&&Array.isArray(i)?u.push(t(e,i,a)):d===`list`&&Array.isArray(i)?u.push(n(e,i,a)):!Array.isArray(i)&&typeof i==`object`&&i?u.push(r(e,i,{...a,maxDepth:l})):u.push(`**Data:** ${String(i)}`,``),u.join(`
+`)}function t(e,t,n={}){let{maxItems:r=100,includeFields:i,excludeFields:c=[]}=n,l=a(e,i,c);if(l.length===0||t.length===0)return`_No data available_
+`;let u=t.slice(0,r),d=[],f=l.map(e=>e.label);d.push(`| ${f.join(` | `)} |`),d.push(`| ${f.map(()=>`---`).join(` | `)} |`);for(let e of u){let t=l.map(t=>s(o(e,t.name)));d.push(`| ${t.join(` | `)} |`)}return t.length>r&&d.push(``,`_Showing ${r} of ${t.length} items_`),d.push(``),d.join(`
+`)}function n(e,t,n={}){let{maxItems:r=50,summaryFields:i,includeFields:c,excludeFields:l=[]}=n,u=a(e,c,l),d=i?u.filter(e=>i.includes(e.name)):u.slice(0,3);if(d.length===0||t.length===0)return`_No data available_
+`;let f=t.slice(0,r),p=[];for(let e of f){let t=s(o(e,d[0]?.name??`id`)),n=d.slice(1).map(t=>`${t.label}: ${s(o(e,t.name))}`).join(` · `),r=n?`- **${t}** (${n})`:`- **${t}**`;p.push(r)}return t.length>r&&p.push(``,`_Showing ${r} of ${t.length} items_`),p.push(``),p.join(`
+`)}function r(e,t,n={}){let{includeFields:r,excludeFields:i=[],maxDepth:s=2}=n;if(typeof t!=`object`||!t)return`_No data available_
+`;let l=a(e,r,i);if(l.length===0)return`_No fields to display_
+`;let u=[];for(let e of l){let n=c(o(t,e.name),s,0);u.push(`**${e.label}:** ${n}`)}return u.push(``),u.join(`
+`)}function i(e,t,n={}){let{numericFields:r=[],countByField:i}=n,a=[];a.push(`**Total Items:** ${t.length}`);for(let e of r){let n=t.map(t=>o(t,e)).filter(e=>typeof e==`number`);if(n.length>0){let t=n.reduce((e,t)=>e+t,0),r=t/n.length,i=Math.min(...n),o=Math.max(...n);a.push(`**${l(e)}:** Sum: ${u(t)}, Avg: ${u(r)}, Min: ${u(i)}, Max: ${u(o)}`)}}if(i){let e={};for(let n of t){let t=String(o(n,i)??`Unknown`);e[t]=(e[t]??0)+1}a.push(``,`**By ${l(i)}:**`);for(let[t,n]of Object.entries(e))a.push(`- ${t}: ${n}`)}return a.push(``),a.join(`
+`)}function a(e,t,n=[]){let r=e.config.fields;return Object.keys(r).filter(e=>!(n.includes(e)||t&&!t.includes(e))).map(e=>{let t=r[e],n=!!(t?.type&&typeof t.type==`object`&&`config`in t.type&&typeof t.type.config?.fields==`object`);return{name:e,label:l(e),isOptional:t?.isOptional??!1,isArray:t?.isArray===!0,isNested:n}})}function o(e,t){if(typeof e!=`object`||!e)return;let n=e;if(t.includes(`.`)){let e=t.split(`.`),r=n;for(let t of e){if(typeof r!=`object`||!r)return;r=r[t]}return r}return n[t]}function s(e){if(e==null)return`-`;if(typeof e==`boolean`)return e?`✓`:`✗`;if(typeof e==`number`)return u(e);if(e instanceof Date)return d(e);if(typeof e==`string`&&f(e))return d(new Date(e));if(Array.isArray(e))return`[${e.length} items]`;if(typeof e==`object`)return`[Object]`;let t=String(e);return t.length>50?`${t.slice(0,47)}...`:t.replace(/\|/g,`\\|`)}function c(e,t,n){return e==null?`_none_`:typeof e==`boolean`?e?`Yes`:`No`:typeof e==`number`?u(e):e instanceof Date?d(e):typeof e==`string`&&f(e)?d(new Date(e)):Array.isArray(e)?e.length===0?`_empty list_`:n>=t?`[${e.length} items]`:e.length<=5&&e.every(e=>typeof e!=`object`)?e.map(e=>s(e)).join(`, `):`[${e.length} items]`:typeof e==`object`?n>=t?`[Object]`:`{${Object.keys(e).length} fields}`:String(e)}function l(e){return e.replace(/([a-z])([A-Z])/g,`$1 $2`).replace(/_/g,` `).replace(/^\w/,e=>e.toUpperCase())}function u(e){return Math.abs(e)>=1e3?new Intl.NumberFormat(`en-US`,{maximumFractionDigits:2}).format(e):Number.isInteger(e)?String(e):e.toFixed(2)}function d(e){return e.toLocaleDateString(`en-US`,{year:`numeric`,month:`short`,day:`numeric`})}function f(e){if(!/^\d{4}-\d{2}-\d{2}/.test(e))return!1;let t=new Date(e);return!isNaN(t.getTime())}export{e as schemaToMarkdown,r as schemaToMarkdownDetail,n as schemaToMarkdownList,i as schemaToMarkdownSummary,t as schemaToMarkdownTable};

package/dist/server/graphql-pothos.js

@@ -1 +1 @@
-import{hydrateResourceIfNeeded as e,parseReturns as t}from"../contracts-adapter-hydration.js";import{createInputTypeBuilder as n}from"../contracts-adapter-input.js";import{defaultGqlField as r}from"../jsonschema.js";import"@pothos/plugin-prisma";import"@pothos/plugin-complexity";import"@pothos/plugin-relay";import"@pothos/plugin-dataloader";import"@pothos/plugin-tracing";function i(i,a,o){let{buildInputFieldArgs:s}=n(i),c=new Map;for(let e of a.listSpecs()){let t=e.io.output;if(t&&`getZod`in t&&typeof t.getZod==`function`){let e=t,n=e.config?.name??`UnknownOutput`;c.has(n)||c.set(n,e)}}for(let[e,t]of c.entries())i.objectType(e,{fields:e=>{let n=Object.entries(t.config.fields),r={};for(let[t,i]of n){let n=i.type,a=`JSON`;n&&typeof n.getPothos==`function`&&(a=n.getPothos().name||`JSON`,a===`String_unsecure`&&(a=`String`),a===`Int_unsecure`&&(a=`Int`),a===`Float_unsecure`&&(a=`Float`),a===`Boolean_unsecure`&&(a=`Boolean`),a===`ID_unsecure`&&(a=`ID`));let o=i.isArray?[a]:a;r[t]=e.field({type:o,nullable:i.isOptional,resolve:e=>e[t]})}return r}});function l(e){let t=e.transport?.gql?.returns;if(t)return t;let n=e.io.output??{};if(n&&`kind`in n&&n.kind===`resource_ref`&&`graphQLType`in n&&n.graphQLType)return String(n.graphQLType);if(n&&`getZod`in n&&typeof n.getZod==`function`){let e=n.config?.name;if(e&&c.has(e))return e}return`JSON`}for(let n of a.listSpecs()){let c=n.transport?.gql?.field??r(n.meta.name,n.meta.version);n.transport?.gql?.returns;let u=n.transport?.gql?.byIdField??`id`,d=n.transport?.gql?.resource,f=n.meta.kind===`query`,p=l(n),m=n.transport?.gql?.returns,h=t(m??p),g=async(t,r,i)=>{if(n.policy.auth!==`anonymous`&&!i.user)throw Error(`Unauthorized`);let s={traceId:i.logger?.getTraceId?.()??void 0,userId:i.user?.id??null,organizationId:i.session?.activeOrganizationId??null,actor:i.user?`user`:`anonymous`,channel:`web`,eventPublisher:i.eventPublisher},c=n.io.input?.getZod().parse(r.input??{}),l=await a.execute(n.meta.name,n.meta.version,c,s),f=n.io.output;if(o&&(d||f?.kind===`resource_ref`)){let t=u??f?.varName??`id`,n=await e(o,l,{template:d??f?.uriTemplate,varName:t,returns:h});if(n!==l)return n}return p?h.inner===`Boolean`&&!h.isList?!!(l?.ok??l):l:n.io.output.getZod().parse(l)},_=e=>{let t=s(n.io.input);return e.field({type:h.isList?[h.inner]:h.inner,complexity:()=>10,resolve:g,args:t?{input:e.arg({type:t,required:!0})}:void 0})};f?i.queryField(c,_):i.mutationField(c,_)}}export{i as registerContractsOnBuilder};
+import{hydrateResourceIfNeeded as e,parseReturns as t}from"../contracts-adapter-hydration.js";import{createInputTypeBuilder as n}from"../contracts-adapter-input.js";import{defaultGqlField as r}from"../jsonschema.js";import"../node_modules/@pothos/plugin-prisma/esm/index.js";import"../node_modules/@pothos/plugin-complexity/esm/index.js";import"../node_modules/@pothos/plugin-dataloader/esm/index.js";import"../node_modules/@pothos/plugin-tracing/esm/index.js";import"@pothos/plugin-relay";function i(i,a,o){let{buildInputFieldArgs:s}=n(i),c=new Map;for(let e of a.listSpecs()){let t=e.io.output;if(t&&`getZod`in t&&typeof t.getZod==`function`){let e=t,n=e.config?.name??`UnknownOutput`;c.has(n)||c.set(n,e)}}for(let[e,t]of c.entries())i.objectType(e,{fields:e=>{let n=Object.entries(t.config.fields),r={};for(let[t,i]of n){let n=i.type,a=`JSON`;n&&typeof n.getPothos==`function`&&(a=n.getPothos().name||`JSON`,a===`String_unsecure`&&(a=`String`),a===`Int_unsecure`&&(a=`Int`),a===`Float_unsecure`&&(a=`Float`),a===`Boolean_unsecure`&&(a=`Boolean`),a===`ID_unsecure`&&(a=`ID`));let o=i.isArray?[a]:a;r[t]=e.field({type:o,nullable:i.isOptional,resolve:e=>e[t]})}return r}});function l(e){let t=e.transport?.gql?.returns;if(t)return t;let n=e.io.output??{};if(n&&`kind`in n&&n.kind===`resource_ref`&&`graphQLType`in n&&n.graphQLType)return String(n.graphQLType);if(n&&`getZod`in n&&typeof n.getZod==`function`){let e=n.config?.name;if(e&&c.has(e))return e}return`JSON`}for(let n of a.listSpecs()){let c=n.transport?.gql?.field??r(n.meta.name,n.meta.version);n.transport?.gql?.returns;let u=n.transport?.gql?.byIdField??`id`,d=n.transport?.gql?.resource,f=n.meta.kind===`query`,p=l(n),m=n.transport?.gql?.returns,h=t(m??p),g=async(t,r,i)=>{if(n.policy.auth!==`anonymous`&&!i.user)throw Error(`Unauthorized`);let s={traceId:i.logger?.getTraceId?.()??void 0,userId:i.user?.id??null,organizationId:i.session?.activeOrganizationId??null,actor:i.user?`user`:`anonymous`,channel:`web`,eventPublisher:i.eventPublisher},c=n.io.input?.getZod().parse(r.input??{}),l=await a.execute(n.meta.name,n.meta.version,c,s),f=n.io.output;if(o&&(d||f?.kind===`resource_ref`)){let t=u??f?.varName??`id`,n=await e(o,l,{template:d??f?.uriTemplate,varName:t,returns:h});if(n!==l)return n}return p?h.inner===`Boolean`&&!h.isList?!!(l?.ok??l):l:n.io.output.getZod().parse(l)},_=e=>{let t=s(n.io.input);return e.field({type:h.isList?[h.inner]:h.inner,complexity:()=>10,resolve:g,args:t?{input:e.arg({type:t,required:!0})}:void 0})};f?i.queryField(c,_):i.mutationField(c,_)}}export{i as registerContractsOnBuilder};

package/dist/server/index.js

@@ -1 +1 @@
-import{registerContractsOnBuilder as e}from"./graphql-pothos.js";import{exportContractsToGraphQLSchema as t}from"./graphql-schema-export.js";import{createMcpServer as n}from"./provider-mcp.js";import{createFetchHandler as r}from"./rest-generic.js";import{elysiaPlugin as i}from"./rest-elysia.js";import{expressRouter as a}from"./rest-express.js";import{makeNextAppHandler as o}from"./rest-next-app.js";import{makeNextPagesHandler as s}from"./rest-next-pages.js";export{r as createFetchHandler,n as createMcpServer,i as elysiaPlugin,t as exportContractsToGraphQLSchema,a as expressRouter,o as makeNextAppHandler,s as makeNextPagesHandler,e as registerContractsOnBuilder};
+import{registerContractsOnBuilder as e}from"./graphql-pothos.js";import{createMcpServer as t}from"./mcp/createMcpServer.js";import"./provider-mcp.js";import{createFetchHandler as n}from"./rest-generic.js";import{elysiaPlugin as r}from"./rest-elysia.js";import{expressRouter as i}from"./rest-express.js";import{makeNextAppHandler as a}from"./rest-next-app.js";import{makeNextPagesHandler as o}from"./rest-next-pages.js";export{n as createFetchHandler,t as createMcpServer,r as elysiaPlugin,i as expressRouter,a as makeNextAppHandler,o as makeNextPagesHandler,e as registerContractsOnBuilder};

package/dist/server/mcp/createMcpServer.js

@@ -0,0 +1 @@
+import{registerMcpTools as e}from"./registerTools.js";import{registerMcpResources as t}from"./registerResources.js";import{registerMcpPrompts as n}from"./registerPrompts.js";import{registerMcpPresentations as r}from"./registerPresentations.js";function i(i,a,o,s,c){return c.logger.info(`Creating MCP server`),e(i,a,{toolCtx:c.toolCtx}),t(i,o,{logger:c.logger,resourceCtx:c.resourceCtx}),r(i,{logger:c.logger,presentations:c.presentations,presentationsV2:c.presentationsV2}),n(i,s,{promptCtx:c.promptCtx}),i}export{i as createMcpServer};

package/dist/server/mcp/registerPresentations.js

@@ -0,0 +1 @@
+import{createDefaultTransformEngine as e,registerBasicValidation as t,registerDefaultReactRenderer as n}from"../../presentations.v2.js";import{jsonSchemaForPresentation as r}from"../../presentations.js";function i(e){return!e||typeof e!=`object`?!1:`body`in e&&typeof e.body==`string`}function a(a,o){let s=o.presentations,c=o.presentationsV2;if(s)for(let e of s.list()){let t=`presentation.${e.meta.name.replace(/\./g,`_`)}.v${e.meta.version}`,n=`presentation://${e.meta.name}/v${e.meta.version}`;a.registerResource(t,n,{title:`${e.meta.name} v${e.meta.version}`,description:e.meta.description??`Presentation`},async()=>{if(e.content.kind===`markdown`)return{contents:[{uri:n,mimeType:`text/markdown`,text:e.content.content?e.content.content:`See resource: ${e.content.resourceUri??``}`}]};if(e.content.kind===`data`){let t=r(e);return{contents:[{uri:n,mimeType:`application/json`,text:JSON.stringify(t,null,2)}]}}let t={name:e.meta.name,version:e.meta.version,kind:e.content.kind,description:e.meta.description??``};return{contents:[{uri:n,mimeType:`application/json`,text:JSON.stringify(t,null,2)}]}});for(let i of[{ext:`.md`,target:`markdown`},{ext:`.json`,target:`application/json`},{ext:`.xml`,target:`application/xml`}]){let s=`${t}${i.ext}`,c=`${n}${i.ext}`;o.logger.info(`Registering presentation resource ${c} for ${s}`),a.registerResource(s,c,{title:`${e.meta.name} v${e.meta.version} (${i.ext})`,description:`${e.meta.description??`Presentation`} (${i.ext})`},async()=>{if(e.content.kind===`markdown`&&i.target===`markdown`)return{contents:[{uri:c,mimeType:`text/markdown`,text:e.content.content??`See resource: ${e.content.resourceUri??``}`}]};if(e.content.kind===`data`&&i.target===`application/json`)return{contents:[{uri:c,mimeType:`application/json`,text:JSON.stringify(r(e),null,2)}]};let t=JSON.stringify({meta:e.meta,content:e.content},null,2);return i.target===`application/json`?{contents:[{uri:c,mimeType:`application/json`,text:t}]}:i.target===`application/xml`?{contents:[{uri:c,mimeType:`application/xml`,text:`<presentation name="${e.meta.name}" version="${e.meta.version}"><json>${encodeURIComponent(t)}</json></presentation>`}]}:{contents:[{uri:c,mimeType:`text/markdown`,text:`Unsupported presentation for markdown`}]}})}}if(c&&c.length){let r=t(n(e()));for(let e of c){let t=`presentation.${e.meta.name.replace(/\./g,`_`)}.v${e.meta.version}`,n=`presentation://${e.meta.name}/v${e.meta.version}`;o.logger.info(`Registering presentation descriptor ${n} for ${t}`),a.registerResource(t,n,{title:`${e.meta.name} v${e.meta.version}`,description:e.meta.description??`Presentation`,mimeType:`application/json`},async()=>({contents:[{uri:n,mimeType:`application/json`,text:JSON.stringify({meta:e.meta,source:e.source,targets:e.targets},null,2)}]}));for(let o of[{ext:`.md`,target:`markdown`},{ext:`.json`,target:`application/json`},{ext:`.xml`,target:`application/xml`}]){let s=`${t}${o.ext}`,c=`${n}${o.ext}`;a.registerResource(s,c,{title:`${e.meta.name} v${e.meta.version} (${o.ext})`,description:`${e.meta.description??`Presentation`} (${o.ext})`},async()=>{let t=await r.render(o.target,e);return{contents:[{uri:c,mimeType:i(t)&&t.mimeType?t.mimeType:o.target===`markdown`?`text/markdown`:o.target,text:i(t)&&typeof t.body==`string`?t.body:String(t)}]}})}}}}export{a as registerMcpPresentations};

package/dist/server/mcp/registerPrompts.js

@@ -0,0 +1,3 @@
+import e from"zod";function t(e){let t={};for(let n of e)t[n.name]=n.schema;return t}function n(e,n,r){for(let i of n.list())e.registerPrompt(i.meta.name,{title:i.meta.title,description:i.meta.description,argsSchema:t(i.args)},async e=>{let t=(e,t)=>{let n=e;for(let[e,r]of Object.entries(t))n=n.replace(RegExp(`\\{${e}\\}`,`g`),encodeURIComponent(String(r)));return n};return{messages:[{role:`assistant`,content:{type:`text`,text:(await i.render(i.input.parse(e),{...r.promptCtx(),link:t})).map(e=>e.type===`text`?e.text:`See resource: ${e.title??e.uri}\nURI: ${e.uri}`).join(`
+
+`)}}],description:i.meta.description}})}export{n as registerMcpPrompts};

package/dist/server/mcp/registerResources.js

@@ -0,0 +1 @@
+import{ResourceTemplate as e}from"@modelcontextprotocol/sdk/server/mcp.js";import{Buffer as t}from"node:buffer";function n(e){return{title:e.meta.title,description:e.meta.description,mimeType:e.meta.mimeType,_meta:{tags:e.meta.tags??[]}}}function r(r,i,a){for(let o of i.listTemplates())a.logger.info(`Registering resource: `+o.meta.uriTemplate),r.registerResource(o.meta.uriTemplate,new e(o.meta.uriTemplate,{list:void 0}),n(o),async(e,n)=>{let r=o.input.parse(n),i=await o.resolve(r,a.resourceCtx());return typeof i.data==`string`?{contents:[{uri:i.uri,mimeType:i.mimeType??o.meta.mimeType,text:i.data}]}:{contents:[{uri:i.uri,mimeType:i.mimeType??o.meta.mimeType,blob:t.from(i.data).toString(`base64`)}]}}),a.logger.info(`Registered resource: `+o.meta.uriTemplate)}export{r as registerMcpResources};

package/dist/server/mcp/registerTools.js

@@ -0,0 +1 @@
+import{defaultMcpTool as e}from"../../jsonschema.js";function t(t,n,r){for(let i of n.listSpecs()){if(i.meta.kind!==`command`)continue;let a=i.transport?.mcp?.toolName??e(i.meta.name,i.meta.version);t.registerTool(a,{description:i.meta.description,inputSchema:i.io.input?.getZod()},async e=>{let t=await n.execute(i.meta.name,i.meta.version,e??{},r.toolCtx());return{content:[{type:`text`,text:JSON.stringify(t,null,4)}]}})}}export{t as registerMcpTools};

package/dist/server/provider-mcp.js

@@ -1 +1 @@
-import{createDefaultTransformEngine as e,registerBasicValidation as t,registerDefaultReactRenderer as n}from"../presentations.v2.js";import{defaultMcpTool as r,jsonSchemaForSpec as i}from"../jsonschema.js";import{jsonSchemaForPresentation as a}from"../presentations.js";import o from"zod";import{McpServer as s,ResourceTemplate as c}from"@modelcontextprotocol/sdk/server/mcp.js";import{zodToJsonSchema as l}from"zod-to-json-schema";function u(s,u,d,f,p){for(let e of u.listSpecs()){if(e.meta.kind!==`command`)continue;let{input:t}=i(e),n=e.transport?.mcp?.toolName??r(e.meta.name,e.meta.version);s.registerTool(n,{description:e.meta.description,inputSchema:t},async(t,n)=>{let r=await u.execute(e.meta.name,e.meta.version,t??{},p.toolCtx());return{content:[{type:`text`,text:JSON.stringify(r,null,4)}]}})}for(let e of d.listTemplates())s.registerResource(e.meta.uriTemplate.split(`:`)[0],new c(e.meta.uriTemplate,{}),{description:e.meta.description,inputSchema:l(e.input,{})},async(t,n,r)=>{let i=p.resourceCtx(),a=await e.resolve(n,i);return typeof a.data==`string`?{contents:[{uri:a.uri,mimeType:a.mimeType??e.meta.mimeType,text:a.data}]}:{contents:[{uri:a.uri,mimeType:a.mimeType??e.meta.mimeType,blob:a.data.toString()}]}});let m=p.presentations,h=p.presentationsV2;if(m){t(n(e()));for(let e of m.list()){let t=`presentation.${e.meta.name.replace(/\./g,`_`)}.v${e.meta.version}`,n=`presentation://${e.meta.name}/v${e.meta.version}`;s.registerResource(t,new c(n,{}),{description:e.meta.description??`Presentation`,inputSchema:o.toJSONSchema(o.object({}))},async(t,r,i)=>{if(e.content.kind===`markdown`)return{contents:[{uri:n,mimeType:`text/markdown`,text:e.content.content?e.content.content:`See resource: ${e.content.resourceUri??``}`}]};if(e.content.kind===`data`){let t=a(e);return{contents:[{uri:n,mimeType:`application/json`,text:JSON.stringify(t,null,2)}]}}let o={name:e.meta.name,version:e.meta.version,kind:e.content.kind,description:e.meta.description??``};return{contents:[{uri:n,mimeType:`application/json`,text:JSON.stringify(o,null,2)}]}});for(let r of[{ext:`.md`,target:`markdown`},{ext:`.json`,target:`application/json`},{ext:`.xml`,target:`application/xml`}]){let i=`${t}${r.ext}`,l=`${n}${r.ext}`;s.registerResource(i,new c(l,{}),{description:`${e.meta.description??`Presentation`} (${r.ext})`,inputSchema:o.toJSONSchema(o.object({}))},async()=>{if(e.content.kind===`markdown`&&r.target===`markdown`)return{contents:[{uri:l,mimeType:`text/markdown`,text:e.content.content??`See resource: ${e.content.resourceUri??``}`}]};if(e.content.kind===`data`&&r.target===`application/json`)return{contents:[{uri:l,mimeType:`application/json`,text:JSON.stringify(a(e),null,2)}]};let t=JSON.stringify({meta:e.meta,content:e.content},null,2);return r.target===`application/json`?{contents:[{uri:l,mimeType:`application/json`,text:t}]}:r.target===`application/xml`?{contents:[{uri:l,mimeType:`application/xml`,text:`<presentation name="${e.meta.name}" version="${e.meta.version}"><json>${encodeURIComponent(t)}</json></presentation>`}]}:{contents:[{uri:l,mimeType:`text/markdown`,text:`Unsupported presentation for markdown`}]}})}}}if(h&&h.length){let r=t(n(e()));for(let e of h){let t=`presentation.${e.meta.name.replace(/\./g,`_`)}.v${e.meta.version}`,n=`presentation://${e.meta.name}/v${e.meta.version}`;s.registerResource(t,new c(n,{}),{description:e.meta.description??`Presentation`,inputSchema:o.toJSONSchema(o.object({}))},async()=>({contents:[{uri:n,mimeType:`application/json`,text:JSON.stringify({meta:e.meta,source:e.source,targets:e.targets},null,2)}]}));for(let i of[{ext:`.md`,target:`markdown`},{ext:`.json`,target:`application/json`},{ext:`.xml`,target:`application/xml`}]){let a=`${t}${i.ext}`,l=`${n}${i.ext}`;s.registerResource(a,new c(l,{}),{description:`${e.meta.description??`Presentation`} (${i.ext})`,inputSchema:o.toJSONSchema(o.object({}))},async()=>{let t=await r.render(i.target,e);return{contents:[{uri:l,mimeType:t.mimeType??(i.target===`markdown`?`text/markdown`:i.target),text:t.body??String(t)}]}})}}}for(let e of f.list())s.registerPrompt(e.meta.name,{title:e.meta.title,description:e.meta.title,argsSchema:l(e.input)},async(t,n)=>{let r=(e,t)=>{let n=e;for(let[e,r]of Object.entries(t))n=n.replace(RegExp(`\\{${e}\\}`,`g`),encodeURIComponent(String(r)));return n};return{messages:[{role:`assistant`,content:(await e.render(e.input.parse(t),{...p.promptCtx(),link:r})).map(e=>e.type===`text`?{type:`text`,text:e.text}:{type:`text`,text:`See resource: ${e.title??e.uri}\nURI: ${e.uri}`})[0]}],description:e.meta.description}});return s}export{u as createMcpServer};
+import{createMcpServer as e}from"./mcp/createMcpServer.js";export{e as createMcpServer};

package/dist/telemetry/docs/telemetry.docblock.js

@@ -0,0 +1,139 @@
+import{registerDocBlocks as e}from"../../docs/registry.js";import"../../registry.js";const t=[{id:`docs.tech.contracts.telemetry`,title:`TelemetrySpec`,summary:"Telemetry specs describe product analytics in a durable, type-safe way. They reference existing `EventSpec`s (same name/version) but layer on privacy classification, retention, sampling, and anomaly detection so instrumentation stays compliant and observable.",kind:`reference`,visibility:`public`,route:`/docs/tech/contracts/telemetry`,tags:[`tech`,`contracts`,`telemetry`],body:`## TelemetrySpec
+
+Telemetry specs describe product analytics in a durable, type-safe way. They reference existing \`EventSpec\`s (same name/version) but layer on privacy classification, retention, sampling, and anomaly detection so instrumentation stays compliant and observable.
+
+- **File location**: \`packages/libs/contracts/src/telemetry/spec.ts\`
+- **Runtime tracker**: \`packages/libs/contracts/src/telemetry/tracker.ts\`
+- **Anomaly monitor**: \`packages/libs/contracts/src/telemetry/anomaly.ts\`
+
+### Core concepts
+
+\`\`\`ts
+export interface TelemetrySpec {
+  meta: TelemetryMeta;
+  events: TelemetryEventDef[];
+  config?: TelemetryConfig;
+}
+\`\`\`
+
+- \`meta\`: ownership + identifiers (\`name\`, \`version\`, \`domain\`)
+- \`events\`: per-event semantics, property definitions, privacy level, retention, sampling, anomaly rules
+- \`config\`: defaults and provider configuration
+- \`TelemetryRegistry\`: registers specs, resolves latest version, finds event definitions by name/version
+
+### An example
+
+\`\`\`ts
+export const SigilTelemetry: TelemetrySpec = {
+  meta: {
+    name: 'sigil.telemetry',
+    version: 1,
+    title: 'Sigil telemetry',
+    description: 'Core Sigil product telemetry',
+    domain: 'sigil',
+    owners: ['@team.analytics'],
+    tags: ['telemetry'],
+    stability: StabilityEnum.Experimental,
+  },
+  config: {
+    defaultRetentionDays: 30,
+    defaultSamplingRate: 1,
+    providers: [
+      { type: 'posthog', config: { projectApiKey: process.env.POSTHOG_KEY } },
+    ],
+  },
+  events: [
+    {
+      name: 'sigil.telemetry.workflow_step',
+      version: 1,
+      semantics: {
+        what: 'Workflow step executed',
+        who: 'Actor executing the workflow',
+      },
+      privacy: 'internal',
+      properties: {
+        workflow: { type: 'string', required: true },
+        step: { type: 'string', required: true },
+        durationMs: { type: 'number' },
+        userId: { type: 'string', pii: true, redact: true },
+      },
+      anomalyDetection: {
+        enabled: true,
+        minimumSample: 10,
+        thresholds: [
+          { metric: 'durationMs', max: 1500 },
+        ],
+        actions: ['alert', 'trigger_regen'],
+      },
+    },
+  ],
+};
+\`\`\`
+
+### Tracking events at runtime
+
+\`TelemetryTracker\` performs sampling, PII redaction, provider dispatch, and anomaly detection.
+
+\`\`\`ts
+const tracker = new TelemetryTracker({
+  registry: telemetryRegistry,
+  providers: [
+    {
+      id: 'posthog',
+      async send(dispatch) {
+        posthog.capture({
+          event: dispatch.name,
+          properties: dispatch.properties,
+          distinctId: dispatch.context.userId ?? dispatch.context.sessionId,
+        });
+      },
+    },
+  ],
+  anomalyMonitor: new TelemetryAnomalyMonitor({
+    onAnomaly(event) {
+      console.warn('Telemetry anomaly detected', event);
+    },
+  }),
+});
+
+await tracker.track('sigil.telemetry.workflow_step', 1, {
+  workflow: 'onboarding',
+  step: 'verify_email',
+  durationMs: 2100,
+  userId: 'user-123',
+});
+\`\`\`
+
+- Sampling obeys the event-specific rate (fallback to spec defaults)
+- Properties flagged with \`pii\` or \`redact\` are masked before dispatch
+- Anomaly monitor evaluates thresholds and triggers actions (e.g., log, alert, regeneration)
+
+### Spec integration
+
+- \`ContractSpec.telemetry\` allows operations to emit success/failure events automatically
+- \`SpecRegistry.execute()\` uses the tracker when \`ctx.telemetry\` is provided
+- \`WorkflowRunner\` (Phase 4 follow-up) will emit telemetry during step transitions
+- \`TelemetrySpec\` events should reuse \`EventSpec\` names/versions to keep analytics/contract parity
+
+### CLI workflow
+
+\`\`\`
+contracts-cli create telemetry
+\`\`\`
+
+- Interactive wizard prompts for meta, providers, events, properties, retention, anomaly rules
+- Output: \`*.telemetry.ts\` file using \`TelemetrySpec\`
+
+### Best practices
+
+- Prefer \`internal\` privacy for non-PII; mark PII properties explicitly with \`pii\` + \`redact\`
+- Keep sampling ≥0.05 except for high-volume events
+- Configure anomaly detection on key metrics (duration, error count, conversion)
+- Check telemetry into source control alongside contracts; regenerate via CLI when specs change
+
+### Next steps
+
+- Phase 5: Regenerator monitors telemetry anomalies to propose spec improvements
+- Phase 6: Studio surfaces telemetry controls per tenant via \`TenantAppConfig\`
+
+`}];e(t);export{t as tech_contracts_telemetry_DocBlocks};