@frontmcp/sdk 0.6.0 → 0.6.2

package/src/types/drinen-hooks.types.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=drinen-hooks.types.js.map

package/src/types/drinen-hooks.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"drinen-hooks.types.js","sourceRoot":"","sources":["../../../src/types/drinen-hooks.types.ts"],"names":[],"mappings":"","sourcesContent":["import { Type } from '../common';\n\nexport type AnyStage = string & {};\n\n\nexport interface GenericHook<Ctx = unknown> {\n  providedBy: string;\n  priority?(): number;\n  filter?(ctx: Ctx): boolean | Promise<boolean>;\n  aroundExecute?: (ctx: Ctx, next: () => Promise<unknown>) => Promise<unknown>;\n  [stage: string]: any; // stage handler methods (will*/did*/on*)\n}\n\nexport interface CollectHooksFn<Ctx> {\n  (\n    stage: AnyStage,\n    options: {\n      resolve: <T>(cls: any) => T;\n      globalHooksByStage?: Partial<Record<AnyStage, Type[]>>;\n      localHooksByStage?: Partial<Record<AnyStage, Type[]>>;\n      ctx: Ctx;\n      owner?: { name?: string };\n    },\n  ): Promise<GenericHook<Ctx>[]>;\n}\n"]}

package/src/types/invoke.type.js

@@ -1,34 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ControlRetryAfter = exports.ControlAbort = exports.ControlRespond = void 0;
-class ControlRespond extends Error {
-    value;
-    constructor(value) {
-        super('CONTROL_RESPOND');
-        this.value = value;
-    }
-}
-exports.ControlRespond = ControlRespond;
-class ControlAbort extends Error {
-    reason;
-    code;
-    httpStatus;
-    constructor(reason, code, httpStatus) {
-        super('CONTROL_ABORT');
-        this.reason = reason;
-        this.code = code;
-        this.httpStatus = httpStatus;
-    }
-}
-exports.ControlAbort = ControlAbort;
-class ControlRetryAfter extends Error {
-    ms;
-    reason;
-    constructor(ms, reason) {
-        super('CONTROL_RETRY_AFTER');
-        this.ms = ms;
-        this.reason = reason;
-    }
-}
-exports.ControlRetryAfter = ControlRetryAfter;
-//# sourceMappingURL=invoke.type.js.map

package/src/types/invoke.type.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"invoke.type.js","sourceRoot":"","sources":["../../../src/types/invoke.type.ts"],"names":[],"mappings":";;;AAAA,MAAa,cAAe,SAAQ,KAAK;IACpB;IAAnB,YAAmB,KAAc;QAC/B,KAAK,CAAC,iBAAiB,CAAC,CAAC;QADR,UAAK,GAAL,KAAK,CAAS;IAEjC,CAAC;CACF;AAJD,wCAIC;AACD,MAAa,YAAa,SAAQ,KAAK;IAE5B;IACA;IACA;IAHT,YACS,MAAc,EACd,IAAa,EACb,UAAmB;QAE1B,KAAK,CAAC,eAAe,CAAC,CAAC;QAJhB,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAS;QACb,eAAU,GAAV,UAAU,CAAS;IAG5B,CAAC;CACF;AARD,oCAQC;AACD,MAAa,iBAAkB,SAAQ,KAAK;IACvB;IAAmB;IAAtC,YAAmB,EAAU,EAAS,MAAe;QACnD,KAAK,CAAC,qBAAqB,CAAC,CAAC;QADZ,OAAE,GAAF,EAAE,CAAQ;QAAS,WAAM,GAAN,MAAM,CAAS;IAErD,CAAC;CACF;AAJD,8CAIC","sourcesContent":["export class ControlRespond extends Error {\n  constructor(public value: unknown) {\n    super('CONTROL_RESPOND');\n  }\n}\nexport class ControlAbort extends Error {\n  constructor(\n    public reason: string,\n    public code?: string,\n    public httpStatus?: number\n  ) {\n    super('CONTROL_ABORT');\n  }\n}\nexport class ControlRetryAfter extends Error {\n  constructor(public ms: number, public reason?: string) {\n    super('CONTROL_RETRY_AFTER');\n  }\n}\n"]}

package/src/types/token.types.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=token.types.js.map

package/src/types/token.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"token.types.js","sourceRoot":"","sources":["../../../src/types/token.types.ts"],"names":[],"mappings":"","sourcesContent":["import { Type } from '../common';\n\nexport type Ctor<T> = new (...args: any[]) => T;\n"]}

package/src/utils/content.utils.js

