@lssm/lib.contracts 0.0.0-canary-20251217080011 → 0.0.0-canary-20251219202229

package/dist/schema-to-markdown.js

@@ -211,4 +211,5 @@ function isISODate(str) {
 }
 
 //#endregion
-export { schemaToMarkdown, schemaToMarkdownDetail, schemaToMarkdownList, schemaToMarkdownSummary, schemaToMarkdownTable };
+export { schemaToMarkdown, schemaToMarkdownDetail, schemaToMarkdownList, schemaToMarkdownSummary, schemaToMarkdownTable };
+//# sourceMappingURL=schema-to-markdown.js.map

package/dist/schema-to-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-to-markdown.js","names":["lines: string[]","counts: Record<string, number>","current: unknown"],"sources":["../src/schema-to-markdown.ts"],"sourcesContent":["/**\n * Schema-to-Markdown Utilities\n *\n * Generate markdown from SchemaModel definitions and data.\n * Provides automatic table, list, and detail view generation\n * based on schema field introspection.\n */\nimport type { AnySchemaModel, SchemaFieldConfig } from '@lssm/lib.schema';\n\n/**\n * Options for schema-to-markdown generation\n */\nexport interface SchemaMarkdownOptions {\n  /** Title for the markdown section */\n  title?: string;\n  /** Description to include below the title */\n  description?: string;\n  /** Output format: table for lists, list for simple items, detail for single objects */\n  format?: 'table' | 'list' | 'detail' | 'auto';\n  /** Maximum number of items to render (for arrays) */\n  maxItems?: number;\n  /** Only include these fields (if not specified, all fields are included) */\n  includeFields?: string[];\n  /** Exclude these fields from output */\n  excludeFields?: string[];\n  /** Custom field labels (field name -> display label) */\n  fieldLabels?: Record<string, string>;\n  /** Fields to use for summary in list format */\n  summaryFields?: string[];\n  /** Nesting depth for nested schemas (default: 2) */\n  maxDepth?: number;\n}\n\n/**\n * Internal type for field metadata used during rendering\n */\ninterface FieldMeta {\n  name: string;\n  label: string;\n  isOptional: boolean;\n  isArray: boolean;\n  isNested: boolean;\n}\n\n/**\n * Generate markdown from a SchemaModel and data.\n * Automatically detects array vs object data and formats accordingly.\n */\nexport function schemaToMarkdown(\n  schema: AnySchemaModel,\n  data: unknown,\n  options: SchemaMarkdownOptions = {}\n): string {\n  const { format = 'auto', title, description, maxDepth = 2 } = options;\n\n  const lines: string[] = [];\n\n  // Add title and description\n  if (title) {\n    lines.push(`# ${title}`, '');\n  }\n  if (description) {\n    lines.push(`> ${description}`, '');\n  }\n\n  // Determine format based on data type if auto\n  const effectiveFormat =\n    format === 'auto' ? (Array.isArray(data) ? 'table' : 'detail') : format;\n\n  // Generate content based on format\n  if (effectiveFormat === 'table' && Array.isArray(data)) {\n    lines.push(schemaToMarkdownTable(schema, data, options));\n  } else if (effectiveFormat === 'list' && Array.isArray(data)) {\n    lines.push(schemaToMarkdownList(schema, data, options));\n  } else if (\n    !Array.isArray(data) &&\n    data !== null &&\n    typeof data === 'object'\n  ) {\n    lines.push(schemaToMarkdownDetail(schema, data, { ...options, maxDepth }));\n  } else {\n    // Fallback for primitive or null data\n    lines.push(`**Data:** ${String(data)}`, '');\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Generate a markdown table from array data using schema fields as columns.\n */\nexport function schemaToMarkdownTable(\n  schema: AnySchemaModel,\n  items: unknown[],\n  options: SchemaMarkdownOptions = {}\n): string {\n  const { maxItems = 100, includeFields, excludeFields = [] } = options;\n\n  const fields = getFieldMeta(schema, includeFields, excludeFields);\n  if (fields.length === 0 || items.length === 0) {\n    return '_No data available_\\n';\n  }\n\n  const limitedItems = items.slice(0, maxItems);\n  const lines: string[] = [];\n\n  // Table header\n  const headers = fields.map((f) => f.label);\n  lines.push(`| ${headers.join(' | ')} |`);\n  lines.push(`| ${headers.map(() => '---').join(' | ')} |`);\n\n  // Table rows\n  for (const item of limitedItems) {\n    const row = fields.map((f) => formatCellValue(getFieldValue(item, f.name)));\n    lines.push(`| ${row.join(' | ')} |`);\n  }\n\n  // Add truncation notice if needed\n  if (items.length > maxItems) {\n    lines.push('', `_Showing ${maxItems} of ${items.length} items_`);\n  }\n\n  lines.push('');\n  return lines.join('\\n');\n}\n\n/**\n * Generate a markdown list from array data.\n * Uses summaryFields to create concise list items.\n */\nexport function schemaToMarkdownList(\n  schema: AnySchemaModel,\n  items: unknown[],\n  options: SchemaMarkdownOptions = {}\n): string {\n  const {\n    maxItems = 50,\n    summaryFields,\n    includeFields,\n    excludeFields = [],\n  } = options;\n\n  const fields = getFieldMeta(schema, includeFields, excludeFields);\n  const displayFields = summaryFields\n    ? fields.filter((f) => summaryFields.includes(f.name))\n    : fields.slice(0, 3); // Default to first 3 fields\n\n  if (displayFields.length === 0 || items.length === 0) {\n    return '_No data available_\\n';\n  }\n\n  const limitedItems = items.slice(0, maxItems);\n  const lines: string[] = [];\n\n  for (const item of limitedItems) {\n    const primaryValue = formatCellValue(\n      getFieldValue(item, displayFields[0]?.name ?? 'id')\n    );\n    const secondaryValues = displayFields\n      .slice(1)\n      .map((f) => `${f.label}: ${formatCellValue(getFieldValue(item, f.name))}`)\n      .join(' · ');\n\n    const itemLine = secondaryValues\n      ? `- **${primaryValue}** (${secondaryValues})`\n      : `- **${primaryValue}**`;\n    lines.push(itemLine);\n  }\n\n  // Add truncation notice if needed\n  if (items.length > maxItems) {\n    lines.push('', `_Showing ${maxItems} of ${items.length} items_`);\n  }\n\n  lines.push('');\n  return lines.join('\\n');\n}\n\n/**\n * Generate a markdown detail view (key-value pairs) from object data.\n */\nexport function schemaToMarkdownDetail(\n  schema: AnySchemaModel,\n  item: unknown,\n  options: SchemaMarkdownOptions = {}\n): string {\n  const { includeFields, excludeFields = [], maxDepth = 2 } = options;\n\n  if (item === null || typeof item !== 'object') {\n    return '_No data available_\\n';\n  }\n\n  const fields = getFieldMeta(schema, includeFields, excludeFields);\n  if (fields.length === 0) {\n    return '_No fields to display_\\n';\n  }\n\n  const lines: string[] = [];\n\n  for (const field of fields) {\n    const value = getFieldValue(item, field.name);\n    const formattedValue = formatDetailValue(value, maxDepth, 0);\n    lines.push(`**${field.label}:** ${formattedValue}`);\n  }\n\n  lines.push('');\n  return lines.join('\\n');\n}\n\n/**\n * Generate markdown summary statistics for numeric fields in array data.\n */\nexport function schemaToMarkdownSummary(\n  schema: AnySchemaModel,\n  items: unknown[],\n  options: { numericFields?: string[]; countByField?: string } = {}\n): string {\n  const { numericFields = [], countByField } = options;\n  const lines: string[] = [];\n\n  lines.push(`**Total Items:** ${items.length}`);\n\n  // Numeric field summaries\n  for (const fieldName of numericFields) {\n    const values = items\n      .map((item) => getFieldValue(item, fieldName))\n      .filter((v): v is number => typeof v === 'number');\n\n    if (values.length > 0) {\n      const sum = values.reduce((a, b) => a + b, 0);\n      const avg = sum / values.length;\n      const min = Math.min(...values);\n      const max = Math.max(...values);\n\n      lines.push(\n        `**${formatFieldName(fieldName)}:** Sum: ${formatNumber(sum)}, Avg: ${formatNumber(avg)}, Min: ${formatNumber(min)}, Max: ${formatNumber(max)}`\n      );\n    }\n  }\n\n  // Count by field\n  if (countByField) {\n    const counts: Record<string, number> = {};\n    for (const item of items) {\n      const value = String(getFieldValue(item, countByField) ?? 'Unknown');\n      counts[value] = (counts[value] ?? 0) + 1;\n    }\n\n    lines.push('', `**By ${formatFieldName(countByField)}:**`);\n    for (const [value, count] of Object.entries(counts)) {\n      lines.push(`- ${value}: ${count}`);\n    }\n  }\n\n  lines.push('');\n  return lines.join('\\n');\n}\n\n// ============ Helper Functions ============\n\n/**\n * Get field metadata from schema, applying include/exclude filters\n */\nfunction getFieldMeta(\n  schema: AnySchemaModel,\n  includeFields?: string[],\n  excludeFields: string[] = []\n): FieldMeta[] {\n  const schemaFields = schema.config.fields;\n  const fieldNames = Object.keys(schemaFields);\n\n  const filteredFields = fieldNames.filter((name) => {\n    if (excludeFields.includes(name)) return false;\n    if (includeFields && !includeFields.includes(name)) return false;\n    return true;\n  });\n\n  return filteredFields.map((name) => {\n    const fieldConfig = schemaFields[name] as SchemaFieldConfig | undefined;\n    const isNested = Boolean(\n      fieldConfig?.type &&\n      typeof fieldConfig.type === 'object' &&\n      'config' in fieldConfig.type &&\n      typeof (fieldConfig.type as { config?: { fields?: unknown } }).config\n        ?.fields === 'object'\n    );\n    return {\n      name,\n      label: formatFieldName(name),\n      isOptional: fieldConfig?.isOptional ?? false,\n      isArray: fieldConfig?.isArray === true,\n      isNested,\n    };\n  });\n}\n\n/**\n * Get value from object by field name (supports nested paths)\n */\nfunction getFieldValue(item: unknown, fieldName: string): unknown {\n  if (item === null || typeof item !== 'object') return undefined;\n  const obj = item as Record<string, unknown>;\n\n  // Support dot notation for nested fields\n  if (fieldName.includes('.')) {\n    const parts = fieldName.split('.');\n    let current: unknown = obj;\n    for (const part of parts) {\n      if (current === null || typeof current !== 'object') return undefined;\n      current = (current as Record<string, unknown>)[part];\n    }\n    return current;\n  }\n\n  return obj[fieldName];\n}\n\n/**\n * Format a value for table cell display\n */\nfunction formatCellValue(value: unknown): string {\n  if (value === null || value === undefined) return '-';\n  if (typeof value === 'boolean') return value ? '✓' : '✗';\n  if (typeof value === 'number') return formatNumber(value);\n  if (value instanceof Date) return formatDate(value);\n  if (typeof value === 'string' && isISODate(value))\n    return formatDate(new Date(value));\n  if (Array.isArray(value)) return `[${value.length} items]`;\n  if (typeof value === 'object') return '[Object]';\n\n  const str = String(value);\n  // Truncate long strings and escape pipe characters for tables\n  return str.length > 50 ? `${str.slice(0, 47)}...` : str.replace(/\\|/g, '\\\\|');\n}\n\n/**\n * Format a value for detail view (allows more space)\n */\nfunction formatDetailValue(\n  value: unknown,\n  maxDepth: number,\n  currentDepth: number\n): string {\n  if (value === null || value === undefined) return '_none_';\n  if (typeof value === 'boolean') return value ? 'Yes' : 'No';\n  if (typeof value === 'number') return formatNumber(value);\n  if (value instanceof Date) return formatDate(value);\n  if (typeof value === 'string' && isISODate(value))\n    return formatDate(new Date(value));\n\n  if (Array.isArray(value)) {\n    if (value.length === 0) return '_empty list_';\n    if (currentDepth >= maxDepth) return `[${value.length} items]`;\n\n    // For short arrays of primitives, inline them\n    if (value.length <= 5 && value.every((v) => typeof v !== 'object')) {\n      return value.map((v) => formatCellValue(v)).join(', ');\n    }\n    return `[${value.length} items]`;\n  }\n\n  if (typeof value === 'object') {\n    if (currentDepth >= maxDepth) return '[Object]';\n    // For simple objects, show key count\n    const keys = Object.keys(value);\n    return `{${keys.length} fields}`;\n  }\n\n  return String(value);\n}\n\n/**\n * Format field name to human-readable label\n */\nfunction formatFieldName(name: string): string {\n  return (\n    name\n      // Split on camelCase\n      .replace(/([a-z])([A-Z])/g, '$1 $2')\n      // Split on underscores\n      .replace(/_/g, ' ')\n      // Capitalize first letter\n      .replace(/^\\w/, (c) => c.toUpperCase())\n  );\n}\n\n/**\n * Format number with locale-aware formatting\n */\nfunction formatNumber(value: number): string {\n  // For currency-like values (large numbers), use formatting\n  if (Math.abs(value) >= 1000) {\n    return new Intl.NumberFormat('en-US', {\n      maximumFractionDigits: 2,\n    }).format(value);\n  }\n  // For small numbers, show more precision\n  if (Number.isInteger(value)) {\n    return String(value);\n  }\n  return value.toFixed(2);\n}\n\n/**\n * Format date to readable string\n */\nfunction formatDate(date: Date): string {\n  return date.toLocaleDateString('en-US', {\n    year: 'numeric',\n    month: 'short',\n    day: 'numeric',\n  });\n}\n\n/**\n * Check if string is ISO date format\n */\nfunction isISODate(str: string): boolean {\n  if (!/^\\d{4}-\\d{2}-\\d{2}/.test(str)) return false;\n  const date = new Date(str);\n  return !isNaN(date.getTime());\n}\n"],"mappings":"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"}

package/dist/server/graphql-pothos.d.ts

@@ -28,4 +28,5 @@ import { SchemaTypes } from "@pothos/core";
  */
 declare function registerContractsOnBuilder<T extends SchemaTypes>(builder: PothosSchemaTypes.SchemaBuilder<T>, reg: SpecRegistry, resources?: ResourceRegistry): void;
 //#endregion
-export { registerContractsOnBuilder };
+export { registerContractsOnBuilder };
+//# sourceMappingURL=graphql-pothos.d.ts.map

package/dist/server/graphql-pothos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-pothos.d.ts","names":[],"sources":["../../src/server/graphql-pothos.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;AAuCA;;;;;;;;;;;;;;;iBAAgB,qCAAqC,sBAC1C,iBAAA,CAAkB,cAAc,SACpC,0BACO"}

package/dist/server/graphql-pothos.js

@@ -125,4 +125,5 @@ function registerContractsOnBuilder(builder, reg, resources) {
 }
 
 //#endregion
-export { registerContractsOnBuilder };
+export { registerContractsOnBuilder };
+//# sourceMappingURL=graphql-pothos.js.map

package/dist/server/graphql-pothos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-pothos.js","names":["acc: Record<string, any>","handlerCtx: HandlerCtx","result: unknown","fieldSettingsFn: QueryFieldThunk<T> | MutationFieldThunk<T>"],"sources":["../../src/server/graphql-pothos.ts"],"sourcesContent":["import type {\n  MutationFieldThunk,\n  QueryFieldThunk,\n  SchemaTypes,\n} from '@pothos/core';\nimport type { HandlerCtx } from '../types';\nimport { defaultGqlField } from '../jsonschema';\nimport type { SpecRegistry } from '../registry';\nimport '@pothos/plugin-prisma';\nimport '@pothos/plugin-complexity';\nimport '@pothos/plugin-relay';\nimport '@pothos/plugin-dataloader';\nimport '@pothos/plugin-tracing';\nimport type { AnySchemaModel } from '@lssm/lib.schema';\nimport type { ResourceRefDescriptor, ResourceRegistry } from '../resources';\nimport { createInputTypeBuilder } from '../contracts-adapter-input';\nimport type { AnyContractSpec } from '../spec';\nimport {\n  hydrateResourceIfNeeded,\n  parseReturns,\n} from '../contracts-adapter-hydration';\n\n/**\n * Registers all ContractSpecs from a SpecRegistry onto a Pothos SchemaBuilder.\n *\n * This adapter:\n * 1. Discovers output types from specs and registers them as Pothos object types.\n * 2. Maps `ContractSpec` inputs to Pothos input types.\n * 3. Mounts `query` specs as `Query` fields and `command` specs as `Mutation` fields.\n * 4. Wraps the resolver to:\n *    - Enforce auth policies (basic check).\n *    - Build a `HandlerCtx`.\n *    - Execute via `SpecRegistry`.\n *    - Hydrate resource references if applicable.\n *\n * @param builder - The Pothos SchemaBuilder instance.\n * @param reg - The SpecRegistry containing operations.\n * @param resources - (Optional) ResourceRegistry for hydrating resource references.\n */\nexport function registerContractsOnBuilder<T extends SchemaTypes>(\n  builder: PothosSchemaTypes.SchemaBuilder<T>,\n  reg: SpecRegistry,\n  resources?: ResourceRegistry\n) {\n  const { buildInputFieldArgs } = createInputTypeBuilder(builder);\n\n  // Build a map of output types we need to register\n  const outputTypeCache = new Map<string, AnySchemaModel>();\n  for (const spec of reg.listSpecs()) {\n    const out = spec.io.output as\n      | AnySchemaModel\n      | ResourceRefDescriptor<boolean>;\n    if (out && 'getZod' in out && typeof out.getZod === 'function') {\n      const model = out as AnySchemaModel;\n      const typeName = model.config?.name ?? 'UnknownOutput';\n      if (!outputTypeCache.has(typeName)) {\n        outputTypeCache.set(typeName, model);\n      }\n    }\n  }\n\n  // Register all output types as GraphQL object types\n  for (const [typeName, model] of outputTypeCache.entries()) {\n    builder.objectType(typeName as any, {\n      fields: (t) => {\n        const entries = Object.entries(model.config.fields) as [\n          string,\n          {\n            type: any;\n            isOptional: boolean;\n            isArray?: boolean;\n          },\n        ][];\n        const acc: Record<string, any> = {};\n        for (const [key, field] of entries) {\n          const fieldType = field.type;\n          let gqlType = 'JSON';\n\n          // Check if it's a known scalar type\n          if (fieldType && typeof fieldType.getPothos === 'function') {\n            const pothosInfo = fieldType.getPothos();\n            gqlType = pothosInfo.name || 'JSON';\n            // Map unsecure types to their secure equivalents\n            if (gqlType === 'String_unsecure') gqlType = 'String';\n            if (gqlType === 'Int_unsecure') gqlType = 'Int';\n            if (gqlType === 'Float_unsecure') gqlType = 'Float';\n            if (gqlType === 'Boolean_unsecure') gqlType = 'Boolean';\n            if (gqlType === 'ID_unsecure') gqlType = 'ID';\n          }\n\n          const typeRef = field.isArray\n            ? ([gqlType] as never)\n            : (gqlType as never);\n          acc[key] = t.field({\n            type: typeRef,\n            nullable: field.isOptional,\n            resolve: (parent: any) => parent[key],\n          });\n        }\n        return acc as never;\n      },\n    });\n  }\n\n  // For outputs, prefer an explicit GraphQL type name; otherwise use SchemaModel name or resource ref\n  function resolveGraphQLTypeName(contractSpec: AnyContractSpec): string {\n    const returnsName = contractSpec.transport?.gql?.returns;\n    if (returnsName) return returnsName;\n\n    const out = contractSpec.io.output ?? {};\n\n    // Check if it's a resource ref\n    if (\n      out &&\n      'kind' in out &&\n      out.kind === 'resource_ref' &&\n      'graphQLType' in out &&\n      out.graphQLType\n    )\n      return String(out.graphQLType);\n\n    // Check if it's a SchemaModel with a name\n    if (out && 'getZod' in out && typeof out.getZod === 'function') {\n      const model = out as AnySchemaModel;\n      const typeName = model.config?.name;\n      if (typeName && outputTypeCache.has(typeName)) {\n        return typeName;\n      }\n    }\n\n    return 'JSON';\n  }\n\n  // parseReturns moved to hydration util\n\n  for (const spec of reg.listSpecs()) {\n    const fieldName =\n      spec.transport?.gql?.field ??\n      defaultGqlField(spec.meta.name, spec.meta.version);\n    const returnsName = spec.transport?.gql?.returns;\n    const byIdField =\n      (spec.transport as unknown as { gql?: { byIdField?: string } })?.gql\n        ?.byIdField ?? 'id';\n    const returnsResource = (\n      spec.transport as unknown as { gql?: { resource?: string } }\n    )?.gql?.resource;\n    const isQuery = spec.meta.kind === 'query';\n\n    const graphQLTypeName = resolveGraphQLTypeName(spec);\n    const returnsDecl = (\n      spec.transport as unknown as { gql?: { returns?: string } }\n    )?.gql?.returns;\n    const parsed = parseReturns(returnsDecl ?? graphQLTypeName);\n\n    const resolveFieldFn = async (_root: any, args: any, ctx: any) => {\n      if (spec.policy.auth !== 'anonymous' && !ctx.user)\n        throw new Error('Unauthorized');\n      const handlerCtx: HandlerCtx = {\n        traceId: ctx.logger?.getTraceId?.() ?? undefined,\n        userId: ctx.user?.id ?? null,\n        organizationId: ctx.session?.activeOrganizationId ?? null,\n        actor: ctx.user ? 'user' : 'anonymous',\n        channel: 'web',\n        eventPublisher: ctx.eventPublisher,\n      };\n      const parsedInput = spec.io.input?.getZod().parse(args.input ?? {});\n      const result: unknown = await reg.execute(\n        spec.meta.name,\n        spec.meta.version,\n        parsedInput,\n        handlerCtx\n      );\n      const out = spec.io.output as unknown;\n      if (\n        resources &&\n        (returnsResource || (out as { kind?: string })?.kind === 'resource_ref')\n      ) {\n        const varName =\n          byIdField ?? (out as { varName?: string })?.varName ?? 'id';\n        const template =\n          returnsResource ?? (out as { uriTemplate?: string })?.uriTemplate;\n        const hydrated = await hydrateResourceIfNeeded(resources, result, {\n          template,\n          varName,\n          returns: parsed,\n        });\n        if (hydrated !== result) return hydrated as never;\n      }\n      if (graphQLTypeName) {\n        if (parsed.inner === 'Boolean' && !parsed.isList)\n          return Boolean((result as { ok?: boolean })?.ok ?? result) as never;\n        // fallback to direct\n        return result as unknown as never;\n      }\n      const parsedOut: unknown = (spec.io.output as AnySchemaModel)\n        .getZod()\n        .parse(result);\n      return parsedOut as never;\n    };\n\n    const fieldSettingsFn: QueryFieldThunk<T> | MutationFieldThunk<T> = (\n      t: PothosSchemaTypes.MutationFieldBuilder<T, T['Root']>\n    ) => {\n      const inputType = buildInputFieldArgs(spec.io.input);\n      return t.field({\n        type: (parsed.isList ? [parsed.inner] : parsed.inner) as any,\n        complexity: () => 10,\n        resolve: resolveFieldFn as any,\n        args: inputType\n          ? {\n              input: t.arg({\n                type: inputType,\n                required: true,\n              }),\n            }\n          : undefined,\n      });\n    };\n\n    if (isQuery) {\n      builder.queryField(\n        fieldName,\n        fieldSettingsFn as never as QueryFieldThunk<T>\n      );\n    } else {\n      builder.mutationField(\n        fieldName,\n        fieldSettingsFn as MutationFieldThunk<T>\n      );\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/server/mcp/createMcpServer.d.ts

@@ -12,4 +12,5 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
  * ContractSpec exposes:\n+ * - Tools: `command` operations from `SpecRegistry`.\n+ * - Resources: templates from `ResourceRegistry`.\n+ * - Prompts: templates from `PromptRegistry`.\n+ * - Presentations: V1 registry and/or V2 descriptors as read-only resources.\n+ */
 declare function createMcpServer(server: McpServer, ops: SpecRegistry, resources: ResourceRegistry, prompts: PromptRegistry, ctxFactories: McpCtxFactories): McpServer;
 //#endregion
-export { createMcpServer };
+export { createMcpServer };
+//# sourceMappingURL=createMcpServer.d.ts.map

package/dist/server/mcp/createMcpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMcpServer.d.ts","names":[],"sources":["../../../src/server/mcp/createMcpServer.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAcA;;AAEO,iBAFS,eAAA,CAET,MAAA,EADG,SACH,EAAA,GAAA,EAAA,YAAA,EAAA,SAAA,EACM,gBADN,EAAA,OAAA,EAEI,cAFJ,EAAA,YAAA,EAGS,eAHT,CAAA,EAGwB,SAHxB"}

package/dist/server/mcp/createMcpServer.js

@@ -25,4 +25,5 @@ function createMcpServer(server, ops, resources, prompts, ctxFactories) {
 }
 
 //#endregion
-export { createMcpServer };
+export { createMcpServer };
+//# sourceMappingURL=createMcpServer.js.map

package/dist/server/mcp/createMcpServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMcpServer.js","names":[],"sources":["../../../src/server/mcp/createMcpServer.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { SpecRegistry } from '../../registry';\nimport type { ResourceRegistry } from '../../resources';\nimport type { PromptRegistry } from '../../promptRegistry';\nimport type { McpCtxFactories } from './mcpTypes';\nimport { registerMcpTools } from './registerTools';\nimport { registerMcpResources } from './registerResources';\nimport { registerMcpPrompts } from './registerPrompts';\nimport { registerMcpPresentations } from './registerPresentations';\n\n/**\n * Creates a unified Model Context Protocol (MCP) server exposing operations, resources, prompts,\n * and (optionally) presentations.\\n+ *\n * ContractSpec exposes:\\n+ * - Tools: `command` operations from `SpecRegistry`.\\n+ * - Resources: templates from `ResourceRegistry`.\\n+ * - Prompts: templates from `PromptRegistry`.\\n+ * - Presentations: V1 registry and/or V2 descriptors as read-only resources.\\n+ */\nexport function createMcpServer(\n  server: McpServer,\n  ops: SpecRegistry,\n  resources: ResourceRegistry,\n  prompts: PromptRegistry,\n  ctxFactories: McpCtxFactories\n) {\n  ctxFactories.logger.info('Creating MCP server');\n\n  registerMcpTools(server, ops, { toolCtx: ctxFactories.toolCtx });\n  registerMcpResources(server, resources, {\n    logger: ctxFactories.logger,\n    resourceCtx: ctxFactories.resourceCtx,\n  });\n  registerMcpPresentations(server, {\n    logger: ctxFactories.logger,\n    presentations: ctxFactories.presentations,\n    presentationsV2: ctxFactories.presentationsV2,\n  });\n  registerMcpPrompts(server, prompts, { promptCtx: ctxFactories.promptCtx });\n\n  return server;\n}\n"],"mappings":";;;;;;;;;;AAcA,SAAgB,gBACd,QACA,KACA,WACA,SACA,cACA;AACA,cAAa,OAAO,KAAK,sBAAsB;AAE/C,kBAAiB,QAAQ,KAAK,EAAE,SAAS,aAAa,SAAS,CAAC;AAChE,sBAAqB,QAAQ,WAAW;EACtC,QAAQ,aAAa;EACrB,aAAa,aAAa;EAC3B,CAAC;AACF,0BAAyB,QAAQ;EAC/B,QAAQ,aAAa;EACrB,eAAe,aAAa;EAC5B,iBAAiB,aAAa;EAC/B,CAAC;AACF,oBAAmB,QAAQ,SAAS,EAAE,WAAW,aAAa,WAAW,CAAC;AAE1E,QAAO"}

package/dist/server/mcp/mcpTypes.d.ts

@@ -26,4 +26,5 @@ interface McpCtxFactories {
   presentationsV2?: PresentationDescriptorV2[];
 }
 //#endregion
-export { McpCtxFactories };
+export { McpCtxFactories };
+//# sourceMappingURL=mcpTypes.d.ts.map

package/dist/server/mcp/mcpTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpTypes.d.ts","names":[],"sources":["../../../src/server/mcp/mcpTypes.ts"],"sourcesContent":[],"mappings":";;;;;;UAKiB,eAAA;UACP;EADO;EACP,OAAA,EAAA,GAAA,GAGO,UAHP;EAGO;EAiBC,SAAA,EAAA,GAAA,GAAA;IAEE,MAAA,CAAA,EAAA,MAAA,GAAA,IAAA;IAAwB,KAAA,CAAA,EAAA,MAAA,GAAA,IAAA;;;;;;;;;;kBAF1B;;oBAEE"}

package/dist/server/mcp/registerPresentations.d.ts

@@ -4,4 +4,5 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 //#region src/server/mcp/registerPresentations.d.ts
 declare function registerMcpPresentations(server: McpServer, ctx: Pick<McpCtxFactories, 'logger' | 'presentations' | 'presentationsV2'>): void;
 //#endregion
-export { registerMcpPresentations };
+export { registerMcpPresentations };
+//# sourceMappingURL=registerPresentations.d.ts.map

package/dist/server/mcp/registerPresentations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerPresentations.d.ts","names":[],"sources":["../../../src/server/mcp/registerPresentations.ts"],"sourcesContent":[],"mappings":";;;;iBAiBgB,wBAAA,SACN,gBACH,KAAK"}

package/dist/server/mcp/registerPresentations.js

@@ -148,4 +148,5 @@ function registerMcpPresentations(server, ctx) {
 }
 
 //#endregion
-export { registerMcpPresentations };
+export { registerMcpPresentations };
+//# sourceMappingURL=registerPresentations.js.map

package/dist/server/mcp/registerPresentations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerPresentations.js","names":[],"sources":["../../../src/server/mcp/registerPresentations.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { McpCtxFactories } from './mcpTypes';\nimport { jsonSchemaForPresentation } from '../../presentations';\nimport {\n  createDefaultTransformEngine,\n  registerBasicValidation,\n  registerDefaultReactRenderer,\n  type PresentationDescriptorV2,\n} from '../../presentations.v2';\n\nfunction isEngineRenderOutput(\n  x: unknown\n): x is { mimeType?: string; body: string } {\n  if (!x || typeof x !== 'object') return false;\n  return 'body' in x && typeof (x as { body?: unknown }).body === 'string';\n}\n\nexport function registerMcpPresentations(\n  server: McpServer,\n  ctx: Pick<McpCtxFactories, 'logger' | 'presentations' | 'presentationsV2'>\n) {\n  /* ---------- Presentations as resources (markdown/data) with content negotiation ---------- */\n  const __presentations = ctx.presentations;\n  const __presentationsV2 = ctx.presentationsV2;\n\n  if (__presentations) {\n    for (const p of __presentations.list()) {\n      const baseKey = `presentation.${p.meta.name.replace(/\\./g, '_')}.v${p.meta.version}`;\n      const baseUri = `presentation://${p.meta.name}/v${p.meta.version}`;\n\n      server.registerResource(\n        baseKey,\n        baseUri,\n        {\n          title: `${p.meta.name} v${p.meta.version}`,\n          description: p.meta.description ?? 'Presentation',\n        },\n        async () => {\n          if (p.content.kind === 'markdown') {\n            const text = p.content.content\n              ? p.content.content\n              : `See resource: ${p.content.resourceUri ?? ''}`;\n            return {\n              contents: [{ uri: baseUri, mimeType: 'text/markdown', text }],\n            };\n          }\n          if (p.content.kind === 'data') {\n            const schema = jsonSchemaForPresentation(p);\n            return {\n              contents: [\n                {\n                  uri: baseUri,\n                  mimeType: 'application/json',\n                  text: JSON.stringify(schema, null, 2),\n                },\n              ],\n            };\n          }\n          // web_component: metadata only for now\n          const metaOnly = {\n            name: p.meta.name,\n            version: p.meta.version,\n            kind: p.content.kind,\n            description: p.meta.description ?? '',\n          };\n          return {\n            contents: [\n              {\n                uri: baseUri,\n                mimeType: 'application/json',\n                text: JSON.stringify(metaOnly, null, 2),\n              },\n            ],\n          };\n        }\n      );\n\n      const variants: {\n        ext: string;\n        target: 'markdown' | 'application/json' | 'application/xml';\n      }[] = [\n        { ext: '.md', target: 'markdown' },\n        { ext: '.json', target: 'application/json' },\n        { ext: '.xml', target: 'application/xml' },\n      ];\n\n      for (const v of variants) {\n        const key = `${baseKey}${v.ext}`;\n        const uri = `${baseUri}${v.ext}`;\n\n        ctx.logger.info(`Registering presentation resource ${uri} for ${key}`);\n\n        server.registerResource(\n          key,\n          uri,\n          {\n            title: `${p.meta.name} v${p.meta.version} (${v.ext})`,\n            description: `${p.meta.description ?? 'Presentation'} (${v.ext})`,\n          },\n          async () => {\n            if (p.content.kind === 'markdown' && v.target === 'markdown') {\n              const text =\n                p.content.content ??\n                `See resource: ${p.content.resourceUri ?? ''}`;\n              return { contents: [{ uri, mimeType: 'text/markdown', text }] };\n            }\n\n            if (p.content.kind === 'data' && v.target === 'application/json') {\n              return {\n                contents: [\n                  {\n                    uri,\n                    mimeType: 'application/json',\n                    text: JSON.stringify(jsonSchemaForPresentation(p), null, 2),\n                  },\n                ],\n              };\n            }\n\n            const jsonText = JSON.stringify(\n              { meta: p.meta, content: p.content },\n              null,\n              2\n            );\n\n            if (v.target === 'application/json') {\n              return {\n                contents: [\n                  { uri, mimeType: 'application/json', text: jsonText },\n                ],\n              };\n            }\n\n            if (v.target === 'application/xml') {\n              const xml = `<presentation name=\"${p.meta.name}\" version=\"${p.meta.version}\"><json>${encodeURIComponent(\n                jsonText\n              )}</json></presentation>`;\n              return {\n                contents: [{ uri, mimeType: 'application/xml', text: xml }],\n              };\n            }\n\n            return {\n              contents: [\n                {\n                  uri,\n                  mimeType: 'text/markdown',\n                  text: 'Unsupported presentation for markdown',\n                },\n              ],\n            };\n          }\n        );\n      }\n    }\n  }\n\n  /* ---------- V2 presentations as resources (markdown/json/xml) ---------- */\n  if (__presentationsV2 && __presentationsV2.length) {\n    const engine = registerBasicValidation(\n      registerDefaultReactRenderer(createDefaultTransformEngine())\n    );\n\n    for (const d of __presentationsV2) {\n      const baseKey = `presentation.${d.meta.name.replace(/\\./g, '_')}.v${d.meta.version}`;\n      const baseUri = `presentation://${d.meta.name}/v${d.meta.version}`;\n\n      ctx.logger.info(\n        `Registering presentation descriptor ${baseUri} for ${baseKey}`\n      );\n\n      server.registerResource(\n        baseKey,\n        baseUri,\n        {\n          title: `${d.meta.name} v${d.meta.version}`,\n          description: d.meta.description ?? 'Presentation',\n          mimeType: 'application/json',\n        },\n        async () => {\n          const jsonText = JSON.stringify(\n            { meta: d.meta, source: d.source, targets: d.targets },\n            null,\n            2\n          );\n          return {\n            contents: [\n              {\n                uri: baseUri,\n                mimeType: 'application/json',\n                text: jsonText,\n              },\n            ],\n          };\n        }\n      );\n\n      const variants: {\n        ext: string;\n        target: 'markdown' | 'application/json' | 'application/xml';\n      }[] = [\n        { ext: '.md', target: 'markdown' },\n        { ext: '.json', target: 'application/json' },\n        { ext: '.xml', target: 'application/xml' },\n      ];\n\n      for (const v of variants) {\n        const key = `${baseKey}${v.ext}`;\n        const uri = `${baseUri}${v.ext}`;\n\n        server.registerResource(\n          key,\n          uri,\n          {\n            title: `${d.meta.name} v${d.meta.version} (${v.ext})`,\n            description: `${d.meta.description ?? 'Presentation'} (${v.ext})`,\n          },\n          async () => {\n            const out = await engine.render(v.target, d);\n            const mimeType =\n              isEngineRenderOutput(out) && out.mimeType\n                ? out.mimeType\n                : v.target === 'markdown'\n                  ? 'text/markdown'\n                  : v.target;\n            const text =\n              isEngineRenderOutput(out) && typeof out.body === 'string'\n                ? out.body\n                : String(out);\n            return { contents: [{ uri, mimeType, text }] };\n          }\n        );\n      }\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/server/mcp/registerPrompts.d.ts

@@ -5,4 +5,5 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 //#region src/server/mcp/registerPrompts.d.ts
 declare function registerMcpPrompts(server: McpServer, prompts: PromptRegistry, ctx: Pick<McpCtxFactories, 'promptCtx'>): void;
 //#endregion
-export { registerMcpPrompts };
+export { registerMcpPrompts };
+//# sourceMappingURL=registerPrompts.d.ts.map

package/dist/server/mcp/registerPrompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerPrompts.d.ts","names":[],"sources":["../../../src/server/mcp/registerPrompts.ts"],"sourcesContent":[],"mappings":";;;;;iBAegB,kBAAA,SACN,oBACC,qBACJ,KAAK"}

package/dist/server/mcp/registerPrompts.js

@@ -34,4 +34,5 @@ function registerMcpPrompts(server, prompts, ctx) {
 }
 
 //#endregion
-export { registerMcpPrompts };
+export { registerMcpPrompts };
+//# sourceMappingURL=registerPrompts.js.map

package/dist/server/mcp/registerPrompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerPrompts.js","names":["shape: Record<string, z.ZodType>"],"sources":["../../../src/server/mcp/registerPrompts.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { PromptRegistry } from '../../promptRegistry';\nimport type { McpCtxFactories } from './mcpTypes';\nimport type { GetPromptResult } from '@modelcontextprotocol/sdk/types.js';\nimport type { ZodRawShapeCompat } from '@modelcontextprotocol/sdk/server/zod-compat.js';\nimport z from 'zod';\n\nfunction promptArgsSchemaFromPromptArgs(\n  args: { name: string; schema: z.ZodType }[]\n): ZodRawShapeCompat {\n  const shape: Record<string, z.ZodType> = {};\n  for (const a of args) shape[a.name] = a.schema;\n  return shape as unknown as ZodRawShapeCompat;\n}\n\nexport function registerMcpPrompts(\n  server: McpServer,\n  prompts: PromptRegistry,\n  ctx: Pick<McpCtxFactories, 'promptCtx'>\n) {\n  for (const prompt of prompts.list()) {\n    server.registerPrompt(\n      prompt.meta.name,\n      {\n        title: prompt.meta.title,\n        description: prompt.meta.description,\n        // MCP SDK expects a \"raw shape\" of zod schemas (Record<string, ZodSchema>)\n        // rather than JSON Schema.\n        argsSchema: promptArgsSchemaFromPromptArgs(prompt.args),\n      },\n      async (args: unknown): Promise<GetPromptResult> => {\n        const link = (tpl: string, vars: Record<string, string | number>) => {\n          let out = tpl;\n          for (const [k, v] of Object.entries(vars))\n            out = out.replace(\n              new RegExp(`\\\\{${k}\\\\}`, 'g'),\n              encodeURIComponent(String(v))\n            );\n          return out;\n        };\n\n        const parts = await prompt.render(prompt.input.parse(args), {\n          ...ctx.promptCtx(),\n          link,\n        });\n\n        // MCP SDK types represent message content as a single content block.\n        // We keep a single assistant message and concatenate all parts as text.\n        const text = parts\n          .map((p) =>\n            p.type === 'text'\n              ? p.text\n              : `See resource: ${p.title ?? p.uri}\\nURI: ${p.uri}`\n          )\n          .join('\\n\\n');\n        const contents: GetPromptResult['messages'][number]['content'] = {\n          type: 'text',\n          text,\n        };\n\n        return {\n          messages: [{ role: 'assistant', content: contents }],\n          description: prompt.meta.description,\n        };\n      }\n    );\n  }\n}\n"],"mappings":";;;AAOA,SAAS,+BACP,MACmB;CACnB,MAAMA,QAAmC,EAAE;AAC3C,MAAK,MAAM,KAAK,KAAM,OAAM,EAAE,QAAQ,EAAE;AACxC,QAAO;;AAGT,SAAgB,mBACd,QACA,SACA,KACA;AACA,MAAK,MAAM,UAAU,QAAQ,MAAM,CACjC,QAAO,eACL,OAAO,KAAK,MACZ;EACE,OAAO,OAAO,KAAK;EACnB,aAAa,OAAO,KAAK;EAGzB,YAAY,+BAA+B,OAAO,KAAK;EACxD,EACD,OAAO,SAA4C;EACjD,MAAM,QAAQ,KAAa,SAA0C;GACnE,IAAI,MAAM;AACV,QAAK,MAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,KAAK,CACvC,OAAM,IAAI,QACR,IAAI,OAAO,MAAM,EAAE,MAAM,IAAI,EAC7B,mBAAmB,OAAO,EAAE,CAAC,CAC9B;AACH,UAAO;;AAsBT,SAAO;GACL,UAAU,CAAC;IAAE,MAAM;IAAa,SAN+B;KAC/D,MAAM;KACN,OAhBY,MAAM,OAAO,OAAO,OAAO,MAAM,MAAM,KAAK,EAAE;MAC1D,GAAG,IAAI,WAAW;MAClB;MACD,CAAC,EAKC,KAAK,MACJ,EAAE,SAAS,SACP,EAAE,OACF,iBAAiB,EAAE,SAAS,EAAE,IAAI,SAAS,EAAE,MAClD,CACA,KAAK,OAAO;KAId;IAGoD,CAAC;GACpD,aAAa,OAAO,KAAK;GAC1B;GAEJ"}

package/dist/server/mcp/registerResources.d.ts

@@ -5,4 +5,5 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 //#region src/server/mcp/registerResources.d.ts
 declare function registerMcpResources(server: McpServer, resources: ResourceRegistry, ctx: Pick<McpCtxFactories, 'logger' | 'resourceCtx'>): void;
 //#endregion
-export { registerMcpResources };
+export { registerMcpResources };
+//# sourceMappingURL=registerResources.d.ts.map

package/dist/server/mcp/registerResources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerResources.d.ts","names":[],"sources":["../../../src/server/mcp/registerResources.ts"],"sourcesContent":[],"mappings":";;;;;iBAsBgB,oBAAA,SACN,sBACG,uBACN,KAAK"}

package/dist/server/mcp/registerResources.js

@@ -32,4 +32,5 @@ function registerMcpResources(server, resources, ctx) {
 }
 
 //#endregion
-export { registerMcpResources };
+export { registerMcpResources };
+//# sourceMappingURL=registerResources.js.map

package/dist/server/mcp/registerResources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerResources.js","names":[],"sources":["../../../src/server/mcp/registerResources.ts"],"sourcesContent":["import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { ResourceRegistry } from '../../resources';\nimport type { McpCtxFactories } from './mcpTypes';\nimport { Buffer } from 'node:buffer';\n\nfunction mcpResourceMeta(resource: {\n  meta: {\n    title: string;\n    description?: string;\n    mimeType: string;\n    tags?: string[];\n  };\n}) {\n  return {\n    title: resource.meta.title,\n    description: resource.meta.description,\n    mimeType: resource.meta.mimeType,\n    _meta: { tags: resource.meta.tags ?? [] },\n  };\n}\n\nexport function registerMcpResources(\n  server: McpServer,\n  resources: ResourceRegistry,\n  ctx: Pick<McpCtxFactories, 'logger' | 'resourceCtx'>\n) {\n  for (const resource of resources.listTemplates()) {\n    ctx.logger.info('Registering resource: ' + resource.meta.uriTemplate);\n\n    server.registerResource(\n      // IMPORTANT: must be unique across templates; use full uriTemplate (not just scheme).\n      resource.meta.uriTemplate,\n      new ResourceTemplate(resource.meta.uriTemplate, { list: undefined }),\n      mcpResourceMeta(resource),\n      async (_uri, variables) => {\n        const parsedArgs = resource.input.parse(variables);\n        const out = await resource.resolve(parsedArgs, ctx.resourceCtx());\n\n        if (typeof out.data === 'string') {\n          return {\n            contents: [\n              {\n                uri: out.uri,\n                mimeType: out.mimeType ?? resource.meta.mimeType,\n                text: out.data,\n              },\n            ],\n          };\n        }\n\n        return {\n          contents: [\n            {\n              uri: out.uri,\n              mimeType: out.mimeType ?? resource.meta.mimeType,\n              blob: Buffer.from(out.data).toString('base64'),\n            },\n          ],\n        };\n      }\n    );\n\n    ctx.logger.info('Registered resource: ' + resource.meta.uriTemplate);\n  }\n}\n"],"mappings":";;;;AAMA,SAAS,gBAAgB,UAOtB;AACD,QAAO;EACL,OAAO,SAAS,KAAK;EACrB,aAAa,SAAS,KAAK;EAC3B,UAAU,SAAS,KAAK;EACxB,OAAO,EAAE,MAAM,SAAS,KAAK,QAAQ,EAAE,EAAE;EAC1C;;AAGH,SAAgB,qBACd,QACA,WACA,KACA;AACA,MAAK,MAAM,YAAY,UAAU,eAAe,EAAE;AAChD,MAAI,OAAO,KAAK,2BAA2B,SAAS,KAAK,YAAY;AAErE,SAAO,iBAEL,SAAS,KAAK,aACd,IAAI,iBAAiB,SAAS,KAAK,aAAa,EAAE,MAAM,QAAW,CAAC,EACpE,gBAAgB,SAAS,EACzB,OAAO,MAAM,cAAc;GACzB,MAAM,aAAa,SAAS,MAAM,MAAM,UAAU;GAClD,MAAM,MAAM,MAAM,SAAS,QAAQ,YAAY,IAAI,aAAa,CAAC;AAEjE,OAAI,OAAO,IAAI,SAAS,SACtB,QAAO,EACL,UAAU,CACR;IACE,KAAK,IAAI;IACT,UAAU,IAAI,YAAY,SAAS,KAAK;IACxC,MAAM,IAAI;IACX,CACF,EACF;AAGH,UAAO,EACL,UAAU,CACR;IACE,KAAK,IAAI;IACT,UAAU,IAAI,YAAY,SAAS,KAAK;IACxC,MAAM,OAAO,KAAK,IAAI,KAAK,CAAC,SAAS,SAAS;IAC/C,CACF,EACF;IAEJ;AAED,MAAI,OAAO,KAAK,0BAA0B,SAAS,KAAK,YAAY"}

package/dist/server/mcp/registerTools.d.ts

@@ -5,4 +5,5 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 //#region src/server/mcp/registerTools.d.ts
 declare function registerMcpTools(server: McpServer, ops: SpecRegistry, ctx: Pick<McpCtxFactories, 'toolCtx'>): void;
 //#endregion
-export { registerMcpTools };
+export { registerMcpTools };
+//# sourceMappingURL=registerTools.d.ts.map

package/dist/server/mcp/registerTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerTools.d.ts","names":[],"sources":["../../../src/server/mcp/registerTools.ts"],"sourcesContent":[],"mappings":";;;;;iBAMgB,gBAAA,SACN,gBACH,mBACA,KAAK"}

package/dist/server/mcp/registerTools.js

@@ -19,4 +19,5 @@ function registerMcpTools(server, ops, ctx) {
 }
 
 //#endregion
-export { registerMcpTools };
+export { registerMcpTools };
+//# sourceMappingURL=registerTools.js.map

package/dist/server/mcp/registerTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerTools.js","names":[],"sources":["../../../src/server/mcp/registerTools.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { SpecRegistry } from '../../registry';\nimport { defaultMcpTool } from '../../jsonschema';\nimport type { McpCtxFactories } from './mcpTypes';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\n\nexport function registerMcpTools(\n  server: McpServer,\n  ops: SpecRegistry,\n  ctx: Pick<McpCtxFactories, 'toolCtx'>\n) {\n  for (const spec of ops.listSpecs()) {\n    if (spec.meta.kind !== 'command') continue; // expose only commands as tools\n\n    const toolName =\n      spec.transport?.mcp?.toolName ??\n      defaultMcpTool(spec.meta.name, spec.meta.version);\n\n    server.registerTool(\n      toolName,\n      {\n        description: spec.meta.description,\n        inputSchema: spec.io.input?.getZod(),\n      },\n      async (args: unknown): Promise<CallToolResult> => {\n        const result = await ops.execute(\n          spec.meta.name,\n          spec.meta.version,\n          args ?? {},\n          ctx.toolCtx()\n        );\n        return {\n          content: [{ type: 'text', text: JSON.stringify(result, null, 4) }],\n        };\n      }\n    );\n  }\n}\n"],"mappings":";;;AAMA,SAAgB,iBACd,QACA,KACA,KACA;AACA,MAAK,MAAM,QAAQ,IAAI,WAAW,EAAE;AAClC,MAAI,KAAK,KAAK,SAAS,UAAW;EAElC,MAAM,WACJ,KAAK,WAAW,KAAK,YACrB,eAAe,KAAK,KAAK,MAAM,KAAK,KAAK,QAAQ;AAEnD,SAAO,aACL,UACA;GACE,aAAa,KAAK,KAAK;GACvB,aAAa,KAAK,GAAG,OAAO,QAAQ;GACrC,EACD,OAAO,SAA2C;GAChD,MAAM,SAAS,MAAM,IAAI,QACvB,KAAK,KAAK,MACV,KAAK,KAAK,SACV,QAAQ,EAAE,EACV,IAAI,SAAS,CACd;AACD,UAAO,EACL,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM,KAAK,UAAU,QAAQ,MAAM,EAAE;IAAE,CAAC,EACnE;IAEJ"}

package/dist/server/rest-elysia.d.ts

@@ -37,4 +37,5 @@ declare function elysiaPlugin(app: Elysia, reg: SpecRegistry, ctxFactory: (c: {
   response: {};
 }>;
 //#endregion
-export { elysiaPlugin };
+export { elysiaPlugin };
+//# sourceMappingURL=rest-elysia.d.ts.map

package/dist/server/rest-elysia.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-elysia.d.ts","names":[],"sources":["../../src/server/rest-elysia.ts"],"sourcesContent":[],"mappings":";;;;;;;iBAMgB,YAAA,MACT,aACA;EAFS,OAAA,EAGa,OAHD;EACrB,KAAA,EAAA,GAAA;CACA,EAAA,GACgD,UADhD,EAAA,OAAA,CAAA,EAEK,WAFL,CAAA,EAEgB,MAFhB,CAAA,EAAA,EAAA;EACsB,SAAA,EAAA,CAAA,CAAA;EAA0B,KAAA,EAAA,CAAA,CAAA;EAC3C,MAAA,EAAA,CAAA,CAAA;EAAW,OAAA,EAAA,CAAA,CAAA;CAAA,EAAA"}

package/dist/server/rest-elysia.js

@@ -17,4 +17,5 @@ function elysiaPlugin(app, reg, ctxFactory, options) {
 }
 
 //#endregion
-export { elysiaPlugin };
+export { elysiaPlugin };
+//# sourceMappingURL=rest-elysia.js.map

package/dist/server/rest-elysia.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-elysia.js","names":[],"sources":["../../src/server/rest-elysia.ts"],"sourcesContent":["import type { Elysia } from 'elysia';\nimport { createFetchHandler, type RestOptions } from './rest-generic';\nimport type { SpecRegistry } from '../registry';\nimport type { HandlerCtx } from '../types';\n\n/** Mount routes on an Elysia instance */\nexport function elysiaPlugin(\n  app: Elysia,\n  reg: SpecRegistry,\n  ctxFactory: (c: { request: Request; store: any }) => HandlerCtx,\n  options?: RestOptions\n) {\n  const handler = createFetchHandler(\n    reg,\n    (req) => ctxFactory({ request: req, store: (app as any).store }),\n    options\n  );\n\n  for (const spec of reg.listSpecs()) {\n    const method =\n      spec.transport?.rest?.method ??\n      (spec.meta.kind === 'query' ? 'GET' : 'POST');\n    const path =\n      (options?.basePath ?? '') +\n      (spec.transport?.rest?.path ??\n        `/${spec.meta.name.replace(/\\./g, '/')}/v${spec.meta.version}`);\n    app[method.toLowerCase() as 'get' | 'post'](path, ({ request }: any) =>\n      handler(request)\n    );\n  }\n\n  if (options?.cors) {\n    app.options('*', ({ request }: any) => handler(request));\n  }\n\n  return app;\n}\n"],"mappings":";;;;AAMA,SAAgB,aACd,KACA,KACA,YACA,SACA;CACA,MAAM,UAAU,mBACd,MACC,QAAQ,WAAW;EAAE,SAAS;EAAK,OAAQ,IAAY;EAAO,CAAC,EAChE,QACD;AAED,MAAK,MAAM,QAAQ,IAAI,WAAW,EAAE;EAClC,MAAM,SACJ,KAAK,WAAW,MAAM,WACrB,KAAK,KAAK,SAAS,UAAU,QAAQ;EACxC,MAAM,QACH,SAAS,YAAY,OACrB,KAAK,WAAW,MAAM,QACrB,IAAI,KAAK,KAAK,KAAK,QAAQ,OAAO,IAAI,CAAC,IAAI,KAAK,KAAK;AACzD,MAAI,OAAO,aAAa,EAAoB,OAAO,EAAE,cACnD,QAAQ,QAAQ,CACjB;;AAGH,KAAI,SAAS,KACX,KAAI,QAAQ,MAAM,EAAE,cAAmB,QAAQ,QAAQ,CAAC;AAG1D,QAAO"}

package/dist/server/rest-express.d.ts

@@ -13,4 +13,5 @@ declare function expressRouter(express: {
   Router: () => Router;
 }, reg: SpecRegistry, ctxFactory: (req: Request) => HandlerCtx, options?: RestOptions): Router;
 //#endregion
-export { expressRouter };
+export { expressRouter };
+//# sourceMappingURL=rest-express.d.ts.map

package/dist/server/rest-express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-express.d.ts","names":[],"sources":["../../src/server/rest-express.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAaA;;AAEO,iBAFS,aAAA,CAET,OAAA,EAAA;EACa,MAAA,EAAA,GAAA,GAFO,MAEP;CAAe,EAAA,GAAA,EAD5B,YAC4B,EAAA,UAAA,EAAA,CAAA,GAAA,EAAf,OAAe,EAAA,GAAA,UAAA,EAAA,OAAA,CAAA,EACvB,WADuB,CAAA,EAEhC,MAFgC"}

package/dist/server/rest-express.js

@@ -36,4 +36,5 @@ function expressRouter(express, reg, ctxFactory, options) {
 }
 
 //#endregion
-export { expressRouter };
+export { expressRouter };
+//# sourceMappingURL=rest-express.js.map

package/dist/server/rest-express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-express.js","names":[],"sources":["../../src/server/rest-express.ts"],"sourcesContent":["import type {\n  Request as ExpressReq,\n  Response as ExpressRes,\n  Router,\n} from 'express';\nimport { createFetchHandler, type RestOptions } from './rest-generic';\nimport type { SpecRegistry } from '../registry';\nimport type { HandlerCtx } from '../types';\n\n/**\n * Build an Express Router that proxies to the Fetch-style handler.\n * You can mount it at any base path; pass the same basePath in options.\n */\nexport function expressRouter(\n  express: { Router: () => Router },\n  reg: SpecRegistry,\n  ctxFactory: (req: ExpressReq) => HandlerCtx,\n  options?: RestOptions\n): Router {\n  const router = express.Router();\n  const fetchHandler = createFetchHandler(\n    reg,\n    (_r) => {\n      // Convert Fetch Request headers -> Express req is provided below\n      // We pass the Express req directly via closure\n      throw new Error('ctxFactory must be called from route'); // placeholder\n    },\n    options\n  );\n\n  // For each spec, create a concrete route so Express can match quickly\n  for (const spec of reg.listSpecs()) {\n    const method =\n      spec.transport?.rest?.method ??\n      (spec.meta.kind === 'query' ? 'GET' : 'POST');\n    const path =\n      (options?.basePath ?? '') +\n      (spec.transport?.rest?.path ??\n        `/${spec.meta.name.replace(/\\./g, '/')}/v${spec.meta.version}`);\n\n    router[method.toLowerCase() as 'get' | 'post'](\n      path,\n      async (req: ExpressReq, res: ExpressRes) => {\n        const url = new URL(\n          `${req.protocol}://${req.get('host')}${req.originalUrl}`\n        );\n        const request = new Request(url.toString(), {\n          method,\n          headers: Object.fromEntries(\n            Object.entries(req.headers).map(([k, v]) => [k, String(v)])\n          ),\n          body: method === 'POST' ? JSON.stringify(req.body ?? {}) : undefined,\n        });\n\n        const handler = createFetchHandler(reg, () => ctxFactory(req), options);\n        const response = await handler(request);\n\n        res.status(response.status);\n        response.headers.forEach((v, k) => res.setHeader(k, v));\n        const text = await response.text();\n        res.send(text);\n      }\n    );\n  }\n\n  // Generic OPTIONS for CORS (if enabled)\n  if (options?.cors) {\n    router.options('*', (_req, res) => {\n      const h = new Headers();\n      const resp = new Response(null, { status: 204 });\n      resp.headers.forEach((v, k) => h.set(k, v));\n      res.status(204).send();\n    });\n  }\n\n  return router;\n}\n"],"mappings":";;;;;;;AAaA,SAAgB,cACd,SACA,KACA,YACA,SACQ;CACR,MAAM,SAAS,QAAQ,QAAQ;AACV,oBACnB,MACC,OAAO;AAGN,QAAM,IAAI,MAAM,uCAAuC;IAEzD,QACD;AAGD,MAAK,MAAM,QAAQ,IAAI,WAAW,EAAE;EAClC,MAAM,SACJ,KAAK,WAAW,MAAM,WACrB,KAAK,KAAK,SAAS,UAAU,QAAQ;EACxC,MAAM,QACH,SAAS,YAAY,OACrB,KAAK,WAAW,MAAM,QACrB,IAAI,KAAK,KAAK,KAAK,QAAQ,OAAO,IAAI,CAAC,IAAI,KAAK,KAAK;AAEzD,SAAO,OAAO,aAAa,EACzB,MACA,OAAO,KAAiB,QAAoB;GAC1C,MAAM,MAAM,IAAI,IACd,GAAG,IAAI,SAAS,KAAK,IAAI,IAAI,OAAO,GAAG,IAAI,cAC5C;GACD,MAAM,UAAU,IAAI,QAAQ,IAAI,UAAU,EAAE;IAC1C;IACA,SAAS,OAAO,YACd,OAAO,QAAQ,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC,CAAC,CAC5D;IACD,MAAM,WAAW,SAAS,KAAK,UAAU,IAAI,QAAQ,EAAE,CAAC,GAAG;IAC5D,CAAC;GAGF,MAAM,WAAW,MADD,mBAAmB,WAAW,WAAW,IAAI,EAAE,QAAQ,CACxC,QAAQ;AAEvC,OAAI,OAAO,SAAS,OAAO;AAC3B,YAAS,QAAQ,SAAS,GAAG,MAAM,IAAI,UAAU,GAAG,EAAE,CAAC;GACvD,MAAM,OAAO,MAAM,SAAS,MAAM;AAClC,OAAI,KAAK,KAAK;IAEjB;;AAIH,KAAI,SAAS,KACX,QAAO,QAAQ,MAAM,MAAM,QAAQ;EACjC,MAAM,IAAI,IAAI,SAAS;AAEvB,EADa,IAAI,SAAS,MAAM,EAAE,QAAQ,KAAK,CAAC,CAC3C,QAAQ,SAAS,GAAG,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;AAC3C,MAAI,OAAO,IAAI,CAAC,MAAM;GACtB;AAGJ,QAAO"}

package/dist/server/rest-generic.d.ts

@@ -29,4 +29,5 @@ interface RestOptions {
  */
 declare function createFetchHandler(reg: SpecRegistry, ctxFactory: (req: Request) => HandlerCtx, options?: RestOptions): (req: Request) => Promise<Response>;
 //#endregion
-export { RestOptions, createFetchHandler };
+export { RestOptions, createFetchHandler };
+//# sourceMappingURL=rest-generic.d.ts.map

package/dist/server/rest-generic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-generic.d.ts","names":[],"sources":["../../src/server/rest-generic.ts"],"sourcesContent":[],"mappings":";;;;UAIiB,WAAA;;EAAA,QAAA,CAAA,EAAA,MAAW;EAsDZ;EACT,IAAA,CAAA,EAAA,OAAA,GAAA;IACa,MAAA,CAAA,EAAA,MAAA,GAAA,GAAA;IAAY,OAAA,CAAA,EAAA,MAAA,EAAA;IACpB,OAAA,CAAA,EAAA,MAAA,EAAA;IAiDwB,WAAA,CAAA,EAAA,OAAA;IAAkB,MAAA,CAAA,EAAA,MAAA;EAAR,CAAA;EAAO;;;;;;;;;;;;;;iBApDrC,kBAAA,MACT,gCACa,YAAY,sBACpB,oBAiDwB,YAAU,QAAQ"}

package/dist/server/rest-generic.js

@@ -122,4 +122,5 @@ function createFetchHandler(reg, ctxFactory, options) {
 }
 
 //#endregion
-export { createFetchHandler };
+export { createFetchHandler };
+//# sourceMappingURL=rest-generic.js.map

package/dist/server/rest-generic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-generic.js","names":["h: Record<string, string>","opts: Required<Omit<RestOptions, 'onError'>> &\n    Pick<RestOptions, 'onError'>","routes: Route[]","base: HeadersInit","headers: HeadersInit","input: any","obj: Record<string, any>","err: any","headers"],"sources":["../../src/server/rest-generic.ts"],"sourcesContent":["import { defaultRestPath } from '../jsonschema';\nimport type { SpecRegistry } from '../registry';\nimport type { HandlerCtx } from '../types';\n\nexport interface RestOptions {\n  /** Prefix all routes, e.g. \"/api\" */\n  basePath?: string;\n  /** If true, handle OPTIONS and set CORS headers */\n  cors?:\n    | boolean\n    | {\n        origin?: string | '*';\n        methods?: string[];\n        headers?: string[];\n        credentials?: boolean;\n        maxAge?: number;\n      };\n  /** JSON spacing in responses (dev only ideally) */\n  prettyJson?: number | false;\n  /** Map thrown errors to {status, body} */\n  onError?: (err: unknown) => { status: number; body: any };\n}\n\n/** Minimal WHATWG Response polyfill util for Node < 18 (if needed) */\n// export const toResponse = (status: number, data: any, headers?: HeadersInit) =>\n//   new Response(JSON.stringify(data), { status, headers: { \"content-type\": \"application/json; charset=utf-8\", ...(headers || {}) } });\n\nfunction corsHeaders(opt: NonNullable<RestOptions['cors']>) {\n  const h: Record<string, string> = {};\n  const origin = typeof opt === 'object' ? (opt.origin ?? '*') : '*';\n  h['access-control-allow-origin'] = origin as string;\n  h['vary'] = 'Origin';\n  if (typeof opt === 'object') {\n    if (opt.methods) h['access-control-allow-methods'] = opt.methods.join(', ');\n    if (opt.headers) h['access-control-allow-headers'] = opt.headers.join(', ');\n    if (opt.credentials) h['access-control-allow-credentials'] = 'true';\n    if (typeof opt.maxAge === 'number')\n      h['access-control-max-age'] = String(opt.maxAge);\n  } else {\n    h['access-control-allow-methods'] = 'GET,POST,OPTIONS';\n    h['access-control-allow-headers'] =\n      'content-type,x-idempotency-key,x-trace-id';\n  }\n  return h;\n}\n\nfunction joinPath(a: string | undefined, b: string) {\n  const left = (a ?? '').replace(/\\/+$/g, '');\n  const right = b.replace(/^\\/+/g, '');\n  return `${left}/${right}`.replace(/\\/{2,}/g, '/');\n}\n\n/**\n * Build a single Fetch-style handler: (req) => Response\n * - Discovers routes from SpecRegistry\n * - Validates with zod via registry.execute()\n * - Handles CORS (optional)\n */\nexport function createFetchHandler(\n  reg: SpecRegistry,\n  ctxFactory: (req: Request) => HandlerCtx,\n  options?: RestOptions\n) {\n  const opts: Required<Omit<RestOptions, 'onError'>> &\n    Pick<RestOptions, 'onError'> = {\n    basePath: options?.basePath ?? '',\n    cors: options?.cors ?? false,\n    prettyJson: options?.prettyJson ?? false,\n    onError: options?.onError,\n  };\n\n  interface Route {\n    method: 'GET' | 'POST';\n    path: string; // absolute path including basePath\n    name: string;\n    version: number;\n  }\n\n  const routes: Route[] = reg.listSpecs().map((spec) => ({\n    method: (spec.transport?.rest?.method ??\n      (spec.meta.kind === 'query' ? 'GET' : 'POST')) as 'GET' | 'POST',\n    path: joinPath(\n      opts.basePath,\n      spec.transport?.rest?.path ??\n        defaultRestPath(spec.meta.name, spec.meta.version)\n    ),\n    name: spec.meta.name,\n    version: spec.meta.version,\n  }));\n\n  const routeTable = new Map<string, Route>(); // KEY: METHOD + \" \" + PATH\n  for (const r of routes) routeTable.set(`${r.method} ${r.path}`, r);\n\n  const allowHeader = Array.from(new Set(routes.map((r) => r.method))).join(\n    ', '\n  );\n\n  const makeJson = (status: number, data: any, extraHeaders?: HeadersInit) => {\n    const body = opts.prettyJson\n      ? JSON.stringify(data, null, opts.prettyJson)\n      : JSON.stringify(data);\n    const base: HeadersInit = {\n      'content-type': 'application/json; charset=utf-8',\n    };\n    return new Response(body, {\n      status,\n      headers: extraHeaders ? { ...base, ...extraHeaders } : base,\n    });\n  };\n\n  return async function handle(req: Request): Promise<Response> {\n    const url = new URL(req.url);\n    const key = `${req.method.toUpperCase()} ${url.pathname}`;\n\n    // CORS preflight\n    if (opts.cors && req.method.toUpperCase() === 'OPTIONS') {\n      const h = corsHeaders(opts.cors === true ? {} : opts.cors);\n      return new Response(null, {\n        status: 204,\n        headers: { ...h, 'content-length': '0' },\n      });\n    }\n\n    const route = routeTable.get(key);\n    if (!route) {\n      const headers: HeadersInit = {};\n      if (opts.cors)\n        Object.assign(\n          headers,\n          corsHeaders(opts.cors === true ? {} : opts.cors)\n        );\n      return makeJson(404, { error: 'NotFound', path: url.pathname }, headers);\n    }\n\n    try {\n      let input: any = {};\n      if (route.method === 'GET') {\n        // Support either flattened query (?a=1&b=x) or ?input=<json>\n        if (url.searchParams.has('input')) {\n          const raw = url.searchParams.get('input')!;\n          input = raw ? JSON.parse(raw) : {};\n        } else {\n          const obj: Record<string, any> = {};\n          for (const [k, v] of url.searchParams.entries()) obj[k] = v;\n          input = obj;\n        }\n      } else {\n        const contentType = req.headers.get('content-type') || '';\n        if (contentType.includes('application/json')) {\n          input = await req.json();\n        } else if (contentType.includes('application/x-www-form-urlencoded')) {\n          const form = (await req.formData()) as never as FormData;\n          input = Object.fromEntries(form.entries());\n        } else if (!contentType) {\n          input = {};\n        } else {\n          return makeJson(415, { error: 'UnsupportedMediaType', contentType });\n        }\n      }\n\n      const ctx = ctxFactory(req);\n      const result = await reg.execute(route.name, route.version, input, ctx);\n\n      const headers: HeadersInit = {};\n      if (opts.cors)\n        Object.assign(\n          headers,\n          corsHeaders(opts.cors === true ? {} : opts.cors)\n        );\n      return makeJson(200, result, headers);\n    } catch (err: any) {\n      if (opts.onError) {\n        const mapped = opts.onError(err);\n        const headers: HeadersInit = {};\n        if (opts.cors)\n          Object.assign(\n            headers,\n            corsHeaders(opts.cors === true ? {} : opts.cors)\n          );\n        return makeJson(mapped.status, mapped.body, headers);\n      }\n      const headers: HeadersInit = {};\n      if (opts.cors)\n        Object.assign(\n          headers,\n          corsHeaders(opts.cors === true ? {} : opts.cors)\n        );\n      // Basic zod hint\n      if (err?.issues)\n        return makeJson(\n          400,\n          { error: 'ValidationError', issues: err.issues },\n          headers\n        );\n      if (\n        typeof err?.message === 'string' &&\n        err.message.startsWith('PolicyDenied')\n      ) {\n        return makeJson(403, { error: 'PolicyDenied' }, headers);\n      }\n      return makeJson(500, { error: 'InternalError' }, headers);\n    }\n  };\n}\n"],"mappings":"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"}

package/dist/server/rest-next-app.d.ts

@@ -32,4 +32,5 @@ import { RestOptions } from "./rest-generic.js";
  */
 declare function makeNextAppHandler(reg: SpecRegistry, ctxFactory: (req: Request) => HandlerCtx, options?: RestOptions): (req: Request) => Promise<Response>;
 //#endregion
-export { makeNextAppHandler };
+export { makeNextAppHandler };
+//# sourceMappingURL=rest-next-app.d.ts.map

package/dist/server/rest-next-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-next-app.d.ts","names":[],"sources":["../../src/server/rest-next-app.ts"],"sourcesContent":[],"mappings":";;;;;;;;AA8BA;;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,kBAAA,MACT,gCACa,YAAY,sBACpB,oBAGgC,YAAO,QAAA"}

package/dist/server/rest-next-app.js

@@ -35,4 +35,5 @@ function makeNextAppHandler(reg, ctxFactory, options) {
 }
 
 //#endregion
-export { makeNextAppHandler };
+export { makeNextAppHandler };
+//# sourceMappingURL=rest-next-app.js.map

package/dist/server/rest-next-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-next-app.js","names":[],"sources":["../../src/server/rest-next-app.ts"],"sourcesContent":["import { createFetchHandler, type RestOptions } from './rest-generic';\nimport type { SpecRegistry } from '../registry';\nimport type { HandlerCtx } from '../types';\n\n/**\n * Creates a Next.js App Router route handler for ContractSpec operations.\n *\n * This function returns a handler suitable for `export const { GET, POST }` in a `route.ts` file.\n * It handles:\n * - Path parsing to determine the operation name and version.\n * - Body parsing (JSON).\n * - Context creation via `ctxFactory`.\n * - Execution via `SpecRegistry`.\n * - Response formatting (JSON success/error).\n *\n * @param reg - The SpecRegistry containing the operations.\n * @param ctxFactory - A factory function to build the `HandlerCtx` (e.g., auth, tenant) from the request.\n * @param options - Optional configuration for the REST handler.\n * @returns A function `(req: Request) => Promise<Response>`.\n *\n * @example\n * ```ts\n * // app/api/[...route]/route.ts\n * import { makeNextAppHandler } from '@lssm/lib.contracts/server/rest-next-app';\n * import { registry } from '@/lib/registry';\n *\n * const handler = makeNextAppHandler(registry, (req) => ({ actor: 'anonymous' }));\n * export { handler as GET, handler as POST };\n * ```\n */\nexport function makeNextAppHandler(\n  reg: SpecRegistry,\n  ctxFactory: (req: Request) => HandlerCtx,\n  options?: RestOptions\n) {\n  const handler = createFetchHandler(reg, ctxFactory, options);\n  return async function requestHandler(req: Request) {\n    return handler(req);\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,mBACd,KACA,YACA,SACA;CACA,MAAM,UAAU,mBAAmB,KAAK,YAAY,QAAQ;AAC5D,QAAO,eAAe,eAAe,KAAc;AACjD,SAAO,QAAQ,IAAI"}

package/dist/server/rest-next-mcp.d.ts

@@ -8,4 +8,5 @@ declare function makeNextMcpServerFromRegistry(reg: SpecRegistry, ctxFactory: ()
   DELETE: (request: Request) => Promise<Response>;
 };
 //#endregion
-export { makeNextMcpServerFromRegistry };
+export { makeNextMcpServerFromRegistry };
+//# sourceMappingURL=rest-next-mcp.d.ts.map

package/dist/server/rest-next-mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-next-mcp.d.ts","names":[],"sources":["../../src/server/rest-next-mcp.ts"],"sourcesContent":[],"mappings":";;;;iBAYgB,6BAAA,MACT,gCACa;;EAFJ,IAAA,EAAA,CAAA,OAAA,SAAA,EAAA,UAA6B,SAAA,CAAA;EACtC,MAAA,EAAA,CAAA,OAAA,SAAA,EAAA,UAAA,SAAA,CAAA;CACa"}

package/dist/server/rest-next-mcp.js

@@ -42,4 +42,5 @@ function makeNextMcpServerFromRegistry(reg, ctxFactory) {
 }
 
 //#endregion
-export { makeNextMcpServerFromRegistry };
+export { makeNextMcpServerFromRegistry };
+//# sourceMappingURL=rest-next-mcp.js.map

package/dist/server/rest-next-mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-next-mcp.js","names":[],"sources":["../../src/server/rest-next-mcp.ts"],"sourcesContent":["import type { SpecRegistry } from '../registry';\nimport type { AnySchemaModel } from '@lssm/lib.schema';\nimport type { ContractSpec } from '../spec';\nimport type { HandlerCtx } from '../types';\nimport { createMcpHandler } from 'mcp-handler';\nimport type {\n  ReadResourceTemplateCallback,\n  ToolCallback,\n} from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { defaultMcpTool, jsonSchemaForSpec } from '../jsonschema';\n\nexport function makeNextMcpServerFromRegistry(\n  reg: SpecRegistry,\n  ctxFactory: () => HandlerCtx\n) {\n  const handler = createMcpHandler(\n    (server) => {\n      for (const spec of reg.listSpecs()) {\n        const { input, output, meta } = jsonSchemaForSpec(\n          spec as unknown as ContractSpec<AnySchemaModel, AnySchemaModel>\n        );\n\n        if (meta.kind === 'query') {\n          const resourceName =\n            spec.transport?.mcp?.toolName ??\n            defaultMcpTool(spec.meta.name, spec.meta.version);\n\n          (server as any).registerResource(\n            resourceName,\n            new ResourceTemplate('users://{userId}/profile', {\n              list: undefined,\n            }),\n            {\n              // name: resourceName,\n              description: spec.meta.description,\n              inputSchema: input,\n            },\n            (async (uri: URL, args, _req) => {\n              const result = await reg.execute(\n                spec.meta.name,\n                spec.meta.version,\n                args ?? {},\n                ctxFactory()\n              );\n              // return { content: [{ type: 'json', json: result }] };\n              return { contents: [{ uri: uri.href, text: String(result) }] };\n            }) as ReadResourceTemplateCallback\n          );\n        } else if (meta.kind === 'command') {\n          const toolName =\n            spec.transport?.mcp?.toolName ??\n            defaultMcpTool(spec.meta.name, spec.meta.version);\n\n          server.registerTool(\n            toolName,\n            {\n              // name: toolName,\n              description: spec.meta.description,\n              inputSchema: input as any,\n            },\n            (async (args: any, _req: any) => {\n              const result = await reg.execute(\n                spec.meta.name,\n                spec.meta.version,\n                args ?? {},\n                ctxFactory()\n              );\n              // return { content: [{ type: 'json', json: result }] };\n              return { content: [{ type: 'text', text: String(result) }] };\n            }) as ToolCallback\n          );\n        } else {\n          throw new Error(`Unsupported kind: ${meta.kind}`);\n        }\n      }\n    },\n    {},\n    { basePath: '/api' }\n  );\n\n  return { GET: handler, POST: handler, DELETE: handler };\n}\n"],"mappings":";;;;;AAYA,SAAgB,8BACd,KACA,YACA;CACA,MAAM,UAAU,kBACb,WAAW;AACV,OAAK,MAAM,QAAQ,IAAI,WAAW,EAAE;GAClC,MAAM,EAAE,OAAO,QAAQ,SAAS,kBAC9B,KACD;AAED,OAAI,KAAK,SAAS,SAAS;IACzB,MAAM,eACJ,KAAK,WAAW,KAAK,YACrB,eAAe,KAAK,KAAK,MAAM,KAAK,KAAK,QAAQ;AAEnD,IAAC,OAAe,iBACd,cACA,IAAI,iBAAiB,4BAA4B,EAC/C,MAAM,QACP,CAAC,EACF;KAEE,aAAa,KAAK,KAAK;KACvB,aAAa;KACd,GACA,OAAO,KAAU,MAAM,SAAS;KAC/B,MAAM,SAAS,MAAM,IAAI,QACvB,KAAK,KAAK,MACV,KAAK,KAAK,SACV,QAAQ,EAAE,EACV,YAAY,CACb;AAED,YAAO,EAAE,UAAU,CAAC;MAAE,KAAK,IAAI;MAAM,MAAM,OAAO,OAAO;MAAE,CAAC,EAAE;OAEjE;cACQ,KAAK,SAAS,WAAW;IAClC,MAAM,WACJ,KAAK,WAAW,KAAK,YACrB,eAAe,KAAK,KAAK,MAAM,KAAK,KAAK,QAAQ;AAEnD,WAAO,aACL,UACA;KAEE,aAAa,KAAK,KAAK;KACvB,aAAa;KACd,GACA,OAAO,MAAW,SAAc;KAC/B,MAAM,SAAS,MAAM,IAAI,QACvB,KAAK,KAAK,MACV,KAAK,KAAK,SACV,QAAQ,EAAE,EACV,YAAY,CACb;AAED,YAAO,EAAE,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,OAAO,OAAO;MAAE,CAAC,EAAE;OAE/D;SAED,OAAM,IAAI,MAAM,qBAAqB,KAAK,OAAO;;IAIvD,EAAE,EACF,EAAE,UAAU,QAAQ,CACrB;AAED,QAAO;EAAE,KAAK;EAAS,MAAM;EAAS,QAAQ;EAAS"}

package/dist/server/rest-next-pages.d.ts

@@ -6,4 +6,5 @@ import { NextApiRequest, NextApiResponse } from "next";
 //#region src/server/rest-next-pages.d.ts
 declare function makeNextPagesHandler(reg: SpecRegistry, ctxFactory: (req: NextApiRequest) => HandlerCtx, options?: RestOptions): (req: NextApiRequest, res: NextApiResponse) => Promise<void>;
 //#endregion
-export { makeNextPagesHandler };
+export { makeNextPagesHandler };
+//# sourceMappingURL=rest-next-pages.d.ts.map

package/dist/server/rest-next-pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-next-pages.d.ts","names":[],"sources":["../../src/server/rest-next-pages.ts"],"sourcesContent":[],"mappings":";;;;;;iBAKgB,oBAAA,MACT,gCACa,mBAAmB,sBAC3B,oBAUyB,qBAAqB,oBAAe"}

package/dist/server/rest-next-pages.js

@@ -22,4 +22,5 @@ function makeNextPagesHandler(reg, ctxFactory, options) {
 }
 
 //#endregion
-export { makeNextPagesHandler };
+export { makeNextPagesHandler };
+//# sourceMappingURL=rest-next-pages.js.map

package/dist/server/rest-next-pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-next-pages.js","names":[],"sources":["../../src/server/rest-next-pages.ts"],"sourcesContent":["import type { NextApiRequest, NextApiResponse } from 'next';\nimport { createFetchHandler, type RestOptions } from './rest-generic';\nimport type { SpecRegistry } from '../registry';\nimport type { HandlerCtx } from '../types';\n\nexport function makeNextPagesHandler(\n  reg: SpecRegistry,\n  ctxFactory: (req: NextApiRequest) => HandlerCtx,\n  options?: RestOptions\n) {\n  const fetchHandler = createFetchHandler(\n    reg,\n    (_req: Request) => {\n      throw new Error('Use per-request wrapper'); // we wrap below\n    },\n    options\n  );\n\n  return async function handler(req: NextApiRequest, res: NextApiResponse) {\n    const url = `${req.headers['x-forwarded-proto'] ?? 'http'}://${req.headers.host}${req.url}`;\n    const method = req.method?.toUpperCase() || 'GET';\n\n    const request = new Request(url, {\n      method,\n      headers: Object.fromEntries(\n        Object.entries(req.headers).map(([k, v]) => [k, String(v)])\n      ),\n      body: method === 'POST' ? JSON.stringify(req.body ?? {}) : undefined,\n    });\n\n    const perReqHandler = createFetchHandler(\n      reg,\n      () => ctxFactory(req),\n      options\n    );\n    const response = await perReqHandler(request);\n\n    res.status(response.status);\n    response.headers.forEach((v, k) => res.setHeader(k, v));\n    const text = await response.text();\n    res.send(text);\n  };\n}\n"],"mappings":";;;AAKA,SAAgB,qBACd,KACA,YACA,SACA;AACqB,oBACnB,MACC,SAAkB;AACjB,QAAM,IAAI,MAAM,0BAA0B;IAE5C,QACD;AAED,QAAO,eAAe,QAAQ,KAAqB,KAAsB;EACvE,MAAM,MAAM,GAAG,IAAI,QAAQ,wBAAwB,OAAO,KAAK,IAAI,QAAQ,OAAO,IAAI;EACtF,MAAM,SAAS,IAAI,QAAQ,aAAa,IAAI;EAE5C,MAAM,UAAU,IAAI,QAAQ,KAAK;GAC/B;GACA,SAAS,OAAO,YACd,OAAO,QAAQ,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC,CAAC,CAC5D;GACD,MAAM,WAAW,SAAS,KAAK,UAAU,IAAI,QAAQ,EAAE,CAAC,GAAG;GAC5D,CAAC;EAOF,MAAM,WAAW,MALK,mBACpB,WACM,WAAW,IAAI,EACrB,QACD,CACoC,QAAQ;AAE7C,MAAI,OAAO,SAAS,OAAO;AAC3B,WAAS,QAAQ,SAAS,GAAG,MAAM,IAAI,UAAU,GAAG,EAAE,CAAC;EACvD,MAAM,OAAO,MAAM,SAAS,MAAM;AAClC,MAAI,KAAK,KAAK"}

package/dist/spec.d.ts

@@ -192,4 +192,5 @@ declare const defineQuery: <I extends AnySchemaModel, O extends AnySchemaModel |
   policy: Omit<ContractSpec<I, O, E>["policy"], "idempotent">;
 }) => ContractSpec<I, O, E>;
 //#endregion
-export { AnyContractSpec, ContractSpec, EmitDecl, EmitDeclInline, EmitDeclRef, ImplementationRef, ImplementationType, OpKind, TelemetryTrigger, defineCommand, defineQuery, isEmitDeclRef };
+export { AnyContractSpec, ContractSpec, EmitDecl, EmitDeclInline, EmitDeclRef, ImplementationRef, ImplementationType, OpKind, TelemetryTrigger, defineCommand, defineQuery, isEmitDeclRef };
+//# sourceMappingURL=spec.d.ts.map

package/dist/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","names":[],"sources":["../src/spec.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAiCA;AAUA;AAKA;AAUY,KA3CA,MAAA,GA2CQ,SAAG,GAAA,OAAA;AACvB;AAEA;AAgBA;AACgB,KA1DJ,kBAAA,GA0DI,SAAA,GAAA,WAAA,GAAA,MAAA,GAAA,MAAA,GAAA,SAAA,GAAA,MAAA,GAAA,OAAA;;;;;AAYN,UAzDO,iBAAA,CAyDP;EAEK;EAEH,IAAA,EAAA,MAAA;EAEF;EAQE,IAAA,EAnEJ,kBAmEI;EAKD;EAEC,WAAA,CAAA,EAAA,MAAA;;AA2BG,UA/FE,WAAA,CA+FF;EAKA,GAAA,EAnGR,SAmGQ,CAnGE,cAmGF,CAAA;EAMH,IAAA,EAAA,MAAA;;AASE,UA9GG,cAAA,CA8GH;EAGJ,IAAA,EAAA,MAAA;EAsCU,OAAA,EAAA,MAAA;EAAiB,IAAA,EAAA,MAAA;EAGzB,OAAA,EAtJD,cAsJgB;;;;;;AASd,KAzJD,QAAA,GAAW,WA2KrB,GA3KmC,cA2KnC;AAjBU,cAzJC,aAyJD,EAAA,CAAA,CAAA,EAzJqB,QAyJrB,EAAA,GAAA,CAAA,IAzJqC,WAyJrC;AACA,UAxJK,gBAAA,CAwJL;EAAiB,KAAA,EAAA;IACR,IAAA,EAAA,MAAA;IAEK,OAAA,CAAA,EAAA,MAAA;EAAG,CAAA;EAAG,UAAA,CAAA,EAAA,CAAA,IAAA,EAAA;IAAnB,KAAA,EAAA,OAAA;IAAL,MAAA,CAAA,EAAA,OAAA;IACoB,KAAA,CAAA,EAAA,OAAA;EAAG,CAAA,EAAA,GAtJvB,MAsJuB,CAAA,MAAA,EAAA,OAAA,CAAA;;;;;;;;;AAGf,UA/IC,YA+ID,CAAA,cA9IA,cA8IA,EAAA,eA7IC,cA6ID,GA7IkB,qBA6IlB,CAAA,OAAA,CAAA,EAAA,eAAA,SA5IU,QA4IV,EAAA,GAAA,SAAA,GAAA,SA3ID,QA2IC,EAAA,GAAA,SAAA,CAAA,CAAA;EAAG,IAAA,EAAA;IAAG;IAAnB,IAAA,EAAA,MAAA;IAAY;IAeF,OAAA,EAAA,MAaX;IAZU;IACA,IAAA,EAnJF,MAmJE;IAAiB;IACR,SAAA,EAlJN,SAkJM;IAEK;IAAG,MAAA,EAlJjB,KAkJiB,EAAA;IAAG;IAAnB,IAAA,EAhJH,GAgJG,EAAA;IAAL;IACoB,WAAA,EAAA,MAAA;IAAG;IAAG,IAAA,EAAA,MAAA;IAAnB;IAAL,OAAA,EAAA,MAAA;IACoB;IAAG,KAAA,CAAA,EA1IrB,KA0IqB;EAAG,CAAA;EAAnB,EAAA,EAAA;IAAL;IAEI,KAAA,EAvIL,KAuIK,GAAA,IAAA;IAAG;IAAG,MAAA,EArIV,MAqIU;IAAnB;IAAY,MAAA,CAAA,EAnIF,MAmIE,CAAA,MAAA,EAAA;;;;;;;;;;;;;;;;;;;;;;;;eA1GA;;;;;eAKA;;;;;YAMH;;;;;;;cAQE;cACA;;UAGJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAsCU;;KAGR,eAAA,GAAkB,aAC5B,gBACA,iBAAiB;;;;;cAON,0BACD,0BACA,iBAAiB,mDACR,0CAEb,KAAK,aAAa,GAAG,GAAG;QACtB,KAAK,aAAa,GAAG,GAAG;UACtB,KAAK,aAAa,GAAG,GAAG;MAEjC,aAAa,GAAG,GAAG;;;;;cAeT,wBACD,0BACA,iBAAiB,mDACR,0CAEb,KAAK,aAAa,GAAG,GAAG;QACtB,KAAK,aAAa,GAAG,GAAG;UACtB,KAAK,aAAa,GAAG,GAAG;MAEjC,aAAa,GAAG,GAAG"}

package/dist/spec.js

@@ -32,4 +32,5 @@ const defineQuery = (spec) => ({
 });
 
 //#endregion
-export { defineCommand, defineQuery, isEmitDeclRef };
+export { defineCommand, defineQuery, isEmitDeclRef };
+//# sourceMappingURL=spec.js.map

package/dist/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","names":[],"sources":["../src/spec.ts"],"sourcesContent":["/**\n * ContractSpec: a single source of truth describing one operation (command/query).\n * It carries narrative context for humans/agents AND machine-typed input/output/policy.\n */\nimport type { EventSpec } from './events';\nimport type { AnySchemaModel } from '@lssm/lib.schema';\nimport type { ResourceRefDescriptor } from './resources';\nimport type { Owner, Stability, Tag } from './ownership';\nimport type { DocId } from './docs/registry';\nimport type { PolicyRef } from './policy/spec';\nimport type { TestSpecRef } from './tests/spec';\n\n/**\n * Distinguishes between state-changing operations (command) and read-only operations (query).\n */\nexport type OpKind = 'command' | 'query';\n\n/**\n * Type of implementation artifact.\n */\nexport type ImplementationType =\n  | 'handler'\n  | 'component'\n  | 'form'\n  | 'test'\n  | 'service'\n  | 'hook'\n  | 'other';\n\n/**\n * Reference to an implementation file for a spec.\n * Used for explicit implementation mapping.\n */\nexport interface ImplementationRef {\n  /** Path to implementation file (relative to workspace root) */\n  path: string;\n  /** Type of implementation artifact */\n  type: ImplementationType;\n  /** Optional human-readable description */\n  description?: string;\n}\n\n// preferred: reference a declared event\nexport interface EmitDeclRef {\n  ref: EventSpec<AnySchemaModel>;\n  when: string;\n}\n// inline (fallback)\nexport interface EmitDeclInline {\n  name: string;\n  version: number;\n  when: string;\n  payload: AnySchemaModel;\n}\n/**\n * Declaration of an event that an operation may emit.\n * Can be a reference to an `EventSpec` or an inline definition.\n */\nexport type EmitDecl = EmitDeclRef | EmitDeclInline;\nexport const isEmitDeclRef = (e: EmitDecl): e is EmitDeclRef => 'ref' in e;\n\nexport interface TelemetryTrigger {\n  event: { name: string; version?: number };\n  properties?: (args: {\n    input: unknown;\n    output?: unknown;\n    error?: unknown;\n  }) => Record<string, unknown>;\n}\n\n/**\n * The core specification interface for any operation (Command or Query).\n *\n * @template Input - The Zod-backed schema model for the input payload.\n * @template Output - The Zod-backed schema model for the output payload, or a resource reference.\n * @template Events - Tuple of events that this operation may emit.\n */\nexport interface ContractSpec<\n  Input extends AnySchemaModel,\n  Output extends AnySchemaModel | ResourceRefDescriptor<boolean>,\n  Events extends readonly EmitDecl[] | undefined =\n    | readonly EmitDecl[]\n    | undefined,\n> {\n  meta: {\n    /** Fully-qualified op name (e.g., \"sigil.beginSignup\") */\n    name: string;\n    /** Breaking changes => bump version */\n    version: number;\n    /** \"command\" changes state; \"query\" is read-only/idempotent */\n    kind: OpKind;\n    /** Lifecycle marker for comms & tooling */\n    stability: Stability;\n    /** Owners for CODEOWNERS / on-call / approvals */\n    owners: Owner[];\n    /** Search tags, grouping, docs navigation */\n    tags: Tag[];\n    /** Short human-friendly summary */\n    description: string;\n    /** Business goal: why this exists */\n    goal: string;\n    /** Background, constraints, scope edges (feeds docs & LLM context) */\n    context: string;\n    /** Optional doc block id for this operation. */\n    docId?: DocId;\n  };\n\n  io: {\n    /** Zod schema for input payload */\n    input: Input | null;\n    /** Zod schema for output payload */\n    output: Output;\n    /** Named, typed errors this op may throw (optional) */\n    errors?: Record<\n      string,\n      {\n        description: string;\n        http?: number; // suggested HTTP status if surfaced over REST\n        gqlCode?: string; // suggested GraphQL error code\n        when: string; // human-readable condition\n      }\n    >;\n  };\n\n  policy: {\n    /** Minimal auth category allowed to call this op */\n    auth: 'anonymous' | 'user' | 'admin';\n    /** Idempotency hint. Queries default true; commands default false. */\n    idempotent?: boolean;\n    /** Soft rate limit suggestion; adapter enforces via limiter */\n    rateLimit?: { rpm: number; key: 'user' | 'org' | 'global' };\n    /** Feature flags that must be ON for this op to run */\n    flags?: string[];\n    /** Whether a human must approve before action (e.g., risky commands) */\n    escalate?: 'human_review' | null;\n    /** JSONPath-like pointers to redact from logs/prompts */\n    pii?: string[];\n    /** Referenced policy specs governing access */\n    policies?: PolicyRef[];\n    /** Field-level overrides referencing policy specs */\n    fieldPolicies?: {\n      field: string;\n      actions: ('read' | 'write')[];\n      policy?: PolicyRef;\n    }[];\n  };\n\n  sideEffects?: {\n    /** Declared events this op may emit; runtime will guard against others */\n    emits?: Events;\n    /** Analytics intents (names); the service decides the sink */\n    analytics?: string[];\n    /** Audit intents (labels); the service decides storage */\n    audit?: string[];\n  };\n\n  telemetry?: {\n    success?: TelemetryTrigger;\n    failure?: TelemetryTrigger;\n  };\n\n  tests?: TestSpecRef[];\n\n  transport?: {\n    rest?: {\n      /** Override HTTP method (default: POST for commands, GET for queries) */\n      method?: 'GET' | 'POST';\n      /** Override path (default derived from meta.name/version) */\n      path?: string;\n    };\n    gql?: {\n      /** Override field name (default: dots→underscores + _vN) */\n      field?: string;\n      returns?: string;\n      // byIdField?: string;\n      // resource?: string;\n    };\n    mcp?: {\n      /** Override tool identifier (default: \"<name>.v<version>\") */\n      toolName?: string;\n    };\n  };\n\n  acceptance?: {\n    /** Gherkin-lite scenarios for docs & auto tests */\n    scenarios?: {\n      name: string;\n      given: string[];\n      when: string[];\n      then: string[];\n    }[];\n    /** Request/response examples (used for docs & snapshot tests) */\n    examples?: { name: string; input: unknown; output: unknown }[];\n  };\n\n  /**\n   * Explicit implementation file mappings.\n   * Used for tracking and verifying that this spec is correctly implemented.\n   */\n  implementations?: ImplementationRef[];\n}\n\nexport type AnyContractSpec = ContractSpec<\n  AnySchemaModel,\n  AnySchemaModel | ResourceRefDescriptor<boolean>\n>;\n\n/**\n * Helper to define a Command (write operation).\n * Sets `kind: 'command'` and defaults `idempotent: false`.\n */\nexport const defineCommand = <\n  I extends AnySchemaModel,\n  O extends AnySchemaModel | ResourceRefDescriptor<boolean>,\n  E extends readonly EmitDecl[] | undefined = undefined,\n>(\n  spec: Omit<ContractSpec<I, O, E>, 'meta' | 'policy'> & {\n    meta: Omit<ContractSpec<I, O, E>['meta'], 'kind'>;\n    policy: Omit<ContractSpec<I, O, E>['policy'], 'idempotent'>;\n  }\n): ContractSpec<I, O, E> => ({\n  ...spec,\n  meta: { ...spec.meta, kind: 'command' as const },\n  policy: {\n    ...spec.policy,\n    idempotent:\n      (spec.policy as never as ContractSpec<never, never, never>)?.['policy']\n        ?.idempotent ?? false,\n  },\n});\n\n/**\n * Helper to define a Query (read-only operation).\n * Sets `kind: 'query'` and forces `idempotent: true`.\n */\nexport const defineQuery = <\n  I extends AnySchemaModel,\n  O extends AnySchemaModel | ResourceRefDescriptor<boolean>,\n  E extends readonly EmitDecl[] | undefined = undefined,\n>(\n  spec: Omit<ContractSpec<I, O, E>, 'meta' | 'policy'> & {\n    meta: Omit<ContractSpec<I, O, E>['meta'], 'kind'>;\n    policy: Omit<ContractSpec<I, O, E>['policy'], 'idempotent'>;\n  }\n): ContractSpec<I, O, E> => ({\n  ...spec,\n  meta: { ...spec.meta, kind: 'query' as const },\n  policy: { ...spec.policy, idempotent: true },\n});\n"],"mappings":";AA2DA,MAAa,iBAAiB,MAAkC,SAAS;;;;;AAwJzE,MAAa,iBAKX,UAI2B;CAC3B,GAAG;CACH,MAAM;EAAE,GAAG,KAAK;EAAM,MAAM;EAAoB;CAChD,QAAQ;EACN,GAAG,KAAK;EACR,YACG,KAAK,SAAwD,WAC1D,cAAc;EACrB;CACF;;;;;AAMD,MAAa,eAKX,UAI2B;CAC3B,GAAG;CACH,MAAM;EAAE,GAAG,KAAK;EAAM,MAAM;EAAkB;CAC9C,QAAQ;EAAE,GAAG,KAAK;EAAQ,YAAY;EAAM;CAC7C"}

package/dist/telemetry/anomaly.d.ts

@@ -24,4 +24,5 @@ declare class TelemetryAnomalyMonitor {
   reset(): void;
 }
 //#endregion
-export { TelemetryAnomalyEvent, TelemetryAnomalyMonitor, TelemetryAnomalyMonitorOptions };
+export { TelemetryAnomalyEvent, TelemetryAnomalyMonitor, TelemetryAnomalyMonitorOptions };
+//# sourceMappingURL=anomaly.d.ts.map

package/dist/telemetry/anomaly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anomaly.d.ts","names":[],"sources":["../../src/telemetry/anomaly.ts"],"sourcesContent":[],"mappings":";;;;UAGiB,qBAAA;YACL;EADK,SAAA,EAEJ,+BADD;EAOK,MAAA,EAAA,MAAA;EAKJ,KAAA,EAAA,MAAA,GAAA,SAAA;;;UALI,8BAAA;sBACK;cACR;;cAGD,uBAAA;;;;wBAKU;oBAKH"}

package/dist/telemetry/anomaly.js

@@ -45,4 +45,5 @@ var TelemetryAnomalyMonitor = class {
 };
 
 //#endregion
-export { TelemetryAnomalyMonitor };
+export { TelemetryAnomalyMonitor };
+//# sourceMappingURL=anomaly.js.map

package/dist/telemetry/anomaly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anomaly.js","names":[],"sources":["../../src/telemetry/anomaly.ts"],"sourcesContent":["import type { TelemetryDispatch } from './tracker';\nimport type { TelemetryAnomalyDetectionConfig } from './spec';\n\nexport interface TelemetryAnomalyEvent {\n  dispatch: TelemetryDispatch;\n  threshold: TelemetryAnomalyDetectionConfig;\n  metric: string;\n  value: number | undefined;\n  type: 'min' | 'max';\n}\n\nexport interface TelemetryAnomalyMonitorOptions {\n  onAnomaly?: (event: TelemetryAnomalyEvent) => void;\n  now?: () => Date;\n}\n\nexport class TelemetryAnomalyMonitor {\n  private readonly onAnomaly?: (event: TelemetryAnomalyEvent) => void;\n  private readonly now: () => Date;\n  private readonly samples = new Map<string, number>();\n\n  constructor(options: TelemetryAnomalyMonitorOptions = {}) {\n    this.onAnomaly = options.onAnomaly;\n    this.now = options.now ?? (() => new Date());\n  }\n\n  observe(dispatch: TelemetryDispatch) {\n    const anomalyConfig = dispatch.definition.anomalyDetection;\n    if (!anomalyConfig?.enabled) return;\n    if (!anomalyConfig.thresholds?.length) return;\n\n    const eventKey = `${dispatch.name}.v${dispatch.version}`;\n    const count = this.samples.get(eventKey) ?? 0;\n    const newCount = count + 1;\n    this.samples.set(eventKey, newCount);\n\n    if (\n      typeof anomalyConfig.minimumSample === 'number' &&\n      newCount < anomalyConfig.minimumSample\n    ) {\n      return;\n    }\n\n    for (const threshold of anomalyConfig.thresholds) {\n      const value = this.extractMetric(dispatch, threshold.metric);\n      if (typeof value !== 'number') continue;\n      if (typeof threshold.min === 'number' && value < threshold.min) {\n        this.emit(dispatch, anomalyConfig, threshold.metric, value, 'min');\n      }\n      if (typeof threshold.max === 'number' && value > threshold.max) {\n        this.emit(dispatch, anomalyConfig, threshold.metric, value, 'max');\n      }\n    }\n  }\n\n  private extractMetric(dispatch: TelemetryDispatch, metric: string) {\n    const value = dispatch.properties[metric];\n    if (typeof value === 'number') return value;\n    if (typeof value === 'object' && value !== null && 'value' in value) {\n      const maybeNumber = (value as Record<string, unknown>).value;\n      return typeof maybeNumber === 'number' ? maybeNumber : undefined;\n    }\n    return undefined;\n  }\n\n  private emit(\n    dispatch: TelemetryDispatch,\n    threshold: TelemetryAnomalyDetectionConfig,\n    metric: string,\n    value: number,\n    type: 'min' | 'max'\n  ) {\n    this.onAnomaly?.({\n      dispatch,\n      threshold,\n      metric,\n      value,\n      type,\n    });\n  }\n\n  reset() {\n    this.samples.clear();\n  }\n}\n"],"mappings":";AAgBA,IAAa,0BAAb,MAAqC;CACnC,AAAiB;CACjB,AAAiB;CACjB,AAAiB,0BAAU,IAAI,KAAqB;CAEpD,YAAY,UAA0C,EAAE,EAAE;AACxD,OAAK,YAAY,QAAQ;AACzB,OAAK,MAAM,QAAQ,8BAAc,IAAI,MAAM;;CAG7C,QAAQ,UAA6B;EACnC,MAAM,gBAAgB,SAAS,WAAW;AAC1C,MAAI,CAAC,eAAe,QAAS;AAC7B,MAAI,CAAC,cAAc,YAAY,OAAQ;EAEvC,MAAM,WAAW,GAAG,SAAS,KAAK,IAAI,SAAS;EAE/C,MAAM,YADQ,KAAK,QAAQ,IAAI,SAAS,IAAI,KACnB;AACzB,OAAK,QAAQ,IAAI,UAAU,SAAS;AAEpC,MACE,OAAO,cAAc,kBAAkB,YACvC,WAAW,cAAc,cAEzB;AAGF,OAAK,MAAM,aAAa,cAAc,YAAY;GAChD,MAAM,QAAQ,KAAK,cAAc,UAAU,UAAU,OAAO;AAC5D,OAAI,OAAO,UAAU,SAAU;AAC/B,OAAI,OAAO,UAAU,QAAQ,YAAY,QAAQ,UAAU,IACzD,MAAK,KAAK,UAAU,eAAe,UAAU,QAAQ,OAAO,MAAM;AAEpE,OAAI,OAAO,UAAU,QAAQ,YAAY,QAAQ,UAAU,IACzD,MAAK,KAAK,UAAU,eAAe,UAAU,QAAQ,OAAO,MAAM;;;CAKxE,AAAQ,cAAc,UAA6B,QAAgB;EACjE,MAAM,QAAQ,SAAS,WAAW;AAClC,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,WAAW,OAAO;GACnE,MAAM,cAAe,MAAkC;AACvD,UAAO,OAAO,gBAAgB,WAAW,cAAc;;;CAK3D,AAAQ,KACN,UACA,WACA,QACA,OACA,MACA;AACA,OAAK,YAAY;GACf;GACA;GACA;GACA;GACA;GACD,CAAC;;CAGJ,QAAQ;AACN,OAAK,QAAQ,OAAO"}

package/dist/telemetry/docs/telemetry.docblock.d.ts

@@ -3,4 +3,5 @@ import { DocBlock } from "@lssm/lib.contracts/docs";
 //#region src/telemetry/docs/telemetry.docblock.d.ts
 declare const tech_contracts_telemetry_DocBlocks: DocBlock[];
 //#endregion
-export { tech_contracts_telemetry_DocBlocks };
+export { tech_contracts_telemetry_DocBlocks };
+//# sourceMappingURL=telemetry.docblock.d.ts.map

package/dist/telemetry/docs/telemetry.docblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.docblock.d.ts","names":[],"sources":["../../../src/telemetry/docs/telemetry.docblock.ts"],"sourcesContent":[],"mappings":";;;cAGa,oCAAoC"}

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

@@ -19,4 +19,5 @@ const tech_contracts_telemetry_DocBlocks = [{
 registerDocBlocks(tech_contracts_telemetry_DocBlocks);
 
 //#endregion
-export { tech_contracts_telemetry_DocBlocks };
+export { tech_contracts_telemetry_DocBlocks };
+//# sourceMappingURL=telemetry.docblock.js.map