@frontmcp/sdk 0.4.1 → 0.5.0

package/src/tool/tool.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.utils.js","sourceRoot":"","sources":["../../../src/tool/tool.utils.ts"],"names":[],"mappings":"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","sourcesContent":["// file: libs/sdk/src/tool/tool.utils.ts\nimport {\n  ToolMetadata,\n  FrontMcpToolTokens,\n  ToolType,\n  Token,\n  ToolRecord,\n  ToolKind,\n  EntryLineage,\n  Type,\n  ToolContext,\n  extendedToolMetadata,\n  ParsedToolResult,\n} from '../common';\nimport { depsOfClass, depsOfFunc, isClass } from '../utils/token.utils';\nimport { getMetadata } from '../utils/metadata.utils';\nimport { NameCase } from './tool.types';\nimport {\n  AudioContent,\n  ContentBlock,\n  EmbeddedResource,\n  ImageContent,\n  ResourceLink,\n  TextContent,\n} from '@modelcontextprotocol/sdk/types.js';\nimport { z, ZodBigInt, ZodBoolean, ZodDate, ZodNumber, ZodString } from 'zod';\n\nexport function collectToolMetadata(cls: ToolType): ToolMetadata {\n  const extended = getMetadata(extendedToolMetadata, cls);\n  const seed = (extended ? { ...extended } : {}) as ToolMetadata;\n  return Object.entries(FrontMcpToolTokens).reduce((metadata, [key, token]) => {\n    const value = getMetadata(token, cls);\n    if (value) {\n      return Object.assign(metadata, {\n        [key]: value,\n      });\n    } else {\n      return metadata;\n    }\n  }, seed);\n}\n\nexport function normalizeTool(item: any): ToolRecord {\n  if (\n    item &&\n    typeof item === 'function' &&\n    item[FrontMcpToolTokens.type] === 'function-tool' &&\n    item[FrontMcpToolTokens.metadata]\n  ) {\n    return {\n      kind: ToolKind.FUNCTION,\n      provide: item(),\n      metadata: item[FrontMcpToolTokens.metadata] as ToolMetadata,\n    };\n  }\n\n  if (isClass(item)) {\n    // read McpToolMetadata from class\n    const metadata = collectToolMetadata(item);\n    return { kind: ToolKind.CLASS_TOKEN, provide: item as Type<ToolContext>, metadata };\n  }\n  const name = (item as any)?.name ?? String(item);\n  throw new Error(`Invalid adapter '${name}'. Expected a class or a adapter object.`);\n}\n\n/**\n * For graph/cycle detection. Returns dependency tokens that should be graphed.\n * - FUNCTION: get function params without the first argument (the tool input)\n * - CLASS_TOKEN: deps come from the class constructor\n */\nexport function toolDiscoveryDeps(rec: ToolRecord): Token[] {\n  switch (rec.kind) {\n    case ToolKind.FUNCTION: {\n      return depsOfFunc(rec.provide, 'discovery');\n    }\n    case ToolKind.CLASS_TOKEN:\n      return depsOfClass(rec.provide, 'discovery');\n  }\n}\n\n// Allowed chars per MCP spec: a-zA-Z0-9 _ -. /\nconst MCP_ALLOWED = /[A-Za-z0-9_\\-./]/;\n\nexport function splitWords(input: string): string[] {\n  const parts: string[] = [];\n  let buff = '';\n  for (let i = 0; i < input.length; i++) {\n    const ch = input[i];\n    const isAlphaNum = /[A-Za-z0-9]/.test(ch);\n    if (!isAlphaNum) {\n      if (buff) {\n        parts.push(buff);\n        buff = '';\n      }\n      continue;\n    }\n    if (buff && /[a-z]/.test(buff[buff.length - 1]) && /[A-Z]/.test(ch)) {\n      parts.push(buff);\n      buff = ch;\n    } else {\n      buff += ch;\n    }\n  }\n  if (buff) parts.push(buff);\n  return parts;\n}\n\nexport function toCase(words: string[], kind: NameCase): string {\n  const safe = words.filter(Boolean);\n  switch (kind) {\n    case 'snake':\n      return safe.map((w) => w.toLowerCase()).join('_');\n    case 'kebab':\n      return safe.map((w) => w.toLowerCase()).join('-');\n    case 'dot':\n      return safe.map((w) => w.toLowerCase()).join('.');\n    case 'camel':\n      if (safe.length === 0) return '';\n      return (\n        safe[0].toLowerCase() +\n        safe\n          .slice(1)\n          .map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase())\n          .join('')\n      );\n  }\n}\n\nexport function normalizeSegment(raw: string, kind: NameCase): string {\n  const words = splitWords(raw);\n  let cased = toCase(words, kind);\n  cased = [...cased].filter((ch) => MCP_ALLOWED.test(ch)).join('');\n  return cased || 'x';\n}\n\nexport function normalizeProviderId(raw: string | undefined, kind: NameCase): string | undefined {\n  if (!raw) return undefined;\n  const tokens = raw.split(/\\W+/);\n  const cased = toCase(tokens, kind);\n  const safe = [...cased].filter((ch) => MCP_ALLOWED.test(ch)).join('');\n  return safe || undefined;\n}\n\nexport function normalizeOwnerPath(ownerKey: string, kind: NameCase): string {\n  const levels = ownerKey.split('/');\n  const normLevels = levels.map((level) => {\n    const parts = level.split(':'); // [\"app\",\"Portal\"]\n    return parts\n      .map((p) => normalizeSegment(p, kind))\n      .join(kind === 'snake' ? '_' : kind === 'kebab' ? '-' : kind === 'dot' ? '.' : '');\n  });\n  if (kind === 'camel') return normLevels.map((seg) => seg.charAt(0).toLowerCase() + seg.slice(1)).join('');\n  const sep = kind === 'snake' ? '_' : kind === 'kebab' ? '-' : '.';\n  return normLevels.join(sep);\n}\n\nexport function shortHash(s: string): string {\n  let h = 5381;\n  for (let i = 0; i < s.length; i++) h = (h << 5) + h + s.charCodeAt(i);\n  return (h >>> 0).toString(16).slice(-6).padStart(6, '0');\n}\n\nexport function ensureMaxLen(name: string, max: number): string {\n  if (name.length <= max) return name;\n  const hash = shortHash(name);\n  const lastSep = Math.max(name.lastIndexOf('_'), name.lastIndexOf('-'), name.lastIndexOf('.'), name.lastIndexOf('/'));\n  const tail = lastSep > 0 ? name.slice(lastSep + 1) : name.slice(-Math.max(3, Math.min(16, Math.floor(max / 4))));\n  const budget = Math.max(1, max - (1 + hash.length + 1 + tail.length));\n  const prefix = name.slice(0, budget);\n  return `${prefix}-${hash}-${tail}`.slice(0, max);\n}\n\nexport function sepFor(kind: NameCase): string {\n  return kind === 'snake' ? '_' : kind === 'kebab' ? '-' : kind === 'dot' ? '.' : '';\n}\n\nexport function ownerKeyOf(lineage: EntryLineage): string {\n  return lineage.map((o) => `${o.kind}:${o.id}`).join('/');\n}\n\nexport function qualifiedNameOf(lineage: EntryLineage, name: string): string {\n  return `${ownerKeyOf(lineage)}:${name}`;\n}\n\nexport function buildParsedToolResult(descriptor: any, raw: unknown): ParsedToolResult {\n  const content: ContentBlock[] = [];\n  let structuredData: Record<string, any> | undefined;\n\n  // No outputSchema → the best effort: treat the result as structured JSON and text fallback\n  if (!descriptor) {\n    const structuredContent = getStructuredContent(raw);\n    const sanitized = structuredContent ?? raw;\n    content.push(makeJsonTextContent(sanitized));\n    return { content, structuredContent };\n  }\n\n  if (Array.isArray(descriptor)) {\n    // Multiple content items; expect raw to be an array of the same length.\n    const values = Array.isArray(raw) ? raw : [raw];\n    const parsedItems: Array<{ blocks: ContentBlock[]; parsedValue?: any; isPrimitive: boolean }> = [];\n\n    // Parse all items first\n    descriptor.forEach((singleDescriptor: any, idx: number) => {\n      const value = values[idx];\n      const { blocks, parsedValue, isPrimitive } = parseSingleValue(singleDescriptor, value);\n      parsedItems.push({ blocks, parsedValue, isPrimitive });\n      content.push(...blocks);\n    });\n\n    // Check if we have at least one non-primitive item\n    const hasNonPrimitive = parsedItems.some(item => !item.isPrimitive);\n\n    if (hasNonPrimitive && parsedItems.length > 1) {\n      // Multiple items with at least one non-string/primitive: use numeric indices\n      structuredData = {};\n      parsedItems.forEach((item, idx) => {\n        if (item.parsedValue !== undefined) {\n          structuredData![idx] = item.parsedValue;\n        }\n      });\n    } else if (parsedItems.length === 1 && parsedItems[0].parsedValue !== undefined) {\n      // Single item: wrap primitives in {content: value}, use objects directly\n      if (parsedItems[0].isPrimitive) {\n        structuredData = { content: parsedItems[0].parsedValue };\n      } else if (typeof parsedItems[0].parsedValue === 'object' && parsedItems[0].parsedValue !== null) {\n        // Non-primitive object (date, json, etc.) - use directly\n        structuredData = parsedItems[0].parsedValue;\n      } else {\n        // Non-primitive but not an object (shouldn't happen, but handle it)\n        structuredData = { content: parsedItems[0].parsedValue };\n      }\n    } else if (hasNonPrimitive) {\n      // Multiple items but only one has a value\n      structuredData = {};\n      parsedItems.forEach((item, idx) => {\n        if (item.parsedValue !== undefined) {\n          structuredData![idx] = item.parsedValue;\n        }\n      });\n    }\n  } else {\n    const { blocks, parsedValue, isPrimitive } = parseSingleValue(descriptor, raw);\n    content.push(...blocks);\n\n    // Single item: wrap primitives in {content: value}, use objects directly\n    if (parsedValue !== undefined) {\n      if (isPrimitive) {\n        structuredData = { content: parsedValue };\n      } else if (typeof parsedValue === 'object' && parsedValue !== null) {\n        // Non-primitive object (date, json, etc.) - use directly\n        structuredData = parsedValue;\n      } else {\n        // Non-primitive but not an object (number, boolean, etc.) - wrap it\n        structuredData = { content: parsedValue };\n      }\n    }\n  }\n\n  const result: ParsedToolResult = { content };\n\n  // Add structuredContent if we have structured data\n  if (structuredData !== undefined) {\n    result.structuredContent = structuredData;\n  }\n\n  return result;\n}\n\n/**\n * Parse a single schema descriptor + value into one or more ContentBlocks.\n *\n * Returns:\n *   - blocks: content blocks to append\n *   - parsedValue: the parsed/validated value (for structuredContent)\n *   - isPrimitive: whether this is a primitive string type\n */\nfunction parseSingleValue(\n  descriptor: any,\n  value: unknown\n): { blocks: ContentBlock[]; parsedValue?: any; isPrimitive: boolean } {\n  // Literal primitives + special content types\n  if (typeof descriptor === 'string') {\n    switch (descriptor) {\n      case 'string':\n        return {\n          blocks: [makePrimitiveTextContent(value)],\n          parsedValue: value,\n          isPrimitive: true,\n        };\n\n      case 'number': {\n        const numValue = typeof value === 'number' ? value : Number(value);\n        return {\n          blocks: [makePrimitiveTextContent(value)],\n          parsedValue: isNaN(numValue) ? null : numValue,\n          isPrimitive: false,\n        };\n      }\n\n      case 'boolean': {\n        const boolValue = typeof value === 'boolean' ? value : Boolean(value);\n        return {\n          blocks: [makePrimitiveTextContent(value)],\n          parsedValue: boolValue,\n          isPrimitive: false,\n        };\n      }\n\n      case 'date': {\n        let dateValue: Date | null = null;\n        if (value instanceof Date) {\n          dateValue = value;\n        } else if (typeof value === 'string' || typeof value === 'number') {\n          const parsed = new Date(value);\n          if (!isNaN(parsed.getTime())) {\n            dateValue = parsed;\n          }\n        }\n\n        return {\n          blocks: [makePrimitiveTextContent(value)],\n          parsedValue: dateValue ? {\n            iso: dateValue.toISOString(),\n            timeInMilli: dateValue.getTime(),\n          } : null,\n          isPrimitive: false,\n        };\n      }\n\n      case 'image':\n        return {\n          blocks: toContentArray<ImageContent>('image', value),\n          parsedValue: undefined,\n          isPrimitive: false,\n        };\n\n      case 'audio':\n        return {\n          blocks: toContentArray<AudioContent>('audio', value),\n          parsedValue: undefined,\n          isPrimitive: false,\n        };\n\n      case 'resource':\n        return {\n          blocks: toContentArray<EmbeddedResource>('resource', value),\n          parsedValue: undefined,\n          isPrimitive: false,\n        };\n\n      case 'resource_link':\n        return {\n          blocks: toContentArray<ResourceLink>('resource_link', value),\n          parsedValue: undefined,\n          isPrimitive: false,\n        };\n\n      default:\n        // Unknown literal: just stringify as text\n        return {\n          blocks: [makePrimitiveTextContent(value)],\n          parsedValue: value,\n          isPrimitive: true,\n        };\n    }\n  }\n\n  // Zod primitives\n  if (descriptor instanceof ZodString) {\n    return {\n      blocks: [makePrimitiveTextContent(value)],\n      parsedValue: value,\n      isPrimitive: true,\n    };\n  }\n\n  if (descriptor instanceof ZodNumber) {\n    const parseResult = descriptor.safeParse(value);\n    const numValue = parseResult.success ? parseResult.data : (typeof value === 'number' ? value : Number(value));\n    return {\n      blocks: [makePrimitiveTextContent(value)],\n      parsedValue: isNaN(numValue) ? null : numValue,\n      isPrimitive: false,\n    };\n  }\n\n  if (descriptor instanceof ZodBoolean) {\n    const parseResult = descriptor.safeParse(value);\n    const boolValue = parseResult.success ? parseResult.data : Boolean(value);\n    return {\n      blocks: [makePrimitiveTextContent(value)],\n      parsedValue: boolValue,\n      isPrimitive: false,\n    };\n  }\n\n  if (descriptor instanceof ZodBigInt) {\n    const parseResult = descriptor.safeParse(value);\n    const bigIntValue = parseResult.success ? parseResult.data : (typeof value === 'bigint' ? value : null);\n    return {\n      blocks: [makePrimitiveTextContent(value)],\n      parsedValue: bigIntValue !== null ? bigIntValue.toString() : null,\n      isPrimitive: false,\n    };\n  }\n\n  if (descriptor instanceof ZodDate) {\n    const parseResult = descriptor.safeParse(value);\n    const dateValue = parseResult.success ? parseResult.data : (value instanceof Date ? value : null);\n    return {\n      blocks: [makePrimitiveTextContent(value)],\n      parsedValue: dateValue ? {\n        iso: dateValue.toISOString(),\n        timeInMilli: dateValue.getTime(),\n      } : null,\n      isPrimitive: false,\n    };\n  }\n\n  // Anything else (Zod object/array/union, ZodRawShape, plain object) → JSON/structured\n  // Use Zod parsing if it's a Zod schema\n  let parsedValue: any;\n\n  if (descriptor instanceof z.ZodType) {\n    // Use Zod to parse and validate\n    const parseResult = descriptor.safeParse(value);\n    if (parseResult.success) {\n      parsedValue = getStructuredContent(parseResult.data);\n    } else {\n      // Validation failed, use sanitized raw value\n      parsedValue = getStructuredContent(value);\n    }\n  } else if (typeof descriptor === 'object' && descriptor !== null) {\n    // ZodRawShape or plain object - try to create a Zod object schema\n    try {\n      const schema = z.object(descriptor);\n      const parseResult = schema.safeParse(value);\n      if (parseResult.success) {\n        parsedValue = getStructuredContent(parseResult.data);\n      } else {\n        parsedValue = getStructuredContent(value);\n      }\n    } catch {\n      // Fallback to sanitized content\n      parsedValue = getStructuredContent(value);\n    }\n  } else {\n    parsedValue = getStructuredContent(value);\n  }\n\n  return {\n    blocks: [makeJsonTextContent(parsedValue)],\n    parsedValue,\n    isPrimitive: false,\n  };\n}\n\nfunction makePrimitiveTextContent(value: unknown): TextContent {\n  return {\n    type: 'text',\n    text: value == null ? '' : String(value),\n  };\n}\n\nfunction makeJsonTextContent(jsonValue: unknown): TextContent {\n  let text: string;\n  try {\n    text = JSON.stringify(jsonValue);\n  } catch {\n    text = jsonValue == null ? '' : String(jsonValue);\n  }\n  return { type: 'text', text };\n}\n\n/**\n * Normalize any `value` into an array of content objects with the given MCP `type`.\n * If `value` is already a single content object (with a matching type), it's wrapped.\n * If it's an array, every element is assumed to already be a content object.\n */\nfunction toContentArray<T extends ContentBlock>(expectedType: T['type'], value: unknown): ContentBlock[] {\n  if (Array.isArray(value)) {\n    return value.filter(Boolean).map((v) => v as T);\n  }\n\n  if (value && typeof value === 'object' && (value as any).type === expectedType) {\n    return [value as T];\n  }\n\n  // If the value is null/undefined or doesn't match, we just skip it.\n  return [];\n}\n\n/**\n * Sanitize arbitrary JS values into JSON-safe objects suitable for:\n *   - MCP `structuredContent`\n *   - JSON.stringify without circular reference errors\n *\n * Rules:\n *   - Drop functions and symbols.\n *   - BigInt → string.\n *   - Date → ISO string.\n *   - Error → { name, message, stack }.\n *   - Map → plain object.\n *   - Set → array.\n *   - Protect against circular references via WeakSet.\n */\nfunction getStructuredContent(value: unknown): any | undefined {\n  const seen = new WeakSet<object>();\n\n  function sanitize(val: any): any {\n    if (typeof val === 'function' || typeof val === 'symbol') {\n      return undefined;\n    }\n\n    if (typeof val === 'bigint') {\n      return val.toString();\n    }\n\n    if (val instanceof Date) {\n      return val.toISOString();\n    }\n\n    if (val instanceof Error) {\n      return {\n        name: val.name,\n        message: val.message,\n        stack: val.stack,\n      };\n    }\n\n    if (val instanceof Map) {\n      const obj: Record<string, any> = {};\n      for (const [k, v] of val.entries()) {\n        obj[String(k)] = sanitize(v);\n      }\n      return obj;\n    }\n\n    if (val instanceof Set) {\n      return Array.from(val).map(sanitize);\n    }\n\n    if (Array.isArray(val)) {\n      return val.map(sanitize);\n    }\n\n    if (val && typeof val === 'object') {\n      if (seen.has(val)) {\n        // Drop circular references\n        return undefined;\n      }\n      seen.add(val);\n\n      const sanitized: Record<string, any> = {};\n      for (const [key, value] of Object.entries(val)) {\n        const clean = sanitize(value);\n        if (clean !== undefined) {\n          sanitized[key] = clean;\n        }\n      }\n      return sanitized;\n    }\n\n    // Primitives pass through\n    return val;\n  }\n\n  return sanitize(value);\n}\n"]}
+{"version":3,"file":"tool.utils.js","sourceRoot":"","sources":["../../../src/tool/tool.utils.ts"],"names":[],"mappings":"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","sourcesContent":["// file: libs/sdk/src/tool/tool.utils.ts\nimport {\n  ToolMetadata,\n  FrontMcpToolTokens,\n  ToolType,\n  Token,\n  ToolRecord,\n  ToolKind,\n  Type,\n  ToolContext,\n  extendedToolMetadata,\n  ParsedToolResult,\n} from '../common';\nimport { depsOfClass, depsOfFunc, isClass } from '../utils/token.utils';\nimport { getMetadata } from '../utils/metadata.utils';\nimport { toStructuredContent } from '../utils/content.utils';\nimport {\n  AudioContent,\n  ContentBlock,\n  EmbeddedResource,\n  ImageContent,\n  ResourceLink,\n  TextContent,\n} from '@modelcontextprotocol/sdk/types.js';\nimport { z, ZodBigInt, ZodBoolean, ZodDate, ZodNumber, ZodString } from 'zod';\n\n// Re-export shared naming utilities for backwards compatibility\nexport {\n  type NameCase,\n  splitWords,\n  toCase,\n  sepFor,\n  normalizeSegment,\n  normalizeProviderId,\n  normalizeOwnerPath,\n  shortHash,\n  ensureMaxLen,\n} from '../utils/naming.utils';\n\n// Re-export shared lineage utilities for backwards compatibility\nexport { ownerKeyOf, qualifiedNameOf } from '../utils/lineage.utils';\n\nexport function collectToolMetadata(cls: ToolType): ToolMetadata {\n  const extended = getMetadata(extendedToolMetadata, cls);\n  const seed = (extended ? { ...extended } : {}) as ToolMetadata;\n  return Object.entries(FrontMcpToolTokens).reduce((metadata, [key, token]) => {\n    const value = getMetadata(token, cls);\n    if (value) {\n      return Object.assign(metadata, {\n        [key]: value,\n      });\n    } else {\n      return metadata;\n    }\n  }, seed);\n}\n\nexport function normalizeTool(item: any): ToolRecord {\n  if (\n    item &&\n    typeof item === 'function' &&\n    item[FrontMcpToolTokens.type] === 'function-tool' &&\n    item[FrontMcpToolTokens.metadata]\n  ) {\n    return {\n      kind: ToolKind.FUNCTION,\n      provide: item(),\n      metadata: item[FrontMcpToolTokens.metadata] as ToolMetadata,\n    };\n  }\n\n  if (isClass(item)) {\n    // read McpToolMetadata from class\n    const metadata = collectToolMetadata(item);\n    return { kind: ToolKind.CLASS_TOKEN, provide: item as Type<ToolContext>, metadata };\n  }\n  const name = (item as any)?.name ?? String(item);\n  throw new Error(`Invalid adapter '${name}'. Expected a class or a adapter object.`);\n}\n\n/**\n * For graph/cycle detection. Returns dependency tokens that should be graphed.\n * - FUNCTION: get function params without the first argument (the tool input)\n * - CLASS_TOKEN: deps come from the class constructor\n */\nexport function toolDiscoveryDeps(rec: ToolRecord): Token[] {\n  switch (rec.kind) {\n    case ToolKind.FUNCTION: {\n      return depsOfFunc(rec.provide, 'discovery');\n    }\n    case ToolKind.CLASS_TOKEN:\n      return depsOfClass(rec.provide, 'discovery');\n  }\n}\n\nexport function buildParsedToolResult(descriptor: any, raw: unknown): ParsedToolResult {\n  const content: ContentBlock[] = [];\n  let structuredData: Record<string, any> | undefined;\n\n  // No outputSchema → the best effort: treat the result as structured JSON and text fallback\n  if (!descriptor) {\n    const structuredContent = toStructuredContent(raw);\n    const sanitized = structuredContent ?? raw;\n    content.push(makeJsonTextContent(sanitized));\n    return { content, structuredContent };\n  }\n\n  if (Array.isArray(descriptor)) {\n    // Multiple content items; expect raw to be an array of the same length.\n    const values = Array.isArray(raw) ? raw : [raw];\n    const parsedItems: Array<{ blocks: ContentBlock[]; parsedValue?: any; isPrimitive: boolean }> = [];\n\n    // Parse all items first\n    descriptor.forEach((singleDescriptor: any, idx: number) => {\n      const value = values[idx];\n      const { blocks, parsedValue, isPrimitive } = parseSingleValue(singleDescriptor, value);\n      parsedItems.push({ blocks, parsedValue, isPrimitive });\n      content.push(...blocks);\n    });\n\n    // Check if we have at least one non-primitive item\n    const hasNonPrimitive = parsedItems.some((item) => !item.isPrimitive);\n\n    if (hasNonPrimitive && parsedItems.length > 1) {\n      // Multiple items with at least one non-string/primitive: use numeric indices\n      structuredData = {};\n      parsedItems.forEach((item, idx) => {\n        if (item.parsedValue !== undefined) {\n          structuredData![idx] = item.parsedValue;\n        }\n      });\n    } else if (parsedItems.length === 1 && parsedItems[0].parsedValue !== undefined) {\n      // Single item: wrap primitives in {content: value}, use objects directly\n      if (parsedItems[0].isPrimitive) {\n        structuredData = { content: parsedItems[0].parsedValue };\n      } else if (typeof parsedItems[0].parsedValue === 'object' && parsedItems[0].parsedValue !== null) {\n        // Non-primitive object (date, json, etc.) - use directly\n        structuredData = parsedItems[0].parsedValue;\n      } else {\n        // Non-primitive but not an object (shouldn't happen, but handle it)\n        structuredData = { content: parsedItems[0].parsedValue };\n      }\n    } else if (hasNonPrimitive) {\n      // Multiple items but only one has a value\n      structuredData = {};\n      parsedItems.forEach((item, idx) => {\n        if (item.parsedValue !== undefined) {\n          structuredData![idx] = item.parsedValue;\n        }\n      });\n    }\n  } else {\n    const { blocks, parsedValue, isPrimitive } = parseSingleValue(descriptor, raw);\n    content.push(...blocks);\n\n    // Single item: wrap primitives in {content: value}, use objects directly\n    if (parsedValue !== undefined) {\n      if (isPrimitive) {\n        structuredData = { content: parsedValue };\n      } else if (typeof parsedValue === 'object' && parsedValue !== null) {\n        // Non-primitive object (date, json, etc.) - use directly\n        structuredData = parsedValue;\n      } else {\n        // Non-primitive but not an object (number, boolean, etc.) - wrap it\n        structuredData = { content: parsedValue };\n      }\n    }\n  }\n\n  const result: ParsedToolResult = { content };\n\n  // Add structuredContent if we have structured data\n  if (structuredData !== undefined) {\n    result.structuredContent = structuredData;\n  }\n\n  return result;\n}\n\n/**\n * Parse a single schema descriptor + value into one or more ContentBlocks.\n *\n * Returns:\n *   - blocks: content blocks to append\n *   - parsedValue: the parsed/validated value (for structuredContent)\n *   - isPrimitive: whether this is a primitive string type\n */\nfunction parseSingleValue(\n  descriptor: any,\n  value: unknown,\n): { blocks: ContentBlock[]; parsedValue?: any; isPrimitive: boolean } {\n  // Literal primitives + special content types\n  if (typeof descriptor === 'string') {\n    switch (descriptor) {\n      case 'string':\n        return {\n          blocks: [makePrimitiveTextContent(value)],\n          parsedValue: value,\n          isPrimitive: true,\n        };\n\n      case 'number': {\n        const numValue = typeof value === 'number' ? value : Number(value);\n        return {\n          blocks: [makePrimitiveTextContent(value)],\n          parsedValue: isNaN(numValue) ? null : numValue,\n          isPrimitive: false,\n        };\n      }\n\n      case 'boolean': {\n        const boolValue = typeof value === 'boolean' ? value : Boolean(value);\n        return {\n          blocks: [makePrimitiveTextContent(value)],\n          parsedValue: boolValue,\n          isPrimitive: false,\n        };\n      }\n\n      case 'date': {\n        let dateValue: Date | null = null;\n        if (value instanceof Date) {\n          dateValue = value;\n        } else if (typeof value === 'string' || typeof value === 'number') {\n          const parsed = new Date(value);\n          if (!isNaN(parsed.getTime())) {\n            dateValue = parsed;\n          }\n        }\n\n        return {\n          blocks: [makePrimitiveTextContent(value)],\n          parsedValue: dateValue\n            ? {\n                iso: dateValue.toISOString(),\n                timeInMilli: dateValue.getTime(),\n              }\n            : null,\n          isPrimitive: false,\n        };\n      }\n\n      case 'image':\n        return {\n          blocks: toContentArray<ImageContent>('image', value),\n          parsedValue: undefined,\n          isPrimitive: false,\n        };\n\n      case 'audio':\n        return {\n          blocks: toContentArray<AudioContent>('audio', value),\n          parsedValue: undefined,\n          isPrimitive: false,\n        };\n\n      case 'resource':\n        return {\n          blocks: toContentArray<EmbeddedResource>('resource', value),\n          parsedValue: undefined,\n          isPrimitive: false,\n        };\n\n      case 'resource_link':\n        return {\n          blocks: toContentArray<ResourceLink>('resource_link', value),\n          parsedValue: undefined,\n          isPrimitive: false,\n        };\n\n      default:\n        // Unknown literal: just stringify as text\n        return {\n          blocks: [makePrimitiveTextContent(value)],\n          parsedValue: value,\n          isPrimitive: true,\n        };\n    }\n  }\n\n  // Zod primitives\n  if (descriptor instanceof ZodString) {\n    return {\n      blocks: [makePrimitiveTextContent(value)],\n      parsedValue: value,\n      isPrimitive: true,\n    };\n  }\n\n  if (descriptor instanceof ZodNumber) {\n    const parseResult = descriptor.safeParse(value);\n    const numValue = parseResult.success ? parseResult.data : typeof value === 'number' ? value : Number(value);\n    return {\n      blocks: [makePrimitiveTextContent(value)],\n      parsedValue: isNaN(numValue) ? null : numValue,\n      isPrimitive: false,\n    };\n  }\n\n  if (descriptor instanceof ZodBoolean) {\n    const parseResult = descriptor.safeParse(value);\n    const boolValue = parseResult.success ? parseResult.data : Boolean(value);\n    return {\n      blocks: [makePrimitiveTextContent(value)],\n      parsedValue: boolValue,\n      isPrimitive: false,\n    };\n  }\n\n  if (descriptor instanceof ZodBigInt) {\n    const parseResult = descriptor.safeParse(value);\n    const bigIntValue = parseResult.success ? parseResult.data : typeof value === 'bigint' ? value : null;\n    return {\n      blocks: [makePrimitiveTextContent(value)],\n      parsedValue: bigIntValue !== null ? bigIntValue.toString() : null,\n      isPrimitive: false,\n    };\n  }\n\n  if (descriptor instanceof ZodDate) {\n    const parseResult = descriptor.safeParse(value);\n    const dateValue = parseResult.success ? parseResult.data : value instanceof Date ? value : null;\n    return {\n      blocks: [makePrimitiveTextContent(value)],\n      parsedValue: dateValue\n        ? {\n            iso: dateValue.toISOString(),\n            timeInMilli: dateValue.getTime(),\n          }\n        : null,\n      isPrimitive: false,\n    };\n  }\n\n  // Anything else (Zod object/array/union, ZodRawShape, plain object) → JSON/structured\n  // Use Zod parsing if it's a Zod schema\n  let parsedValue: any;\n\n  if (descriptor instanceof z.ZodType) {\n    // Use Zod to parse and validate\n    const parseResult = descriptor.safeParse(value);\n    if (parseResult.success) {\n      parsedValue = toStructuredContent(parseResult.data);\n    } else {\n      // Validation failed, use sanitized raw value\n      parsedValue = toStructuredContent(value);\n    }\n  } else if (typeof descriptor === 'object' && descriptor !== null) {\n    // ZodRawShape or plain object - try to create a Zod object schema\n    try {\n      const schema = z.object(descriptor);\n      const parseResult = schema.safeParse(value);\n      if (parseResult.success) {\n        parsedValue = toStructuredContent(parseResult.data);\n      } else {\n        parsedValue = toStructuredContent(value);\n      }\n    } catch {\n      // Fallback to sanitized content\n      parsedValue = toStructuredContent(value);\n    }\n  } else {\n    parsedValue = toStructuredContent(value);\n  }\n\n  return {\n    blocks: [makeJsonTextContent(parsedValue)],\n    parsedValue,\n    isPrimitive: false,\n  };\n}\n\nfunction makePrimitiveTextContent(value: unknown): TextContent {\n  return {\n    type: 'text',\n    text: value == null ? '' : String(value),\n  };\n}\n\nfunction makeJsonTextContent(jsonValue: unknown): TextContent {\n  let text: string;\n  try {\n    text = JSON.stringify(jsonValue);\n  } catch {\n    text = jsonValue == null ? '' : String(jsonValue);\n  }\n  return { type: 'text', text };\n}\n\n/**\n * Normalize any `value` into an array of content objects with the given MCP `type`.\n * If `value` is already a single content object (with a matching type), it's wrapped.\n * If it's an array, every element is assumed to already be a content object.\n */\nfunction toContentArray<T extends ContentBlock>(expectedType: T['type'], value: unknown): ContentBlock[] {\n  if (Array.isArray(value)) {\n    return value.filter(Boolean).map((v) => v as T);\n  }\n\n  if (value && typeof value === 'object' && (value as any).type === expectedType) {\n    return [value as T];\n  }\n\n  // If the value is null/undefined or doesn't match, we just skip it.\n  return [];\n}\n"]}