@@ -1,194 +0,0 @@
-"use strict";
-// file: libs/sdk/src/utils/content.utils.ts
-// Content building and sanitization utilities for MCP responses
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.sanitizeToJson = sanitizeToJson;
-exports.toStructuredContent = toStructuredContent;
-exports.buildResourceContent = buildResourceContent;
-exports.inferMimeType = inferMimeType;
-/**
- * Sanitize arbitrary JS values into JSON-safe objects suitable for:
- *   - MCP `structuredContent`
- *   - JSON.stringify without circular reference errors
- *
- * Rules:
- *   - Drop functions and symbols.
- *   - BigInt → string.
- *   - Date → ISO string.
- *   - Error → { name, message, stack }.
- *   - Map → plain object.
- *   - Set → array.
- *   - Protect against circular references via WeakSet.
- */
-function sanitizeToJson(value) {
-    const seen = new WeakSet();
-    function sanitize(val) {
-        if (typeof val === 'function' || typeof val === 'symbol') {
-            return undefined;
-        }
-        if (typeof val === 'bigint') {
-            return val.toString();
-        }
-        if (val instanceof Date) {
-            return val.toISOString();
-        }
-        if (val instanceof Error) {
-            return {
-                name: val.name,
-                message: val.message,
-                stack: val.stack,
-            };
-        }
-        if (val instanceof Map) {
-            const obj = {};
-            for (const [k, v] of val.entries()) {
-                obj[String(k)] = sanitize(v);
-            }
-            return obj;
-        }
-        if (val instanceof Set) {
-            return Array.from(val).map(sanitize);
-        }
-        if (Array.isArray(val)) {
-            if (seen.has(val)) {
-                return undefined;
-            }
-            seen.add(val);
-            return val.map(sanitize);
-        }
-        if (val && typeof val === 'object') {
-            if (seen.has(val)) {
-                // Drop circular references
-                return undefined;
-            }
-            seen.add(val);
-            const sanitized = {};
-            for (const [key, value] of Object.entries(val)) {
-                const clean = sanitize(value);
-                if (clean !== undefined) {
-                    sanitized[key] = clean;
-                }
-            }
-            return sanitized;
-        }
-        // Primitives pass through
-        return val;
-    }
-    return sanitize(value);
-}
-/**
- * Convert a value to MCP structuredContent format.
- * Returns Record<string, unknown> or undefined (matching MCP's structuredContent type).
- * Primitives and arrays are wrapped in { value: ... }.
- */
-function toStructuredContent(value) {
-    const result = sanitizeToJson(value);
-    if (result === undefined || result === null)
-        return undefined;
-    if (typeof result === 'object' && !Array.isArray(result)) {
-        return result;
-    }
-    // Wrap primitives and arrays in an object
-    return { value: result };
-}
-/**
- * Build a resource content item for MCP ReadResourceResult format.
- * Handles both text and binary (blob) content.
- *
- * @param uri - The resource URI
- * @param content - The content to serialize (string, Buffer, object, etc.)
- * @param mimeType - Optional MIME type override
- */
-function buildResourceContent(uri, content, mimeType) {
-    // If content is already in the expected format
-    if (content && typeof content === 'object') {
-        const obj = content;
-        if ('blob' in obj && typeof obj['blob'] === 'string') {
-            return {
-                uri,
-                mimeType: obj['mimeType'] || mimeType,
-                blob: obj['blob'],
-            };
-        }
-        if ('text' in obj && typeof obj['text'] === 'string') {
-            return {
-                uri,
-                mimeType: obj['mimeType'] || mimeType,
-                text: obj['text'],
-            };
-        }
-    }
-    // Binary content (Buffer, Uint8Array)
-    if (Buffer.isBuffer(content) || content instanceof Uint8Array) {
-        const buffer = Buffer.isBuffer(content) ? content : Buffer.from(content);
-        return {
-            uri,
-            mimeType: mimeType || 'application/octet-stream',
-            blob: buffer.toString('base64'),
-        };
-    }
-    // String content
-    if (typeof content === 'string') {
-        return {
-            uri,
-            mimeType: mimeType || 'text/plain',
-            text: content,
-        };
-    }
-    // JSON-serializable content
-    try {
-        return {
-            uri,
-            mimeType: mimeType || 'application/json',
-            text: JSON.stringify(content),
-        };
-    }
-    catch {
-        return {
-            uri,
-            mimeType: mimeType || 'text/plain',
-            text: String(content),
-        };
-    }
-}
-/**
- * Infer MIME type from file extension or content.
- */
-function inferMimeType(uri, content) {
-    // Try to infer from URI extension
-    const ext = uri.split('.').pop()?.toLowerCase();
-    const mimeTypes = {
-        json: 'application/json',
-        xml: 'application/xml',
-        html: 'text/html',
-        htm: 'text/html',
-        css: 'text/css',
-        js: 'application/javascript',
-        ts: 'application/typescript',
-        txt: 'text/plain',
-        md: 'text/markdown',
-        yaml: 'application/yaml',
-        yml: 'application/yaml',
-        csv: 'text/csv',
-        png: 'image/png',
-        jpg: 'image/jpeg',
-        jpeg: 'image/jpeg',
-        gif: 'image/gif',
-        svg: 'image/svg+xml',
-        pdf: 'application/pdf',
-    };
-    if (ext && mimeTypes[ext]) {
-        return mimeTypes[ext];
-    }
-    // Try to infer from content
-    if (typeof content === 'string') {
-        if (content.trim().startsWith('{') || content.trim().startsWith('[')) {
-            return 'application/json';
-        }
-        if (content.trim().startsWith('<')) {
-            return content.includes('<!DOCTYPE html') || content.includes('<html') ? 'text/html' : 'application/xml';
-        }
-    }
-    return 'text/plain';
-}
-//# sourceMappingURL=content.utils.js.map

