@frontmcp/sdk 0.6.0 → 0.6.2

package/src/tool/tool.utils.js

@@ -1,366 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.qualifiedNameOf = exports.ownerKeyOf = exports.ensureMaxLen = exports.shortHash = exports.normalizeOwnerPath = exports.normalizeProviderId = exports.normalizeSegment = exports.sepFor = exports.toCase = exports.splitWords = void 0;
-exports.collectToolMetadata = collectToolMetadata;
-exports.normalizeTool = normalizeTool;
-exports.toolDiscoveryDeps = toolDiscoveryDeps;
-exports.buildParsedToolResult = buildParsedToolResult;
-// file: libs/sdk/src/tool/tool.utils.ts
-const common_1 = require("../common");
-const token_utils_1 = require("../utils/token.utils");
-const metadata_utils_1 = require("../utils/metadata.utils");
-const content_utils_1 = require("../utils/content.utils");
-const zod_1 = require("zod");
-// Re-export shared naming utilities for backwards compatibility
-var naming_utils_1 = require("../utils/naming.utils");
-Object.defineProperty(exports, "splitWords", { enumerable: true, get: function () { return naming_utils_1.splitWords; } });
-Object.defineProperty(exports, "toCase", { enumerable: true, get: function () { return naming_utils_1.toCase; } });
-Object.defineProperty(exports, "sepFor", { enumerable: true, get: function () { return naming_utils_1.sepFor; } });
-Object.defineProperty(exports, "normalizeSegment", { enumerable: true, get: function () { return naming_utils_1.normalizeSegment; } });
-Object.defineProperty(exports, "normalizeProviderId", { enumerable: true, get: function () { return naming_utils_1.normalizeProviderId; } });
-Object.defineProperty(exports, "normalizeOwnerPath", { enumerable: true, get: function () { return naming_utils_1.normalizeOwnerPath; } });
-Object.defineProperty(exports, "shortHash", { enumerable: true, get: function () { return naming_utils_1.shortHash; } });
-Object.defineProperty(exports, "ensureMaxLen", { enumerable: true, get: function () { return naming_utils_1.ensureMaxLen; } });
-// Re-export shared lineage utilities for backwards compatibility
-var lineage_utils_1 = require("../utils/lineage.utils");
-Object.defineProperty(exports, "ownerKeyOf", { enumerable: true, get: function () { return lineage_utils_1.ownerKeyOf; } });
-Object.defineProperty(exports, "qualifiedNameOf", { enumerable: true, get: function () { return lineage_utils_1.qualifiedNameOf; } });
-function collectToolMetadata(cls) {
-    const extended = (0, metadata_utils_1.getMetadata)(common_1.extendedToolMetadata, cls);
-    const seed = (extended ? { ...extended } : {});
-    return Object.entries(common_1.FrontMcpToolTokens).reduce((metadata, [key, token]) => {
-        const value = (0, metadata_utils_1.getMetadata)(token, cls);
-        if (value) {
-            return Object.assign(metadata, {
-                [key]: value,
-            });
-        }
-        else {
-            return metadata;
-        }
-    }, seed);
-}
-function normalizeTool(item) {
-    if (item &&
-        typeof item === 'function' &&
-        item[common_1.FrontMcpToolTokens.type] === 'function-tool' &&
-        item[common_1.FrontMcpToolTokens.metadata]) {
-        return {
-            kind: common_1.ToolKind.FUNCTION,
-            provide: item(),
-            metadata: item[common_1.FrontMcpToolTokens.metadata],
-        };
-    }
-    if ((0, token_utils_1.isClass)(item)) {
-        // read McpToolMetadata from class
-        const metadata = collectToolMetadata(item);
-        return { kind: common_1.ToolKind.CLASS_TOKEN, provide: item, metadata };
-    }
-    const name = item?.name ?? String(item);
-    throw new Error(`Invalid adapter '${name}'. Expected a class or a adapter object.`);
-}
-/**
- * For graph/cycle detection. Returns dependency tokens that should be graphed.
- * - FUNCTION: get function params without the first argument (the tool input)
- * - CLASS_TOKEN: deps come from the class constructor
- */
-function toolDiscoveryDeps(rec) {
-    switch (rec.kind) {
-        case common_1.ToolKind.FUNCTION: {
-            return (0, token_utils_1.depsOfFunc)(rec.provide, 'discovery');
-        }
-        case common_1.ToolKind.CLASS_TOKEN:
-            return (0, token_utils_1.depsOfClass)(rec.provide, 'discovery');
-    }
-}
-function buildParsedToolResult(descriptor, raw) {
-    const content = [];
-    let structuredData;
-    // No outputSchema → the best effort: treat the result as structured JSON and text fallback
-    if (!descriptor) {
-        const structuredContent = (0, content_utils_1.toStructuredContent)(raw);
-        const sanitized = structuredContent ?? raw;
-        content.push(makeJsonTextContent(sanitized));
-        return { content, structuredContent };
-    }
-    if (Array.isArray(descriptor)) {
-        // Multiple content items; expect raw to be an array of the same length.
-        const values = Array.isArray(raw) ? raw : [raw];
-        const parsedItems = [];
-        // Parse all items first
-        descriptor.forEach((singleDescriptor, idx) => {
-            const value = values[idx];
-            const { blocks, parsedValue, isPrimitive } = parseSingleValue(singleDescriptor, value);
-            parsedItems.push({ blocks, parsedValue, isPrimitive });
-            content.push(...blocks);
-        });
-        // Check if we have at least one non-primitive item
-        const hasNonPrimitive = parsedItems.some((item) => !item.isPrimitive);
-        if (hasNonPrimitive && parsedItems.length > 1) {
-            // Multiple items with at least one non-string/primitive: use numeric indices
-            structuredData = {};
-            parsedItems.forEach((item, idx) => {
-                if (item.parsedValue !== undefined) {
-                    structuredData[idx] = item.parsedValue;
-                }
-            });
-        }
-        else if (parsedItems.length === 1 && parsedItems[0].parsedValue !== undefined) {
-            // Single item: wrap primitives in {content: value}, use objects directly
-            if (parsedItems[0].isPrimitive) {
-                structuredData = { content: parsedItems[0].parsedValue };
-            }
-            else if (typeof parsedItems[0].parsedValue === 'object' && parsedItems[0].parsedValue !== null) {
-                // Non-primitive object (date, json, etc.) - use directly
-                structuredData = parsedItems[0].parsedValue;
-            }
-            else {
-                // Non-primitive but not an object (shouldn't happen, but handle it)
-                structuredData = { content: parsedItems[0].parsedValue };
-            }
-        }
-        else if (hasNonPrimitive) {
-            // Multiple items but only one has a value
-            structuredData = {};
-            parsedItems.forEach((item, idx) => {
-                if (item.parsedValue !== undefined) {
-                    structuredData[idx] = item.parsedValue;
-                }
-            });
-        }
-    }
-    else {
-        const { blocks, parsedValue, isPrimitive } = parseSingleValue(descriptor, raw);
-        content.push(...blocks);
-        // Single item: wrap primitives in {content: value}, use objects directly
-        if (parsedValue !== undefined) {
-            if (isPrimitive) {
-                structuredData = { content: parsedValue };
-            }
-            else if (typeof parsedValue === 'object' && parsedValue !== null) {
-                // Non-primitive object (date, json, etc.) - use directly
-                structuredData = parsedValue;
-            }
-            else {
-                // Non-primitive but not an object (number, boolean, etc.) - wrap it
-                structuredData = { content: parsedValue };
-            }
-        }
-    }
-    const result = { content };
-    // Add structuredContent if we have structured data
-    if (structuredData !== undefined) {
-        result.structuredContent = structuredData;
-    }
-    return result;
-}
-/**
- * Parse a single schema descriptor + value into one or more ContentBlocks.
- *
- * Returns:
- *   - blocks: content blocks to append
- *   - parsedValue: the parsed/validated value (for structuredContent)
- *   - isPrimitive: whether this is a primitive string type
- */
-function parseSingleValue(descriptor, value) {
-    // Literal primitives + special content types
-    if (typeof descriptor === 'string') {
-        switch (descriptor) {
-            case 'string':
-                return {
-                    blocks: [makePrimitiveTextContent(value)],
-                    parsedValue: value,
-                    isPrimitive: true,
-                };
-            case 'number': {
-                const numValue = typeof value === 'number' ? value : Number(value);
-                return {
-                    blocks: [makePrimitiveTextContent(value)],
-                    parsedValue: isNaN(numValue) ? null : numValue,
-                    isPrimitive: false,
-                };
-            }
-            case 'boolean': {
-                const boolValue = typeof value === 'boolean' ? value : Boolean(value);
-                return {
-                    blocks: [makePrimitiveTextContent(value)],
-                    parsedValue: boolValue,
-                    isPrimitive: false,
-                };
-            }
-            case 'date': {
-                let dateValue = null;
-                if (value instanceof Date) {
-                    dateValue = value;
-                }
-                else if (typeof value === 'string' || typeof value === 'number') {
-                    const parsed = new Date(value);
-                    if (!isNaN(parsed.getTime())) {
-                        dateValue = parsed;
-                    }
-                }
-                return {
-                    blocks: [makePrimitiveTextContent(value)],
-                    parsedValue: dateValue
-                        ? {
-                            iso: dateValue.toISOString(),
-                            timeInMilli: dateValue.getTime(),
-                        }
-                        : null,
-                    isPrimitive: false,
-                };
-            }
-            case 'image':
-                return {
-                    blocks: toContentArray('image', value),
-                    parsedValue: undefined,
-                    isPrimitive: false,
-                };
-            case 'audio':
-                return {
-                    blocks: toContentArray('audio', value),
-                    parsedValue: undefined,
-                    isPrimitive: false,
-                };
-            case 'resource':
-                return {
-                    blocks: toContentArray('resource', value),
-                    parsedValue: undefined,
-                    isPrimitive: false,
-                };
-            case 'resource_link':
-                return {
-                    blocks: toContentArray('resource_link', value),
-                    parsedValue: undefined,
-                    isPrimitive: false,
-                };
-            default:
-                // Unknown literal: just stringify as text
-                return {
-                    blocks: [makePrimitiveTextContent(value)],
-                    parsedValue: value,
-                    isPrimitive: true,
-                };
-        }
-    }
-    // Zod primitives
-    if (descriptor instanceof zod_1.ZodString) {
-        return {
-            blocks: [makePrimitiveTextContent(value)],
-            parsedValue: value,
-            isPrimitive: true,
-        };
-    }
-    if (descriptor instanceof zod_1.ZodNumber) {
-        const parseResult = descriptor.safeParse(value);
-        const numValue = parseResult.success ? parseResult.data : typeof value === 'number' ? value : Number(value);
-        return {
-            blocks: [makePrimitiveTextContent(value)],
-            parsedValue: isNaN(numValue) ? null : numValue,
-            isPrimitive: false,
-        };
-    }
-    if (descriptor instanceof zod_1.ZodBoolean) {
-        const parseResult = descriptor.safeParse(value);
-        const boolValue = parseResult.success ? parseResult.data : Boolean(value);
-        return {
-            blocks: [makePrimitiveTextContent(value)],
-            parsedValue: boolValue,
-            isPrimitive: false,
-        };
-    }
-    if (descriptor instanceof zod_1.ZodBigInt) {
-        const parseResult = descriptor.safeParse(value);
-        const bigIntValue = parseResult.success ? parseResult.data : typeof value === 'bigint' ? value : null;
-        return {
-            blocks: [makePrimitiveTextContent(value)],
-            parsedValue: bigIntValue !== null ? bigIntValue.toString() : null,
-            isPrimitive: false,
-        };
-    }
-    if (descriptor instanceof zod_1.ZodDate) {
-        const parseResult = descriptor.safeParse(value);
-        const dateValue = parseResult.success ? parseResult.data : value instanceof Date ? value : null;
-        return {
-            blocks: [makePrimitiveTextContent(value)],
-            parsedValue: dateValue
-                ? {
-                    iso: dateValue.toISOString(),
-                    timeInMilli: dateValue.getTime(),
-                }
-                : null,
-            isPrimitive: false,
-        };
-    }
-    // Anything else (Zod object/array/union, ZodRawShape, plain object) → JSON/structured
-    // Use Zod parsing if it's a Zod schema
-    let parsedValue;
-    if (descriptor instanceof zod_1.z.ZodType) {
-        // Use Zod to parse and validate
-        const parseResult = descriptor.safeParse(value);
-        if (parseResult.success) {
-            parsedValue = (0, content_utils_1.toStructuredContent)(parseResult.data);
-        }
-        else {
-            // Validation failed, use sanitized raw value
-            parsedValue = (0, content_utils_1.toStructuredContent)(value);
-        }
-    }
-    else if (typeof descriptor === 'object' && descriptor !== null) {
-        // ZodRawShape or plain object - try to create a Zod object schema
-        try {
-            const schema = zod_1.z.object(descriptor);
-            const parseResult = schema.safeParse(value);
-            if (parseResult.success) {
-                parsedValue = (0, content_utils_1.toStructuredContent)(parseResult.data);
-            }
-            else {
-                parsedValue = (0, content_utils_1.toStructuredContent)(value);
-            }
-        }
-        catch {
-            // Fallback to sanitized content
-            parsedValue = (0, content_utils_1.toStructuredContent)(value);
-        }
-    }
-    else {
-        parsedValue = (0, content_utils_1.toStructuredContent)(value);
-    }
-    return {
-        blocks: [makeJsonTextContent(parsedValue)],
-        parsedValue,
-        isPrimitive: false,
-    };
-}
-function makePrimitiveTextContent(value) {
-    return {
-        type: 'text',
-        text: value == null ? '' : String(value),
-    };
-}
-function makeJsonTextContent(jsonValue) {
-    let text;
-    try {
-        text = JSON.stringify(jsonValue);
-    }
-    catch {
-        text = jsonValue == null ? '' : String(jsonValue);
-    }
-    return { type: 'text', text };
-}
-/**
- * Normalize any `value` into an array of content objects with the given MCP `type`.
- * If `value` is already a single content object (with a matching type), it's wrapped.
- * If it's an array, every element is assumed to already be a content object.
- */
-function toContentArray(expectedType, value) {
-    if (Array.isArray(value)) {
-        return value.filter(Boolean).map((v) => v);
-    }
-    if (value && typeof value === 'object' && value.type === expectedType) {
-        return [value];
-    }
-    // If the value is null/undefined or doesn't match, we just skip it.
-    return [];
-}
-//# sourceMappingURL=tool.utils.js.map

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

@@ -1 +0,0 @@
-{"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.js

@@ -1,63 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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.js

@@ -1,18 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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.js

@@ -1,112 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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"]}