package/src/tool/ui/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Tool UI Module
+ *
+ * Provides UI template rendering and platform-specific metadata generation
+ * for MCP tool responses.
+ *
+ * Three serving modes:
+ * - **inline**: HTML is rendered per-request and embedded in _meta['ui/html']
+ * - **static**: Static widget is pre-compiled at startup, client fetches via resources/read
+ * - **hybrid**: Shell (React + renderer) cached at startup, component + data in response
+ *
+ * NOTE: Core Tool UI functionality has moved to @frontmcp/ui/registry for standalone usage.
+ * This module re-exports from @frontmcp/ui/registry for backwards compatibility.
+ */
+export { ToolUIRegistry, renderToolTemplateAsync, renderToolTemplate, hasUIConfig, isReactComponent, containsMdxSyntax, UI_RESOURCE_SCHEME, isUIResourceUri, isStaticWidgetUri, parseWidgetUri, buildStaticWidgetUri, getUIResourceMimeType, } from '@frontmcp/ui/registry';
+export type { RenderOptions, UIRenderResult, CompileStaticWidgetOptions, HybridComponentPayload, BuildHybridComponentPayloadOptions, RenderTemplateOptions, ParsedWidgetUri, } from '@frontmcp/ui/registry';
+export { buildUIMeta } from './platform-adapters';
+export type { UIMetadata, BuildUIMetaOptions } from './platform-adapters';
+export { escapeHtml, formatDate, formatCurrency, uniqueId, jsonEmbed, createTemplateHelpers, resetIdCounter, } from './template-helpers';
+export { handleUIResourceRead, createUIResourceHandler } from './ui-resource.handler';
+export type { UIResourceHandleResult, UIResourceHandlerOptions, HandleUIResourceOptions } from './ui-resource.handler';
+export { StaticWidgetResourceTemplate } from './ui-resource-template';