package/src/utils/content.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"content.utils.js","sourceRoot":"","sources":["../../../src/utils/content.utils.ts"],"names":[],"mappings":"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","sourcesContent":["// file: libs/sdk/src/utils/content.utils.ts\n// Content building and sanitization utilities for MCP responses\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 */\nexport function sanitizeToJson(value: unknown): unknown {\n  const seen = new WeakSet<object>();\n\n  function sanitize(val: unknown): unknown {\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, unknown> = {};\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      if (seen.has(val)) {\n        return undefined;\n      }\n      seen.add(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, unknown> = {};\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\n/**\n * Convert a value to MCP structuredContent format.\n * Returns Record<string, unknown> or undefined (matching MCP's structuredContent type).\n * Primitives and arrays are wrapped in { value: ... }.\n */\nexport function toStructuredContent(value: unknown): Record<string, unknown> | undefined {\n  const result = sanitizeToJson(value);\n  if (result === undefined || result === null) return undefined;\n  if (typeof result === 'object' && !Array.isArray(result)) {\n    return result as Record<string, unknown>;\n  }\n  // Wrap primitives and arrays in an object\n  return { value: result };\n}\n\n/** MCP-compatible text resource content */\nexport type TextContent = {\n  uri: string;\n  mimeType?: string;\n  text: string;\n};\n\n/** MCP-compatible blob resource content */\nexport type BlobContent = {\n  uri: string;\n  mimeType?: string;\n  blob: string;\n};\n\n/** MCP-compatible resource content (text or blob) */\nexport type ResourceContent = TextContent | BlobContent;\n\n/**\n * Build a resource content item for MCP ReadResourceResult format.\n * Handles both text and binary (blob) content.\n *\n * @param uri - The resource URI\n * @param content - The content to serialize (string, Buffer, object, etc.)\n * @param mimeType - Optional MIME type override\n */\nexport function buildResourceContent(uri: string, content: unknown, mimeType?: string): ResourceContent {\n  // If content is already in the expected format\n  if (content && typeof content === 'object') {\n    const obj = content as Record<string, unknown>;\n    if ('blob' in obj && typeof obj['blob'] === 'string') {\n      return {\n        uri,\n        mimeType: (obj['mimeType'] as string) || mimeType,\n        blob: obj['blob'],\n      };\n    }\n    if ('text' in obj && typeof obj['text'] === 'string') {\n      return {\n        uri,\n        mimeType: (obj['mimeType'] as string) || mimeType,\n        text: obj['text'],\n      };\n    }\n  }\n\n  // Binary content (Buffer, Uint8Array)\n  if (Buffer.isBuffer(content) || content instanceof Uint8Array) {\n    const buffer = Buffer.isBuffer(content) ? content : Buffer.from(content);\n    return {\n      uri,\n      mimeType: mimeType || 'application/octet-stream',\n      blob: buffer.toString('base64'),\n    };\n  }\n\n  // String content\n  if (typeof content === 'string') {\n    return {\n      uri,\n      mimeType: mimeType || 'text/plain',\n      text: content,\n    };\n  }\n\n  // JSON-serializable content\n  try {\n    return {\n      uri,\n      mimeType: mimeType || 'application/json',\n      text: JSON.stringify(content),\n    };\n  } catch {\n    return {\n      uri,\n      mimeType: mimeType || 'text/plain',\n      text: String(content),\n    };\n  }\n}\n\n/**\n * Infer MIME type from file extension or content.\n */\nexport function inferMimeType(uri: string, content?: unknown): string {\n  // Try to infer from URI extension\n  const ext = uri.split('.').pop()?.toLowerCase();\n  const mimeTypes: Record<string, string> = {\n    json: 'application/json',\n    xml: 'application/xml',\n    html: 'text/html',\n    htm: 'text/html',\n    css: 'text/css',\n    js: 'application/javascript',\n    ts: 'application/typescript',\n    txt: 'text/plain',\n    md: 'text/markdown',\n    yaml: 'application/yaml',\n    yml: 'application/yaml',\n    csv: 'text/csv',\n    png: 'image/png',\n    jpg: 'image/jpeg',\n    jpeg: 'image/jpeg',\n    gif: 'image/gif',\n    svg: 'image/svg+xml',\n    pdf: 'application/pdf',\n  };\n\n  if (ext && mimeTypes[ext]) {\n    return mimeTypes[ext];\n  }\n\n  // Try to infer from content\n  if (typeof content === 'string') {\n    if (content.trim().startsWith('{') || content.trim().startsWith('[')) {\n      return 'application/json';\n    }\n    if (content.trim().startsWith('<')) {\n      return content.includes('<!DOCTYPE html') || content.includes('<html') ? 'text/html' : 'application/xml';\n    }\n  }\n\n  return 'text/plain';\n}\n"]}

package/src/utils/index.js

@@ -1,55 +0,0 @@
-"use strict";
-// file: libs/sdk/src/utils/index.ts
-// Centralized exports for SDK utilities
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.hasAsyncWith = exports.setMetadata = exports.getMetadata = exports.idFromString = exports.inferMimeType = exports.buildResourceContent = exports.toStructuredContent = exports.sanitizeToJson = exports.depsOfFunc = exports.depsOfClass = exports.isPromise = exports.isClass = exports.tokenName = exports.expandUriTemplate = exports.matchUriTemplate = exports.parseUriTemplate = exports.isValidMcpUriTemplate = exports.extractUriScheme = exports.isValidMcpUri = exports.isAncestorLineage = exports.lineagesEqual = exports.lineageDepth = exports.parseQualifiedName = exports.qualifiedNameOf = exports.ownerKeyOf = exports.ensureMaxLen = exports.shortHash = exports.normalizeOwnerPath = exports.normalizeProviderId = exports.normalizeSegment = exports.sepFor = exports.toCase = exports.splitWords = void 0;
-// Naming and case conversion utilities
-var naming_utils_1 = require("./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; } });
-// Owner lineage and qualified name utilities
-var lineage_utils_1 = require("./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; } });
-Object.defineProperty(exports, "parseQualifiedName", { enumerable: true, get: function () { return lineage_utils_1.parseQualifiedName; } });
-Object.defineProperty(exports, "lineageDepth", { enumerable: true, get: function () { return lineage_utils_1.lineageDepth; } });
-Object.defineProperty(exports, "lineagesEqual", { enumerable: true, get: function () { return lineage_utils_1.lineagesEqual; } });
-Object.defineProperty(exports, "isAncestorLineage", { enumerable: true, get: function () { return lineage_utils_1.isAncestorLineage; } });
-// URI validation utilities (RFC 3986)
-var uri_validation_utils_1 = require("./uri-validation.utils");
-Object.defineProperty(exports, "isValidMcpUri", { enumerable: true, get: function () { return uri_validation_utils_1.isValidMcpUri; } });
-Object.defineProperty(exports, "extractUriScheme", { enumerable: true, get: function () { return uri_validation_utils_1.extractUriScheme; } });
-Object.defineProperty(exports, "isValidMcpUriTemplate", { enumerable: true, get: function () { return uri_validation_utils_1.isValidMcpUriTemplate; } });
-// URI template parsing and matching utilities
-var uri_template_utils_1 = require("./uri-template.utils");
-Object.defineProperty(exports, "parseUriTemplate", { enumerable: true, get: function () { return uri_template_utils_1.parseUriTemplate; } });
-Object.defineProperty(exports, "matchUriTemplate", { enumerable: true, get: function () { return uri_template_utils_1.matchUriTemplate; } });
-Object.defineProperty(exports, "expandUriTemplate", { enumerable: true, get: function () { return uri_template_utils_1.expandUriTemplate; } });
-// Token utilities
-var token_utils_1 = require("./token.utils");
-Object.defineProperty(exports, "tokenName", { enumerable: true, get: function () { return token_utils_1.tokenName; } });
-Object.defineProperty(exports, "isClass", { enumerable: true, get: function () { return token_utils_1.isClass; } });
-Object.defineProperty(exports, "isPromise", { enumerable: true, get: function () { return token_utils_1.isPromise; } });
-Object.defineProperty(exports, "depsOfClass", { enumerable: true, get: function () { return token_utils_1.depsOfClass; } });
-Object.defineProperty(exports, "depsOfFunc", { enumerable: true, get: function () { return token_utils_1.depsOfFunc; } });
-// Content utilities
-var content_utils_1 = require("./content.utils");
-Object.defineProperty(exports, "sanitizeToJson", { enumerable: true, get: function () { return content_utils_1.sanitizeToJson; } });
-Object.defineProperty(exports, "toStructuredContent", { enumerable: true, get: function () { return content_utils_1.toStructuredContent; } });
-Object.defineProperty(exports, "buildResourceContent", { enumerable: true, get: function () { return content_utils_1.buildResourceContent; } });
-Object.defineProperty(exports, "inferMimeType", { enumerable: true, get: function () { return content_utils_1.inferMimeType; } });
-// String utilities
-var string_utils_1 = require("./string.utils");
-Object.defineProperty(exports, "idFromString", { enumerable: true, get: function () { return string_utils_1.idFromString; } });
-// Metadata utilities
-var metadata_utils_1 = require("./metadata.utils");
-Object.defineProperty(exports, "getMetadata", { enumerable: true, get: function () { return metadata_utils_1.getMetadata; } });
-Object.defineProperty(exports, "setMetadata", { enumerable: true, get: function () { return metadata_utils_1.setMetadata; } });
-Object.defineProperty(exports, "hasAsyncWith", { enumerable: true, get: function () { return metadata_utils_1.hasAsyncWith; } });
-//# sourceMappingURL=index.js.map

package/src/utils/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";AAAA,oCAAoC;AACpC,wCAAwC;;;AAExC,uCAAuC;AACvC,+CAUwB;AARtB,0GAAA,UAAU,OAAA;AACV,sGAAA,MAAM,OAAA;AACN,sGAAA,MAAM,OAAA;AACN,gHAAA,gBAAgB,OAAA;AAChB,mHAAA,mBAAmB,OAAA;AACnB,kHAAA,kBAAkB,OAAA;AAClB,yGAAA,SAAS,OAAA;AACT,4GAAA,YAAY,OAAA;AAGd,6CAA6C;AAC7C,iDAOyB;AANvB,2GAAA,UAAU,OAAA;AACV,gHAAA,eAAe,OAAA;AACf,mHAAA,kBAAkB,OAAA;AAClB,6GAAA,YAAY,OAAA;AACZ,8GAAA,aAAa,OAAA;AACb,kHAAA,iBAAiB,OAAA;AAGnB,sCAAsC;AACtC,+DAAgG;AAAvF,qHAAA,aAAa,OAAA;AAAE,wHAAA,gBAAgB,OAAA;AAAE,6HAAA,qBAAqB,OAAA;AAE/D,8CAA8C;AAC9C,2DAA6F;AAApF,sHAAA,gBAAgB,OAAA;AAAE,sHAAA,gBAAgB,OAAA;AAAE,uHAAA,iBAAiB,OAAA;AAE9D,kBAAkB;AAClB,6CAAuF;AAA9E,wGAAA,SAAS,OAAA;AAAE,sGAAA,OAAO,OAAA;AAAE,wGAAA,SAAS,OAAA;AAAE,0GAAA,WAAW,OAAA;AAAE,yGAAA,UAAU,OAAA;AAE/D,oBAAoB;AACpB,iDAQyB;AAPvB,+GAAA,cAAc,OAAA;AACd,oHAAA,mBAAmB,OAAA;AAInB,qHAAA,oBAAoB,OAAA;AACpB,8GAAA,aAAa,OAAA;AAGf,mBAAmB;AACnB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAErB,qBAAqB;AACrB,mDAA0E;AAAjE,6GAAA,WAAW,OAAA;AAAE,6GAAA,WAAW,OAAA;AAAE,8GAAA,YAAY,OAAA","sourcesContent":["// file: libs/sdk/src/utils/index.ts\n// Centralized exports for SDK utilities\n\n// Naming and case conversion utilities\nexport {\n  NameCase,\n  splitWords,\n  toCase,\n  sepFor,\n  normalizeSegment,\n  normalizeProviderId,\n  normalizeOwnerPath,\n  shortHash,\n  ensureMaxLen,\n} from './naming.utils';\n\n// Owner lineage and qualified name utilities\nexport {\n  ownerKeyOf,\n  qualifiedNameOf,\n  parseQualifiedName,\n  lineageDepth,\n  lineagesEqual,\n  isAncestorLineage,\n} from './lineage.utils';\n\n// URI validation utilities (RFC 3986)\nexport { isValidMcpUri, extractUriScheme, isValidMcpUriTemplate } from './uri-validation.utils';\n\n// URI template parsing and matching utilities\nexport { parseUriTemplate, matchUriTemplate, expandUriTemplate } from './uri-template.utils';\n\n// Token utilities\nexport { tokenName, isClass, isPromise, depsOfClass, depsOfFunc } from './token.utils';\n\n// Content utilities\nexport {\n  sanitizeToJson,\n  toStructuredContent,\n  TextContent,\n  BlobContent,\n  ResourceContent,\n  buildResourceContent,\n  inferMimeType,\n} from './content.utils';\n\n// String utilities\nexport { idFromString } from './string.utils';\n\n// Metadata utilities\nexport { getMetadata, setMetadata, hasAsyncWith } from './metadata.utils';\n"]}

package/src/utils/lineage.utils.js

@@ -1,82 +0,0 @@
-"use strict";
-// file: libs/sdk/src/utils/lineage.utils.ts
-// Owner lineage and qualified name utilities
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ownerKeyOf = ownerKeyOf;
-exports.qualifiedNameOf = qualifiedNameOf;
-exports.parseQualifiedName = parseQualifiedName;
-exports.lineageDepth = lineageDepth;
-exports.lineagesEqual = lineagesEqual;
-exports.isAncestorLineage = isAncestorLineage;
-/**
- * Convert an entry lineage to a string key.
- *
- * @example
- * ownerKeyOf([{ kind: 'app', id: 'Portal' }, { kind: 'plugin', id: 'Auth' }])
- * => "app:Portal/plugin:Auth"
- */
-function ownerKeyOf(lineage) {
-    return lineage.map((o) => `${o.kind}:${o.id}`).join('/');
-}
-/**
- * Create a fully qualified name from lineage and name.
- *
- * @example
- * qualifiedNameOf([{ kind: 'app', id: 'Portal' }], 'myTool')
- * => "app:Portal:myTool"
- */
-function qualifiedNameOf(lineage, name) {
-    return `${ownerKeyOf(lineage)}:${name}`;
-}
-/**
- * Parse a qualified name back into lineage and name.
- *
- * @example
- * parseQualifiedName("app:Portal/plugin:Auth:myTool")
- * => { lineage: [{ kind: 'app', id: 'Portal' }, { kind: 'plugin', id: 'Auth' }], name: 'myTool' }
- */
-function parseQualifiedName(qualifiedName) {
-    const lastColon = qualifiedName.lastIndexOf(':');
-    if (lastColon === -1)
-        return null;
-    const ownerKey = qualifiedName.slice(0, lastColon);
-    const name = qualifiedName.slice(lastColon + 1);
-    const lineage = [];
-    const parts = ownerKey.split('/');
-    for (const part of parts) {
-        const colonIdx = part.indexOf(':');
-        if (colonIdx === -1)
-            continue;
-        const kind = part.slice(0, colonIdx);
-        if (kind !== 'scope' && kind !== 'app' && kind !== 'plugin')
-            continue;
-        const id = part.slice(colonIdx + 1);
-        // `ref` is required by EntryOwnerRef but cannot be resolved from string parsing.
-        // Callers must resolve the ref from context if needed.
-        lineage.push({ kind, id, ref: undefined });
-    }
-    return { lineage, name };
-}
-/**
- * Get the depth of a lineage (number of owners).
- */
-function lineageDepth(lineage) {
-    return lineage.length;
-}
-/**
- * Check if two lineages are equal.
- */
-function lineagesEqual(a, b) {
-    if (a.length !== b.length)
-        return false;
-    return a.every((owner, i) => owner.kind === b[i].kind && owner.id === b[i].id);
-}
-/**
- * Check if lineage `a` is an ancestor of lineage `b`.
- */
-function isAncestorLineage(ancestor, descendant) {
-    if (ancestor.length >= descendant.length)
-        return false;
-    return ancestor.every((owner, i) => owner.kind === descendant[i].kind && owner.id === descendant[i].id);
-}
-//# sourceMappingURL=lineage.utils.js.map

package/src/utils/lineage.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lineage.utils.js","sourceRoot":"","sources":["../../../src/utils/lineage.utils.ts"],"names":[],"mappings":";AAAA,4CAA4C;AAC5C,6CAA6C;;AAW7C,gCAEC;AASD,0CAEC;AASD,gDAsBC;AAKD,oCAEC;AAKD,sCAGC;AAKD,8CAGC;AA1ED;;;;;;GAMG;AACH,SAAgB,UAAU,CAAC,OAAqB;IAC9C,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,eAAe,CAAC,OAAqB,EAAE,IAAY;IACjE,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAAC,aAAqB;IACtD,MAAM,SAAS,GAAG,aAAa,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACjD,IAAI,SAAS,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAElC,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IAEhD,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,QAAQ,KAAK,CAAC,CAAC;YAAE,SAAS;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QACrC,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,QAAQ;YAAE,SAAS;QACtE,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;QACpC,iFAAiF;QACjF,uDAAuD;QACvD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,SAAgB,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,OAAqB;IAChD,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,CAAe,EAAE,CAAe;IAC5D,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACjF,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,QAAsB,EAAE,UAAwB;IAChF,IAAI,QAAQ,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACvD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC1G,CAAC","sourcesContent":["// file: libs/sdk/src/utils/lineage.utils.ts\n// Owner lineage and qualified name utilities\n\nimport { EntryLineage } from '../common';\n\n/**\n * Convert an entry lineage to a string key.\n *\n * @example\n * ownerKeyOf([{ kind: 'app', id: 'Portal' }, { kind: 'plugin', id: 'Auth' }])\n * => \"app:Portal/plugin:Auth\"\n */\nexport function ownerKeyOf(lineage: EntryLineage): string {\n  return lineage.map((o) => `${o.kind}:${o.id}`).join('/');\n}\n\n/**\n * Create a fully qualified name from lineage and name.\n *\n * @example\n * qualifiedNameOf([{ kind: 'app', id: 'Portal' }], 'myTool')\n * => \"app:Portal:myTool\"\n */\nexport function qualifiedNameOf(lineage: EntryLineage, name: string): string {\n  return `${ownerKeyOf(lineage)}:${name}`;\n}\n\n/**\n * Parse a qualified name back into lineage and name.\n *\n * @example\n * parseQualifiedName(\"app:Portal/plugin:Auth:myTool\")\n * => { lineage: [{ kind: 'app', id: 'Portal' }, { kind: 'plugin', id: 'Auth' }], name: 'myTool' }\n */\nexport function parseQualifiedName(qualifiedName: string): { lineage: EntryLineage; name: string } | null {\n  const lastColon = qualifiedName.lastIndexOf(':');\n  if (lastColon === -1) return null;\n\n  const ownerKey = qualifiedName.slice(0, lastColon);\n  const name = qualifiedName.slice(lastColon + 1);\n\n  const lineage: EntryLineage = [];\n  const parts = ownerKey.split('/');\n\n  for (const part of parts) {\n    const colonIdx = part.indexOf(':');\n    if (colonIdx === -1) continue;\n    const kind = part.slice(0, colonIdx);\n    if (kind !== 'scope' && kind !== 'app' && kind !== 'plugin') continue;\n    const id = part.slice(colonIdx + 1);\n    // `ref` is required by EntryOwnerRef but cannot be resolved from string parsing.\n    // Callers must resolve the ref from context if needed.\n    lineage.push({ kind, id, ref: undefined as any });\n  }\n\n  return { lineage, name };\n}\n\n/**\n * Get the depth of a lineage (number of owners).\n */\nexport function lineageDepth(lineage: EntryLineage): number {\n  return lineage.length;\n}\n\n/**\n * Check if two lineages are equal.\n */\nexport function lineagesEqual(a: EntryLineage, b: EntryLineage): boolean {\n  if (a.length !== b.length) return false;\n  return a.every((owner, i) => owner.kind === b[i].kind && owner.id === b[i].id);\n}\n\n/**\n * Check if lineage `a` is an ancestor of lineage `b`.\n */\nexport function isAncestorLineage(ancestor: EntryLineage, descendant: EntryLineage): boolean {\n  if (ancestor.length >= descendant.length) return false;\n  return ancestor.every((owner, i) => owner.kind === descendant[i].kind && owner.id === descendant[i].id);\n}\n"]}

package/src/utils/metadata.utils.js

@@ -1,26 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMetadata = getMetadata;
-exports.setMetadata = setMetadata;
-exports.hasAsyncWith = hasAsyncWith;
-require("reflect-metadata");
-const common_1 = require("../common");
-function getMetadata(key, target, propertyKey) {
-    // Reflect.getMetadata is provided by reflect-metadata polyfill
-    return (propertyKey !== undefined)
-        ? Reflect.getMetadata(key, target, propertyKey)
-        : Reflect.getMetadata(key, target);
-}
-function setMetadata(key, value, target, propertyKey) {
-    if (propertyKey !== undefined) {
-        Reflect.defineMetadata(key, value, target, propertyKey);
-    }
-    else {
-        Reflect.defineMetadata(key, value, target);
-    }
-}
-function hasAsyncWith(klass) {
-    return (!!getMetadata(common_1.META_ASYNC_WITH, klass) &&
-        typeof klass.with === 'function');
-}
-//# sourceMappingURL=metadata.utils.js.map

package/src/utils/metadata.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"metadata.utils.js","sourceRoot":"","sources":["../../../src/utils/metadata.utils.ts"],"names":[],"mappings":";;AAGA,kCAKC;AAED,kCAMC;AAED,oCAKC;AAvBD,4BAA0B;AAC1B,sCAAkD;AAElD,SAAgB,WAAW,CAAU,GAAQ,EAAE,MAAW,EAAE,WAA6B;IACvF,+DAA+D;IAC/D,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC;QAChC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC;QAC/C,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC;AAED,SAAgB,WAAW,CAAC,GAAQ,EAAE,KAAU,EAAE,MAAW,EAAE,WAA6B;IAC1F,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAe,CAAC,cAAc,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IACnE,CAAC;SAAM,CAAC;QACL,OAAe,CAAC,cAAc,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED,SAAiB,YAAY,CAAC,KAAgB;IAC5C,OAAO,CACL,CAAC,CAAC,WAAW,CAAC,wBAAe,EAAE,KAAK,CAAC;QACrC,OAAQ,KAAa,CAAC,IAAI,KAAK,UAAU,CAC1C,CAAC;AACJ,CAAC","sourcesContent":["import 'reflect-metadata';\nimport { META_ASYNC_WITH, Type } from '../common';\n\nexport function getMetadata<T = any>(key: any, target: any, propertyKey?: string | symbol): T | undefined {\n  // Reflect.getMetadata is provided by reflect-metadata polyfill\n  return (propertyKey !== undefined)\n    ? Reflect.getMetadata(key, target, propertyKey)\n    : Reflect.getMetadata(key, target);\n}\n\nexport function setMetadata(key: any, value: any, target: any, propertyKey?: string | symbol): void {\n  if (propertyKey !== undefined) {\n    (Reflect as any).defineMetadata(key, value, target, propertyKey);\n  } else {\n    (Reflect as any).defineMetadata(key, value, target);\n  }\n}\n\nexport function  hasAsyncWith(klass: Type<any>): boolean {\n  return (\n    !!getMetadata(META_ASYNC_WITH, klass) &&\n    typeof (klass as any).with === 'function'\n  );\n}\n"]}