package/src/tool/ui/index.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * Tool UI Module
+ *
+ * Provides UI template rendering and platform-specific metadata generation
+ * for MCP tool responses.
+ *
+ * Three serving modes:
+ * - **inline**: HTML is rendered per-request and embedded in _meta['ui/html']
+ * - **static**: Static widget is pre-compiled at startup, client fetches via resources/read
+ * - **hybrid**: Shell (React + renderer) cached at startup, component + data in response
+ *
+ * NOTE: Core Tool UI functionality has moved to @frontmcp/ui/registry for standalone usage.
+ * This module re-exports from @frontmcp/ui/registry for backwards compatibility.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StaticWidgetResourceTemplate = exports.createUIResourceHandler = exports.handleUIResourceRead = exports.resetIdCounter = exports.createTemplateHelpers = exports.jsonEmbed = exports.uniqueId = exports.formatCurrency = exports.formatDate = exports.escapeHtml = exports.buildUIMeta = exports.getUIResourceMimeType = exports.buildStaticWidgetUri = exports.parseWidgetUri = exports.isStaticWidgetUri = exports.isUIResourceUri = exports.UI_RESOURCE_SCHEME = exports.containsMdxSyntax = exports.isReactComponent = exports.hasUIConfig = exports.renderToolTemplate = exports.renderToolTemplateAsync = exports.ToolUIRegistry = void 0;
+// ============================================
+// Core Registry (from @frontmcp/ui/registry)
+// ============================================
+var registry_1 = require("@frontmcp/ui/registry");
+// Registry
+Object.defineProperty(exports, "ToolUIRegistry", { enumerable: true, get: function () { return registry_1.ToolUIRegistry; } });
+// Template rendering
+Object.defineProperty(exports, "renderToolTemplateAsync", { enumerable: true, get: function () { return registry_1.renderToolTemplateAsync; } });
+Object.defineProperty(exports, "renderToolTemplate", { enumerable: true, get: function () { return registry_1.renderToolTemplate; } });
+Object.defineProperty(exports, "hasUIConfig", { enumerable: true, get: function () { return registry_1.hasUIConfig; } });
+Object.defineProperty(exports, "isReactComponent", { enumerable: true, get: function () { return registry_1.isReactComponent; } });
+Object.defineProperty(exports, "containsMdxSyntax", { enumerable: true, get: function () { return registry_1.containsMdxSyntax; } });
+// URI utilities
+Object.defineProperty(exports, "UI_RESOURCE_SCHEME", { enumerable: true, get: function () { return registry_1.UI_RESOURCE_SCHEME; } });
+Object.defineProperty(exports, "isUIResourceUri", { enumerable: true, get: function () { return registry_1.isUIResourceUri; } });
+Object.defineProperty(exports, "isStaticWidgetUri", { enumerable: true, get: function () { return registry_1.isStaticWidgetUri; } });
+Object.defineProperty(exports, "parseWidgetUri", { enumerable: true, get: function () { return registry_1.parseWidgetUri; } });
+Object.defineProperty(exports, "buildStaticWidgetUri", { enumerable: true, get: function () { return registry_1.buildStaticWidgetUri; } });
+Object.defineProperty(exports, "getUIResourceMimeType", { enumerable: true, get: function () { return registry_1.getUIResourceMimeType; } });
+// ============================================
+// Platform Adapters (from @frontmcp/ui/adapters)
+// ============================================
+var platform_adapters_1 = require("./platform-adapters");
+Object.defineProperty(exports, "buildUIMeta", { enumerable: true, get: function () { return platform_adapters_1.buildUIMeta; } });
+// ============================================
+// Template Helpers (from @frontmcp/ui/runtime)
+// ============================================
+var template_helpers_1 = require("./template-helpers");
+Object.defineProperty(exports, "escapeHtml", { enumerable: true, get: function () { return template_helpers_1.escapeHtml; } });
+Object.defineProperty(exports, "formatDate", { enumerable: true, get: function () { return template_helpers_1.formatDate; } });
+Object.defineProperty(exports, "formatCurrency", { enumerable: true, get: function () { return template_helpers_1.formatCurrency; } });
+Object.defineProperty(exports, "uniqueId", { enumerable: true, get: function () { return template_helpers_1.uniqueId; } });
+Object.defineProperty(exports, "jsonEmbed", { enumerable: true, get: function () { return template_helpers_1.jsonEmbed; } });
+Object.defineProperty(exports, "createTemplateHelpers", { enumerable: true, get: function () { return template_helpers_1.createTemplateHelpers; } });
+Object.defineProperty(exports, "resetIdCounter", { enumerable: true, get: function () { return template_helpers_1.resetIdCounter; } });
+// ============================================
+// SDK-Specific (MCP Integration)
+// ============================================
+// UI Resource Handler - SDK-specific functions for MCP resource handling
+var ui_resource_handler_1 = require("./ui-resource.handler");
+Object.defineProperty(exports, "handleUIResourceRead", { enumerable: true, get: function () { return ui_resource_handler_1.handleUIResourceRead; } });
+Object.defineProperty(exports, "createUIResourceHandler", { enumerable: true, get: function () { return ui_resource_handler_1.createUIResourceHandler; } });
+// UI Resource Templates (for capability advertisement)
+var ui_resource_template_1 = require("./ui-resource-template");
+Object.defineProperty(exports, "StaticWidgetResourceTemplate", { enumerable: true, get: function () { return ui_resource_template_1.StaticWidgetResourceTemplate; } });
+//# sourceMappingURL=index.js.map