package/src/utils/naming.utils.js

@@ -1,136 +0,0 @@
-"use strict";
-// file: libs/sdk/src/utils/naming.utils.ts
-// Shared naming and case conversion utilities for MCP-compliant identifiers
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.splitWords = splitWords;
-exports.toCase = toCase;
-exports.sepFor = sepFor;
-exports.normalizeSegment = normalizeSegment;
-exports.normalizeProviderId = normalizeProviderId;
-exports.normalizeOwnerPath = normalizeOwnerPath;
-exports.shortHash = shortHash;
-exports.ensureMaxLen = ensureMaxLen;
-// Allowed chars per MCP spec: a-zA-Z0-9 _ - . /
-const MCP_ALLOWED = /[A-Za-z0-9_\-./]/;
-/**
- * Split a string into words, handling camelCase, PascalCase, and delimiters.
- *
- * @example
- * splitWords("myFunctionName") => ["my", "Function", "Name"]
- * splitWords("my_function_name") => ["my", "function", "name"]
- */
-function splitWords(input) {
-    const parts = [];
-    let buff = '';
-    for (let i = 0; i < input.length; i++) {
-        const ch = input[i];
-        const isAlphaNum = /[A-Za-z0-9]/.test(ch);
-        if (!isAlphaNum) {
-            if (buff) {
-                parts.push(buff);
-                buff = '';
-            }
-            continue;
-        }
-        if (buff && /[a-z]/.test(buff[buff.length - 1]) && /[A-Z]/.test(ch)) {
-            parts.push(buff);
-            buff = ch;
-        }
-        else {
-            buff += ch;
-        }
-    }
-    if (buff)
-        parts.push(buff);
-    return parts;
-}
-/**
- * Convert words to a specific naming case.
- *
- * @example
- * toCase(["my", "function"], "snake") => "my_function"
- * toCase(["my", "function"], "camel") => "myFunction"
- */
-function toCase(words, kind) {
-    const safe = words.filter(Boolean);
-    switch (kind) {
-        case 'snake':
-            return safe.map((w) => w.toLowerCase()).join('_');
-        case 'kebab':
-            return safe.map((w) => w.toLowerCase()).join('-');
-        case 'dot':
-            return safe.map((w) => w.toLowerCase()).join('.');
-        case 'camel':
-            if (safe.length === 0)
-                return '';
-            return (safe[0].toLowerCase() +
-                safe
-                    .slice(1)
-                    .map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase())
-                    .join(''));
-    }
-}
-/**
- * Get the separator character for a naming case.
- */
-function sepFor(kind) {
-    return kind === 'snake' ? '_' : kind === 'kebab' ? '-' : kind === 'dot' ? '.' : '';
-}
-/**
- * Normalize a single segment (name part) to MCP-safe characters.
- */
-function normalizeSegment(raw, kind) {
-    const words = splitWords(raw);
-    let cased = toCase(words, kind);
-    cased = [...cased].filter((ch) => MCP_ALLOWED.test(ch)).join('');
-    return cased || 'x';
-}
-/**
- * Normalize a provider ID to MCP-safe characters.
- */
-function normalizeProviderId(raw, kind) {
-    if (!raw)
-        return undefined;
-    const tokens = raw.split(/\W+/);
-    const cased = toCase(tokens, kind);
-    const safe = [...cased].filter((ch) => MCP_ALLOWED.test(ch)).join('');
-    return safe || undefined;
-}
-/**
- * Normalize an owner path (app:id/plugin:id) to the specified naming case.
- */
-function normalizeOwnerPath(ownerKey, kind) {
-    const levels = ownerKey.split('/');
-    const normLevels = levels.map((level) => {
-        const parts = level.split(':'); // ["app","Portal"]
-        return parts.map((p) => normalizeSegment(p, kind)).join(sepFor(kind));
-    });
-    if (kind === 'camel')
-        return normLevels.map((seg) => seg.charAt(0).toLowerCase() + seg.slice(1)).join('');
-    return normLevels.join(sepFor(kind));
-}
-/**
- * Generate a short hash (6 hex chars) from a string.
- * Uses djb2 algorithm for fast, reasonable distribution.
- */
-function shortHash(s) {
-    let h = 5381;
-    for (let i = 0; i < s.length; i++)
-        h = (h << 5) + h + s.charCodeAt(i);
-    return (h >>> 0).toString(16).slice(-6).padStart(6, '0');
-}
-/**
- * Ensure a name fits within a maximum length, using hash truncation if needed.
- * Preserves meaningful suffix while adding a hash for uniqueness.
- */
-function ensureMaxLen(name, max) {
-    if (name.length <= max)
-        return name;
-    const hash = shortHash(name);
-    const lastSep = Math.max(name.lastIndexOf('_'), name.lastIndexOf('-'), name.lastIndexOf('.'), name.lastIndexOf('/'));
-    const tail = lastSep > 0 ? name.slice(lastSep + 1) : name.slice(-Math.max(3, Math.min(16, Math.floor(max / 4))));
-    const budget = Math.max(1, max - (1 + hash.length + 1 + tail.length));
-    const prefix = name.slice(0, budget);
-    return `${prefix}-${hash}-${tail}`.slice(0, max);
-}
-//# sourceMappingURL=naming.utils.js.map

package/src/utils/naming.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"naming.utils.js","sourceRoot":"","sources":["../../../src/utils/naming.utils.ts"],"names":[],"mappings":"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","sourcesContent":["// file: libs/sdk/src/utils/naming.utils.ts\n// Shared naming and case conversion utilities for MCP-compliant identifiers\n\n/**\n * Supported naming conventions for MCP identifiers\n */\nexport type NameCase = 'snake' | 'kebab' | 'dot' | 'camel';\n\n// Allowed chars per MCP spec: a-zA-Z0-9 _ - . /\nconst MCP_ALLOWED = /[A-Za-z0-9_\\-./]/;\n\n/**\n * Split a string into words, handling camelCase, PascalCase, and delimiters.\n *\n * @example\n * splitWords(\"myFunctionName\") => [\"my\", \"Function\", \"Name\"]\n * splitWords(\"my_function_name\") => [\"my\", \"function\", \"name\"]\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\n/**\n * Convert words to a specific naming case.\n *\n * @example\n * toCase([\"my\", \"function\"], \"snake\") => \"my_function\"\n * toCase([\"my\", \"function\"], \"camel\") => \"myFunction\"\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\n/**\n * Get the separator character for a naming case.\n */\nexport function sepFor(kind: NameCase): string {\n  return kind === 'snake' ? '_' : kind === 'kebab' ? '-' : kind === 'dot' ? '.' : '';\n}\n\n/**\n * Normalize a single segment (name part) to MCP-safe characters.\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\n/**\n * Normalize a provider ID to MCP-safe characters.\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\n/**\n * Normalize an owner path (app:id/plugin:id) to the specified naming case.\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.map((p) => normalizeSegment(p, kind)).join(sepFor(kind));\n  });\n  if (kind === 'camel') return normLevels.map((seg) => seg.charAt(0).toLowerCase() + seg.slice(1)).join('');\n  return normLevels.join(sepFor(kind));\n}\n\n/**\n * Generate a short hash (6 hex chars) from a string.\n * Uses djb2 algorithm for fast, reasonable distribution.\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\n/**\n * Ensure a name fits within a maximum length, using hash truncation if needed.\n * Preserves meaningful suffix while adding a hash for uniqueness.\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"]}