package/src/tool/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tool/ui/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAEH,+CAA+C;AAC/C,6CAA6C;AAC7C,+CAA+C;AAC/C,kDAgB+B;AAf7B,WAAW;AACX,0GAAA,cAAc,OAAA;AACd,qBAAqB;AACrB,mHAAA,uBAAuB,OAAA;AACvB,8GAAA,kBAAkB,OAAA;AAClB,uGAAA,WAAW,OAAA;AACX,4GAAA,gBAAgB,OAAA;AAChB,6GAAA,iBAAiB,OAAA;AACjB,gBAAgB;AAChB,8GAAA,kBAAkB,OAAA;AAClB,2GAAA,eAAe,OAAA;AACf,6GAAA,iBAAiB,OAAA;AACjB,0GAAA,cAAc,OAAA;AACd,gHAAA,oBAAoB,OAAA;AACpB,iHAAA,qBAAqB,OAAA;AAgBvB,+CAA+C;AAC/C,iDAAiD;AACjD,+CAA+C;AAC/C,yDAAkD;AAAzC,gHAAA,WAAW,OAAA;AAGpB,+CAA+C;AAC/C,+CAA+C;AAC/C,+CAA+C;AAC/C,uDAQ4B;AAP1B,8GAAA,UAAU,OAAA;AACV,8GAAA,UAAU,OAAA;AACV,kHAAA,cAAc,OAAA;AACd,4GAAA,QAAQ,OAAA;AACR,6GAAA,SAAS,OAAA;AACT,yHAAA,qBAAqB,OAAA;AACrB,kHAAA,cAAc,OAAA;AAGhB,+CAA+C;AAC/C,iCAAiC;AACjC,+CAA+C;AAC/C,yEAAyE;AACzE,6DAAsF;AAA7E,2HAAA,oBAAoB,OAAA;AAAE,8HAAA,uBAAuB,OAAA;AAGtD,uDAAuD;AACvD,+DAAsE;AAA7D,oIAAA,4BAA4B,OAAA","sourcesContent":["/**\n * Tool UI Module\n *\n * Provides UI template rendering and platform-specific metadata generation\n * for MCP tool responses.\n *\n * Three serving modes:\n * - **inline**: HTML is rendered per-request and embedded in _meta['ui/html']\n * - **static**: Static widget is pre-compiled at startup, client fetches via resources/read\n * - **hybrid**: Shell (React + renderer) cached at startup, component + data in response\n *\n * NOTE: Core Tool UI functionality has moved to @frontmcp/ui/registry for standalone usage.\n * This module re-exports from @frontmcp/ui/registry for backwards compatibility.\n */\n\n// ============================================\n// Core Registry (from @frontmcp/ui/registry)\n// ============================================\nexport {\n  // Registry\n  ToolUIRegistry,\n  // Template rendering\n  renderToolTemplateAsync,\n  renderToolTemplate,\n  hasUIConfig,\n  isReactComponent,\n  containsMdxSyntax,\n  // URI utilities\n  UI_RESOURCE_SCHEME,\n  isUIResourceUri,\n  isStaticWidgetUri,\n  parseWidgetUri,\n  buildStaticWidgetUri,\n  getUIResourceMimeType,\n} from '@frontmcp/ui/registry';\n\nexport type {\n  // Registry types\n  RenderOptions,\n  UIRenderResult,\n  CompileStaticWidgetOptions,\n  HybridComponentPayload,\n  BuildHybridComponentPayloadOptions,\n  // Template types\n  RenderTemplateOptions,\n  // URI types\n  ParsedWidgetUri,\n} from '@frontmcp/ui/registry';\n\n// ============================================\n// Platform Adapters (from @frontmcp/ui/adapters)\n// ============================================\nexport { buildUIMeta } from './platform-adapters';\nexport type { UIMetadata, BuildUIMetaOptions } from './platform-adapters';\n\n// ============================================\n// Template Helpers (from @frontmcp/ui/runtime)\n// ============================================\nexport {\n  escapeHtml,\n  formatDate,\n  formatCurrency,\n  uniqueId,\n  jsonEmbed,\n  createTemplateHelpers,\n  resetIdCounter,\n} from './template-helpers';\n\n// ============================================\n// SDK-Specific (MCP Integration)\n// ============================================\n// UI Resource Handler - SDK-specific functions for MCP resource handling\nexport { handleUIResourceRead, createUIResourceHandler } from './ui-resource.handler';\nexport type { UIResourceHandleResult, UIResourceHandlerOptions, HandleUIResourceOptions } from './ui-resource.handler';\n\n// UI Resource Templates (for capability advertisement)\nexport { StaticWidgetResourceTemplate } from './ui-resource-template';\n"]}

package/src/tool/ui/platform-adapters.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Platform Adapters
+ *
+ * Re-exports platform adapter functions from @frontmcp/ui/adapters for SDK consumers.
+ * This provides a single source of truth for platform-specific metadata building
+ * while maintaining backwards compatibility.
+ *
+ * @see {@link https://docs.agentfront.dev/docs/servers/tools#tool-ui | Tool UI Documentation}
+ */
+export { type AIPlatformType, type UIMetadata, type BuildUIMetaOptions, type BuildToolDiscoveryMetaOptions, buildUIMeta, buildToolDiscoveryMeta, buildOpenAICSP, } from '@frontmcp/ui/adapters';

package/src/tool/ui/platform-adapters.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Platform Adapters
+ *
+ * Re-exports platform adapter functions from @frontmcp/ui/adapters for SDK consumers.
+ * This provides a single source of truth for platform-specific metadata building
+ * while maintaining backwards compatibility.
+ *
+ * @see {@link https://docs.agentfront.dev/docs/servers/tools#tool-ui | Tool UI Documentation}
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildOpenAICSP = exports.buildToolDiscoveryMeta = exports.buildUIMeta = void 0;
+// Re-export platform adapter types and functions from @frontmcp/ui
+var adapters_1 = require("@frontmcp/ui/adapters");
+Object.defineProperty(exports, "buildUIMeta", { enumerable: true, get: function () { return adapters_1.buildUIMeta; } });
+Object.defineProperty(exports, "buildToolDiscoveryMeta", { enumerable: true, get: function () { return adapters_1.buildToolDiscoveryMeta; } });
+Object.defineProperty(exports, "buildOpenAICSP", { enumerable: true, get: function () { return adapters_1.buildOpenAICSP; } });
+//# sourceMappingURL=platform-adapters.js.map

package/src/tool/ui/platform-adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-adapters.js","sourceRoot":"","sources":["../../../../src/tool/ui/platform-adapters.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,mEAAmE;AACnE,kDAQ+B;AAH7B,uGAAA,WAAW,OAAA;AACX,kHAAA,sBAAsB,OAAA;AACtB,0GAAA,cAAc,OAAA","sourcesContent":["/**\n * Platform Adapters\n *\n * Re-exports platform adapter functions from @frontmcp/ui/adapters for SDK consumers.\n * This provides a single source of truth for platform-specific metadata building\n * while maintaining backwards compatibility.\n *\n * @see {@link https://docs.agentfront.dev/docs/servers/tools#tool-ui | Tool UI Documentation}\n */\n\n// Re-export platform adapter types and functions from @frontmcp/ui\nexport {\n  type AIPlatformType,\n  type UIMetadata,\n  type BuildUIMetaOptions,\n  type BuildToolDiscoveryMetaOptions,\n  buildUIMeta,\n  buildToolDiscoveryMeta,\n  buildOpenAICSP,\n} from '@frontmcp/ui/adapters';\n"]}

package/src/tool/ui/template-helpers.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Template Helpers
+ *
+ * Re-exports template helper utilities from @frontmcp/ui/runtime.
+ * Also provides individual helper functions for backwards compatibility.
+ *
+ * @see {@link https://docs.agentfront.dev/docs/servers/tools#tool-ui | Tool UI Documentation}
+ */
+import type { TemplateHelpers } from '../../common/metadata/tool-ui.metadata';
+export { createTemplateHelpers } from '@frontmcp/ui/runtime';
+/**
+ * Escape HTML special characters to prevent XSS.
+ */
+export declare function escapeHtml(str: string): string;
+/**
+ * Format a date for display.
+ * @param date - Date object or ISO string
+ * @param format - Optional format: 'iso', 'time', 'datetime', or default (localized date)
+ */
+export declare function formatDate(date: Date | string, format?: string): string;
+/**
+ * Format a number as currency.
+ * @param amount - The numeric amount
+ * @param currency - ISO 4217 currency code (default: 'USD')
+ */
+export declare function formatCurrency(amount: number, currency?: string): string;
+/**
+ * Generate a unique ID for DOM elements.
+ * @param prefix - Optional prefix for the ID
+ */
+export declare function uniqueId(prefix?: string): string;
+/**
+ * Safely embed JSON data in HTML.
+ * Escapes characters that could break out of script tags or HTML.
+ */
+export declare function jsonEmbed(data: unknown): string;
+/**
+ * Create a TemplateHelpers object with all helper functions.
+ * @deprecated Use createTemplateHelpers from @frontmcp/ui/runtime instead
+ */
+export declare function createTemplateHelpersLocal(): TemplateHelpers;
+/**
+ * Reset the ID counter (useful for testing).
+ * @internal
+ */
+export declare function resetIdCounter(): void;

package/src/tool/ui/template-helpers.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * Template Helpers
+ *
+ * Re-exports template helper utilities from @frontmcp/ui/runtime.
+ * Also provides individual helper functions for backwards compatibility.
+ *
+ * @see {@link https://docs.agentfront.dev/docs/servers/tools#tool-ui | Tool UI Documentation}
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTemplateHelpers = void 0;
+exports.escapeHtml = escapeHtml;
+exports.formatDate = formatDate;
+exports.formatCurrency = formatCurrency;
+exports.uniqueId = uniqueId;
+exports.jsonEmbed = jsonEmbed;
+exports.createTemplateHelpersLocal = createTemplateHelpersLocal;
+exports.resetIdCounter = resetIdCounter;
+// Re-export createTemplateHelpers from @frontmcp/ui
+var runtime_1 = require("@frontmcp/ui/runtime");
+Object.defineProperty(exports, "createTemplateHelpers", { enumerable: true, get: function () { return runtime_1.createTemplateHelpers; } });
+// ============================================
+// Individual Helper Functions (Backwards Compatibility)
+// ============================================
+// These are exported individually for SDK consumers who import them directly.
+// For new code, prefer using createTemplateHelpers() instead.
+let idCounter = 0;
+/**
+ * Escape HTML special characters to prevent XSS.
+ */
+function escapeHtml(str) {
+    if (typeof str !== 'string') {
+        return String(str ?? '');
+    }
+    return str
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#039;');
+}
+/**
+ * Format a date for display.
+ * @param date - Date object or ISO string
+ * @param format - Optional format: 'iso', 'time', 'datetime', or default (localized date)
+ */
+function formatDate(date, format) {
+    const d = typeof date === 'string' ? new Date(date) : date;
+    if (isNaN(d.getTime())) {
+        return String(date);
+    }
+    switch (format) {
+        case 'iso':
+            return d.toISOString();
+        case 'time':
+            return d.toLocaleTimeString();
+        case 'datetime':
+            return d.toLocaleString();
+        default:
+            return d.toLocaleDateString();
+    }
+}
+/**
+ * Format a number as currency.
+ * @param amount - The numeric amount
+ * @param currency - ISO 4217 currency code (default: 'USD')
+ */
+function formatCurrency(amount, currency = 'USD') {
+    return new Intl.NumberFormat('en-US', {
+        style: 'currency',
+        currency,
+    }).format(amount);
+}
+/**
+ * Generate a unique ID for DOM elements.
+ * @param prefix - Optional prefix for the ID
+ */
+function uniqueId(prefix = 'mcp') {
+    return `${prefix}-${++idCounter}-${Date.now().toString(36)}`;
+}
+/**
+ * Safely embed JSON data in HTML.
+ * Escapes characters that could break out of script tags or HTML.
+ */
+function jsonEmbed(data) {
+    return JSON.stringify(data)
+        .replace(/</g, '\\u003c')
+        .replace(/>/g, '\\u003e')
+        .replace(/&/g, '\\u0026')
+        .replace(/'/g, '\\u0027');
+}
+/**
+ * Create a TemplateHelpers object with all helper functions.
+ * @deprecated Use createTemplateHelpers from @frontmcp/ui/runtime instead
+ */
+function createTemplateHelpersLocal() {
+    return {
+        escapeHtml,
+        formatDate,
+        formatCurrency,
+        uniqueId,
+        jsonEmbed,
+    };
+}
+/**
+ * Reset the ID counter (useful for testing).
+ * @internal
+ */
+function resetIdCounter() {
+    idCounter = 0;
+}
+//# sourceMappingURL=template-helpers.js.map

package/src/tool/ui/template-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-helpers.js","sourceRoot":"","sources":["../../../../src/tool/ui/template-helpers.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAkBH,gCAUC;AAOD,gCAgBC;AAOD,wCAKC;AAMD,4BAEC;AAMD,8BAMC;AAMD,gEAQC;AAMD,wCAEC;AArGD,oDAAoD;AACpD,gDAA6D;AAApD,gHAAA,qBAAqB,OAAA;AAE9B,+CAA+C;AAC/C,wDAAwD;AACxD,+CAA+C;AAC/C,8EAA8E;AAC9E,8DAA8D;AAE9D,IAAI,SAAS,GAAG,CAAC,CAAC;AAElB;;GAEG;AACH,SAAgB,UAAU,CAAC,GAAW;IACpC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,GAAG;SACP,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,SAAgB,UAAU,CAAC,IAAmB,EAAE,MAAe;IAC7D,MAAM,CAAC,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3D,IAAI,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,KAAK;YACR,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QACzB,KAAK,MAAM;YACT,OAAO,CAAC,CAAC,kBAAkB,EAAE,CAAC;QAChC,KAAK,UAAU;YACb,OAAO,CAAC,CAAC,cAAc,EAAE,CAAC;QAC5B;YACE,OAAO,CAAC,CAAC,kBAAkB,EAAE,CAAC;IAClC,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,cAAc,CAAC,MAAc,EAAE,QAAQ,GAAG,KAAK;IAC7D,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE;QACpC,KAAK,EAAE,UAAU;QACjB,QAAQ;KACT,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,SAAgB,QAAQ,CAAC,MAAM,GAAG,KAAK;IACrC,OAAO,GAAG,MAAM,IAAI,EAAE,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,SAAgB,SAAS,CAAC,IAAa;IACrC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SACxB,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;SACxB,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;SACxB,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;SACxB,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,SAAgB,0BAA0B;IACxC,OAAO;QACL,UAAU;QACV,UAAU;QACV,cAAc;QACd,QAAQ;QACR,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc;IAC5B,SAAS,GAAG,CAAC,CAAC;AAChB,CAAC","sourcesContent":["/**\n * Template Helpers\n *\n * Re-exports template helper utilities from @frontmcp/ui/runtime.\n * Also provides individual helper functions for backwards compatibility.\n *\n * @see {@link https://docs.agentfront.dev/docs/servers/tools#tool-ui | Tool UI Documentation}\n */\n\nimport type { TemplateHelpers } from '../../common/metadata/tool-ui.metadata';\n\n// Re-export createTemplateHelpers from @frontmcp/ui\nexport { createTemplateHelpers } from '@frontmcp/ui/runtime';\n\n// ============================================\n// Individual Helper Functions (Backwards Compatibility)\n// ============================================\n// These are exported individually for SDK consumers who import them directly.\n// For new code, prefer using createTemplateHelpers() instead.\n\nlet idCounter = 0;\n\n/**\n * Escape HTML special characters to prevent XSS.\n */\nexport function escapeHtml(str: string): string {\n  if (typeof str !== 'string') {\n    return String(str ?? '');\n  }\n  return str\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&#039;');\n}\n\n/**\n * Format a date for display.\n * @param date - Date object or ISO string\n * @param format - Optional format: 'iso', 'time', 'datetime', or default (localized date)\n */\nexport function formatDate(date: Date | string, format?: string): string {\n  const d = typeof date === 'string' ? new Date(date) : date;\n  if (isNaN(d.getTime())) {\n    return String(date);\n  }\n\n  switch (format) {\n    case 'iso':\n      return d.toISOString();\n    case 'time':\n      return d.toLocaleTimeString();\n    case 'datetime':\n      return d.toLocaleString();\n    default:\n      return d.toLocaleDateString();\n  }\n}\n\n/**\n * Format a number as currency.\n * @param amount - The numeric amount\n * @param currency - ISO 4217 currency code (default: 'USD')\n */\nexport function formatCurrency(amount: number, currency = 'USD'): string {\n  return new Intl.NumberFormat('en-US', {\n    style: 'currency',\n    currency,\n  }).format(amount);\n}\n\n/**\n * Generate a unique ID for DOM elements.\n * @param prefix - Optional prefix for the ID\n */\nexport function uniqueId(prefix = 'mcp'): string {\n  return `${prefix}-${++idCounter}-${Date.now().toString(36)}`;\n}\n\n/**\n * Safely embed JSON data in HTML.\n * Escapes characters that could break out of script tags or HTML.\n */\nexport function jsonEmbed(data: unknown): string {\n  return JSON.stringify(data)\n    .replace(/</g, '\\\\u003c')\n    .replace(/>/g, '\\\\u003e')\n    .replace(/&/g, '\\\\u0026')\n    .replace(/'/g, '\\\\u0027');\n}\n\n/**\n * Create a TemplateHelpers object with all helper functions.\n * @deprecated Use createTemplateHelpers from @frontmcp/ui/runtime instead\n */\nexport function createTemplateHelpersLocal(): TemplateHelpers {\n  return {\n    escapeHtml,\n    formatDate,\n    formatCurrency,\n    uniqueId,\n    jsonEmbed,\n  };\n}\n\n/**\n * Reset the ID counter (useful for testing).\n * @internal\n */\nexport function resetIdCounter(): void {\n  idCounter = 0;\n}\n"]}

package/src/tool/ui/ui-resource-template.d.ts

@@ -0,0 +1,34 @@
+/**
+ * UI Resource Template for ui:// URIs
+ *
+ * Single URI pattern for widget resources:
+ *
+ * Static Widget URI: ui://widget/{toolName}.html
+ *   - Used by OpenAI at discovery/listing time
+ *   - Returns the pre-compiled static HTML for the tool
+ *   - Widget reads tool output from platform context (e.g., window.openai.toolOutput)
+ *
+ * The actual read logic is handled by ReadResourceFlow's ui:// interception
+ * in read-resource.flow.ts.
+ *
+ * IMPORTANT: Resources MUST be visible in resources/list for OpenAI ChatGPT
+ * to discover and render widgets.
+ */
+/**
+ * Static Widget Resource Template for OpenAI discovery.
+ *
+ * URI format: ui://widget/{toolName}.html
+ *
+ * This is the format OpenAI expects in tools/list _meta.openai/outputTemplate.
+ * When OpenAI fetches this resource, we return the pre-compiled static HTML for the tool.
+ *
+ * The widget includes:
+ * - FrontMCP Bridge for reading tool output from platform context
+ * - CDN scripts for React/MDX/etc (based on uiType)
+ * - Pre-transpiled component embedded in HTML
+ *
+ * At runtime, the widget reads tool output from:
+ * - OpenAI: window.openai.toolOutput
+ * - Generic: window.__mcpToolOutput
+ */
+export declare const StaticWidgetResourceTemplate: () => import("../../common/decorators/resource.decorator").FrontMcpResourceTemplateExecuteHandler;

package/src/tool/ui/ui-resource-template.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * UI Resource Template for ui:// URIs
+ *
+ * Single URI pattern for widget resources:
+ *
+ * Static Widget URI: ui://widget/{toolName}.html
+ *   - Used by OpenAI at discovery/listing time
+ *   - Returns the pre-compiled static HTML for the tool
+ *   - Widget reads tool output from platform context (e.g., window.openai.toolOutput)
+ *
+ * The actual read logic is handled by ReadResourceFlow's ui:// interception
+ * in read-resource.flow.ts.
+ *
+ * IMPORTANT: Resources MUST be visible in resources/list for OpenAI ChatGPT
+ * to discover and render widgets.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StaticWidgetResourceTemplate = void 0;
+const resource_decorator_1 = require("../../common/decorators/resource.decorator");
+const template_helpers_1 = require("./template-helpers");
+/**
+ * Static Widget Resource Template for OpenAI discovery.
+ *
+ * URI format: ui://widget/{toolName}.html
+ *
+ * This is the format OpenAI expects in tools/list _meta.openai/outputTemplate.
+ * When OpenAI fetches this resource, we return the pre-compiled static HTML for the tool.
+ *
+ * The widget includes:
+ * - FrontMCP Bridge for reading tool output from platform context
+ * - CDN scripts for React/MDX/etc (based on uiType)
+ * - Pre-transpiled component embedded in HTML
+ *
+ * At runtime, the widget reads tool output from:
+ * - OpenAI: window.openai.toolOutput
+ * - Generic: window.__mcpToolOutput
+ */
+exports.StaticWidgetResourceTemplate = (0, resource_decorator_1.resourceTemplate)({
+    name: 'static-widget',
+    description: 'Static widget HTML for tool UI (OpenAI discovery)',
+    uriTemplate: 'ui://widget/{toolName}.html',
+    mimeType: 'text/html+skybridge',
+})((uri, params) => {
+    // This handler should NOT be called because ReadResourceFlow
+    // intercepts ui:// URIs before reaching the resource instance.
+    return {
+        contents: [
+            {
+                uri,
+                mimeType: 'text/html+skybridge',
+                text: `<!DOCTYPE html>
+<html>
+<head><title>Widget Placeholder</title></head>
+<body>
+  <p>Widget for tool: ${(0, template_helpers_1.escapeHtml)(String(params['toolName'] || 'unknown'))}</p>
+  <p>This is a placeholder. The actual widget HTML is served from the ToolUIRegistry cache.</p>
+</body>
+</html>`,
+            },
+        ],
+    };
+});
+//# sourceMappingURL=ui-resource-template.js.map

package/src/tool/ui/ui-resource-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-resource-template.js","sourceRoot":"","sources":["../../../../src/tool/ui/ui-resource-template.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAEH,mFAA8E;AAC9E,yDAAgD;AAEhD;;;;;;;;;;;;;;;;GAgBG;AACU,QAAA,4BAA4B,GAAG,IAAA,qCAAgB,EAAC;IAC3D,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,mDAAmD;IAChE,WAAW,EAAE,6BAA6B;IAC1C,QAAQ,EAAE,qBAAqB;CAChC,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;IACjB,6DAA6D;IAC7D,+DAA+D;IAC/D,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,GAAG;gBACH,QAAQ,EAAE,qBAAqB;gBAC/B,IAAI,EAAE;;;;wBAIU,IAAA,6BAAU,EAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC,CAAC;;;QAGnE;aACD;SACF;KACF,CAAC;AACJ,CAAC,CAAC,CAAC","sourcesContent":["/**\n * UI Resource Template for ui:// URIs\n *\n * Single URI pattern for widget resources:\n *\n * Static Widget URI: ui://widget/{toolName}.html\n *   - Used by OpenAI at discovery/listing time\n *   - Returns the pre-compiled static HTML for the tool\n *   - Widget reads tool output from platform context (e.g., window.openai.toolOutput)\n *\n * The actual read logic is handled by ReadResourceFlow's ui:// interception\n * in read-resource.flow.ts.\n *\n * IMPORTANT: Resources MUST be visible in resources/list for OpenAI ChatGPT\n * to discover and render widgets.\n */\n\nimport { resourceTemplate } from '../../common/decorators/resource.decorator';\nimport { escapeHtml } from './template-helpers';\n\n/**\n * Static Widget Resource Template for OpenAI discovery.\n *\n * URI format: ui://widget/{toolName}.html\n *\n * This is the format OpenAI expects in tools/list _meta.openai/outputTemplate.\n * When OpenAI fetches this resource, we return the pre-compiled static HTML for the tool.\n *\n * The widget includes:\n * - FrontMCP Bridge for reading tool output from platform context\n * - CDN scripts for React/MDX/etc (based on uiType)\n * - Pre-transpiled component embedded in HTML\n *\n * At runtime, the widget reads tool output from:\n * - OpenAI: window.openai.toolOutput\n * - Generic: window.__mcpToolOutput\n */\nexport const StaticWidgetResourceTemplate = resourceTemplate({\n  name: 'static-widget',\n  description: 'Static widget HTML for tool UI (OpenAI discovery)',\n  uriTemplate: 'ui://widget/{toolName}.html',\n  mimeType: 'text/html+skybridge',\n})((uri, params) => {\n  // This handler should NOT be called because ReadResourceFlow\n  // intercepts ui:// URIs before reaching the resource instance.\n  return {\n    contents: [\n      {\n        uri,\n        mimeType: 'text/html+skybridge',\n        text: `<!DOCTYPE html>\n<html>\n<head><title>Widget Placeholder</title></head>\n<body>\n  <p>Widget for tool: ${escapeHtml(String(params['toolName'] || 'unknown'))}</p>\n  <p>This is a placeholder. The actual widget HTML is served from the ToolUIRegistry cache.</p>\n</body>\n</html>`,\n      },\n    ],\n  };\n});\n"]}

package/src/tool/ui/ui-resource.handler.d.ts

@@ -0,0 +1,74 @@
+/**
+ * UI Resource Handler
+ *
+ * Handles resources/read requests for ui:// URIs, serving widget HTML
+ * from the ToolUIRegistry.
+ *
+ * Supported URI format:
+ * - ui://widget/{toolName}.html - Static widget HTML (pre-compiled at startup)
+ *
+ * The static widget is registered at server startup for tools with
+ * `servingMode: 'static'`. The widget HTML includes the FrontMCP Bridge
+ * which reads tool output from the platform context at runtime.
+ *
+ * @example
+ * ```typescript
+ * // Client requests widget HTML (OpenAI discovery)
+ * const result = await client.readResource({
+ *   uri: 'ui://widget/get_weather.html'
+ * });
+ *
+ * // Returns pre-compiled widget with FrontMCP Bridge
+ * // Widget reads tool output from window.openai.toolOutput at runtime
+ * ```
+ */
+import type { ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
+import type { AIPlatformType } from '../../notification/notification.service';
+import { type ToolUIRegistry } from '@frontmcp/ui/registry';
+/**
+ * Result of handling a UI resource request
+ */
+export interface UIResourceHandleResult {
+    /** Whether the URI was handled */
+    handled: boolean;
+    /** The resource result if handled successfully */
+    result?: ReadResourceResult;
+    /** Error message if handling failed */
+    error?: string;
+}
+/**
+ * Options for handling a UI resource read request
+ */
+export interface HandleUIResourceOptions {
+    /** The UI resource URI */
+    uri: string;
+    /** The ToolUIRegistry containing cached HTML */
+    registry: ToolUIRegistry;
+    /** Platform type of the connected client */
+    platformType?: AIPlatformType;
+}
+/**
+ * Handle a UI resource read request
+ *
+ * @param uri - The UI resource URI
+ * @param registry - The ToolUIRegistry containing cached HTML
+ * @param platformType - Optional platform type for dynamic MIME type selection
+ * @returns Handle result with content or error
+ */
+export declare function handleUIResourceRead(uri: string, registry: ToolUIRegistry, platformType?: AIPlatformType): UIResourceHandleResult;
+/**
+ * Options for creating a UI resource handler
+ */
+export interface UIResourceHandlerOptions {
+    /** ToolUIRegistry instance */
+    registry: ToolUIRegistry;
+    /** Optional custom error handler */
+    onError?: (error: string, uri: string) => void;
+}
+/**
+ * Create a UI resource handler function
+ *
+ * @param options - Handler options
+ * @returns Handler function that can be used in the read-resource flow
+ */
+export declare function createUIResourceHandler(options: UIResourceHandlerOptions): (uri: string) => UIResourceHandleResult;