@dollhousemcp/mcp-server
Version:
DollhouseMCP - A Model Context Protocol (MCP) server that enables dynamic AI persona management from markdown files, allowing Claude and other compatible AI assistants to activate and switch between different behavioral personas.
938 lines • 149 kB
JavaScript
import * as yaml from 'js-yaml';
import { SecureYamlParser } from '../security/secureYamlParser.js';
import { DIRECT_METADATA_FIELDS, ARRAY_METADATA_FIELDS, COPY_THROUGH_FIELDS, LANGUAGE_BY_EXTENSION, SECTION_TITLE_BY_DIRECTORY, TOP_LEVEL_CONTENT_PREFIX, BINARY_LINK_FENCE, BINARY_LINK_PREFIX, REMAPPED_DIRECTORY_PREFIX, REMAPPED_TOP_LEVEL_PREFIX, ALLOWED_AGENT_DIRECTORIES, BINARY_EXTENSIONS, CONVERSION_MAX_SINGLE_TEXT_BYTES, CONVERSION_MAX_TOTAL_TEXT_BYTES, CONVERSION_MAX_FILES, CONVERSION_METRICS_LOG_INPUT_THRESHOLD_BYTES, CONVERSION_METRICS_LOG_DURATION_THRESHOLD_MS, } from './agentSkillConverter.constants.js';
import { ContentValidator } from '../security/contentValidator.js';
import { logger } from '../utils/logger.js';
export const AGENT_SKILL_MAPPING_VERSION = 'agent-skill-v1';
export class AgentSkillConverter {
convert(options) {
const startedAt = performance.now();
const heapUsedBefore = process.memoryUsage().heapUsed;
const pathMode = options.path_mode ?? 'safe';
const securityMode = options.security_mode ?? 'strict';
this.validateInputBounds(options);
let result;
if (options.direction === 'agent_to_dollhouse') {
if (!options.agent_skill) {
throw new Error(`Missing required parameter 'agent_skill' for direction '${options.direction}'`);
}
result = this.convertAgentToDollhouse(options.agent_skill, pathMode, securityMode);
}
else if (options.direction === 'dollhouse_to_agent') {
result = this.convertDollhouseToAgent(options, pathMode);
}
else {
throw new Error(`Unsupported conversion direction '${String(options.direction)}'. Expected 'agent_to_dollhouse' or 'dollhouse_to_agent'.`);
}
return this.attachConversionMetrics(result, options, startedAt, heapUsedBefore);
}
validateInputBounds(options) {
let totalBytes = 0;
let fileCount = 0;
const addTextBudget = (value, pathLabel) => {
const bytes = Buffer.byteLength(value, 'utf8');
if (bytes > CONVERSION_MAX_SINGLE_TEXT_BYTES) {
throw new Error(`Input '${pathLabel}' exceeds maximum per-field size (${CONVERSION_MAX_SINGLE_TEXT_BYTES} bytes).`);
}
totalBytes += bytes;
if (totalBytes > CONVERSION_MAX_TOTAL_TEXT_BYTES) {
throw new Error(`Input exceeds maximum aggregate size (${CONVERSION_MAX_TOTAL_TEXT_BYTES} bytes).`);
}
};
if (options.dollhouse_markdown) {
addTextBudget(options.dollhouse_markdown, 'dollhouse_markdown');
fileCount += 1;
}
if (options.dollhouse) {
addTextBudget(JSON.stringify(options.dollhouse.metadata ?? {}), 'dollhouse.metadata');
addTextBudget(options.dollhouse.instructions ?? '', 'dollhouse.instructions');
addTextBudget(options.dollhouse.content ?? '', 'dollhouse.content');
fileCount += 3;
}
if (options.agent_skill) {
for (const [pathKey, pathValue] of Object.entries(options.agent_skill)) {
if (typeof pathValue === 'string') {
addTextBudget(pathValue, `agent_skill.${pathKey}`);
fileCount += 1;
continue;
}
if (pathValue && typeof pathValue === 'object') {
for (const [fileName, fileContent] of Object.entries(pathValue)) {
if (typeof fileContent !== 'string') {
continue;
}
addTextBudget(fileContent, `agent_skill.${pathKey}${fileName}`);
fileCount += 1;
}
}
}
}
if (fileCount > CONVERSION_MAX_FILES) {
throw new Error(`Input exceeds maximum file count (${CONVERSION_MAX_FILES}).`);
}
}
attachConversionMetrics(result, options, startedAt, heapUsedBefore) {
const durationMs = performance.now() - startedAt;
const heapUsedAfter = process.memoryUsage().heapUsed;
const inputTextBytes = this.measureInputBytes(options);
const outputTextBytes = this.measureOutputBytes(result);
const memoryDeltaBytes = heapUsedAfter - heapUsedBefore;
result.report.metrics = {
durationMs,
inputTextBytes,
outputTextBytes,
memoryDeltaBytes,
heapUsedBytes: heapUsedAfter,
};
if (inputTextBytes >= CONVERSION_METRICS_LOG_INPUT_THRESHOLD_BYTES ||
durationMs >= CONVERSION_METRICS_LOG_DURATION_THRESHOLD_MS) {
logger.info('Agent skill conversion completed with large payload metrics', {
direction: result.direction,
pathMode: options.path_mode ?? 'safe',
securityMode: options.security_mode ?? 'strict',
durationMs,
inputTextBytes,
outputTextBytes,
memoryDeltaBytes,
heapUsedBytes: heapUsedAfter,
});
}
return result;
}
measureInputBytes(options) {
let totalBytes = 0;
if (options.dollhouse_markdown) {
totalBytes += Buffer.byteLength(options.dollhouse_markdown, 'utf8');
}
if (options.dollhouse) {
totalBytes += Buffer.byteLength(JSON.stringify(options.dollhouse.metadata ?? {}), 'utf8');
totalBytes += Buffer.byteLength(options.dollhouse.instructions ?? '', 'utf8');
totalBytes += Buffer.byteLength(options.dollhouse.content ?? '', 'utf8');
}
if (options.agent_skill) {
for (const pathValue of Object.values(options.agent_skill)) {
if (typeof pathValue === 'string') {
totalBytes += Buffer.byteLength(pathValue, 'utf8');
continue;
}
if (pathValue && typeof pathValue === 'object') {
for (const fileContent of Object.values(pathValue)) {
if (typeof fileContent === 'string') {
totalBytes += Buffer.byteLength(fileContent, 'utf8');
}
}
}
}
}
return totalBytes;
}
measureOutputBytes(result) {
let totalBytes = 0;
if (result.dollhouse_markdown) {
totalBytes += Buffer.byteLength(result.dollhouse_markdown, 'utf8');
}
if (result.dollhouse) {
totalBytes += Buffer.byteLength(JSON.stringify(result.dollhouse.metadata ?? {}), 'utf8');
totalBytes += Buffer.byteLength(result.dollhouse.instructions ?? '', 'utf8');
totalBytes += Buffer.byteLength(result.dollhouse.content ?? '', 'utf8');
}
if (result.agent_skill) {
for (const pathValue of Object.values(result.agent_skill)) {
if (typeof pathValue === 'string') {
totalBytes += Buffer.byteLength(pathValue, 'utf8');
continue;
}
if (pathValue && typeof pathValue === 'object') {
for (const fileContent of Object.values(pathValue)) {
if (typeof fileContent === 'string') {
totalBytes += Buffer.byteLength(fileContent, 'utf8');
}
}
}
}
}
return totalBytes;
}
applyDollhouseSecurityPolicy(dollhouse, warnings, pathMode, securityMode) {
const metadata = this.scanObjectStrings(dollhouse.metadata, 'dollhouse.metadata', warnings, pathMode, securityMode);
const instructions = this.scanTextContent(dollhouse.instructions, 'dollhouse.instructions', warnings, pathMode, securityMode, 'skill');
const content = this.scanTextContent(dollhouse.content, 'dollhouse.content', warnings, pathMode, securityMode, 'skill');
return {
metadata,
instructions,
content,
};
}
scanObjectStrings(value, basePath, warnings, pathMode, securityMode) {
if (typeof value === 'string') {
return this.scanTextContent(value, basePath, warnings, pathMode, securityMode);
}
if (Array.isArray(value)) {
return value.map((item, index) => this.scanObjectStrings(item, `${basePath}[${index}]`, warnings, pathMode, securityMode));
}
if (isRecord(value)) {
const scanned = {};
for (const [key, item] of Object.entries(value)) {
scanned[key] = this.scanObjectStrings(item, `${basePath}.${key}`, warnings, pathMode, securityMode);
}
return scanned;
}
return value;
}
scanTextContent(value, path, warnings, pathMode, securityMode, contentContext) {
if (!value) {
return value;
}
try {
const securityResult = ContentValidator.validateAndSanitize(value, {
maxLength: CONVERSION_MAX_SINGLE_TEXT_BYTES,
contentContext,
});
if (securityMode === 'strict' && !securityResult.isValid) {
const patternSummary = securityResult.detectedPatterns?.slice(0, 5).join(', ') || 'unknown patterns';
throw new Error(`Strict security mode blocked conversion at '${path}' due to detected risky patterns: ${patternSummary}. ` +
`Review input and retry with security_mode='warn' only if you explicitly accept the risk.`);
}
if (securityResult.detectedPatterns && securityResult.detectedPatterns.length > 0) {
const displayedPatterns = securityResult.detectedPatterns.slice(0, 5);
const suffix = securityResult.detectedPatterns.length > 5 ? ` (+${securityResult.detectedPatterns.length - 5} more)` : '';
warnings.push({
code: 'invalid_input',
path,
message: pathMode === 'safe'
? `Security patterns detected (${displayedPatterns.join(', ')}${suffix}). Content was sanitized in safe mode.`
: `Security patterns detected (${displayedPatterns.join(', ')}${suffix}). Content preserved because path_mode='lossless'.`,
preserved: pathMode === 'lossless',
});
}
if (pathMode === 'safe') {
return securityResult.sanitizedContent ?? value;
}
return value;
}
catch (error) {
if (securityMode === 'strict') {
throw error;
}
warnings.push({
code: 'invalid_input',
path,
message: `Security validation failed: ${error instanceof Error ? error.message : String(error)}.`,
preserved: pathMode === 'lossless',
});
return pathMode === 'safe' ? '[CONTENT_BLOCKED]' : value;
}
}
convertAgentToDollhouse(agentSkill, pathMode = 'safe', securityMode = 'strict') {
const warnings = [];
const unsupportedFields = new Set();
// Normalize all text inputs to NFC to prevent Unicode homograph attacks
const normalizedSkill = {};
for (const [key, value] of Object.entries(agentSkill)) {
const nKey = String(key).normalize('NFC');
if (typeof value === 'string') {
normalizedSkill[nKey] = value.normalize('NFC');
}
else if (typeof value === 'object' && value !== null) {
const normalizedDir = {};
for (const [fKey, fVal] of Object.entries(value)) {
normalizedDir[String(fKey).normalize('NFC')] = typeof fVal === 'string' ? fVal.normalize('NFC') : String(fVal);
}
normalizedSkill[nKey] = normalizedDir;
}
else {
normalizedSkill[nKey] = value;
}
}
const parsed = this.parseSkillMarkdown(normalizedSkill['SKILL.md'], 'agent_skill.SKILL.md');
const name = this.readRequiredString(parsed.frontmatter, 'name', warnings, unsupportedFields, 'agent_skill.SKILL.md.frontmatter.name');
const description = this.readRequiredString(parsed.frontmatter, 'description', warnings, unsupportedFields, 'agent_skill.SKILL.md.frontmatter.description');
const metadata = {
name: name ?? 'Unnamed Agent Skill',
description: description ?? 'No description provided',
type: 'skill',
version: this.readString(parsed.frontmatter, 'version') ?? '1.0.0',
};
if (this.readString(parsed.frontmatter, 'type') && this.readString(parsed.frontmatter, 'type') !== 'skill') {
warnings.push({
code: 'ambiguous_mapping',
path: 'agent_skill.SKILL.md.frontmatter.type',
message: `Agent skill type '${String(parsed.frontmatter.type)}' is normalized to Dollhouse type 'skill'.`,
preserved: false,
});
}
for (const field of COPY_THROUGH_FIELDS) {
if (Object.hasOwn(parsed.frontmatter, field)) {
metadata[field] = parsed.frontmatter[field];
}
}
for (const field of ARRAY_METADATA_FIELDS) {
if (!Object.hasOwn(parsed.frontmatter, field)) {
continue;
}
const value = parsed.frontmatter[field];
if (Array.isArray(value) && value.every(item => typeof item === 'string')) {
metadata[field] = value;
continue;
}
if (typeof value === 'string') {
metadata[field] = [value];
warnings.push({
code: 'ambiguous_mapping',
path: `agent_skill.SKILL.md.frontmatter.${field}`,
message: `Expected array for '${field}'. Converted single string to one-item array.`,
preserved: true,
});
continue;
}
warnings.push({
code: 'unsupported_field',
path: `agent_skill.SKILL.md.frontmatter.${field}`,
message: `Unsupported '${field}' type '${typeof value}'. Field was preserved in custom metadata.`,
preserved: true,
});
unsupportedFields.add(`agent_skill.SKILL.md.frontmatter.${field}`);
}
const customMetadata = {
source_format: 'agent_skill_current',
mapping_version: AGENT_SKILL_MAPPING_VERSION,
};
if (isRecord(parsed.frontmatter.metadata)) {
customMetadata.agent_metadata = clone(parsed.frontmatter.metadata);
}
else if (Object.hasOwn(parsed.frontmatter, 'metadata')) {
warnings.push({
code: 'unsupported_field',
path: 'agent_skill.SKILL.md.frontmatter.metadata',
message: 'Expected object for frontmatter.metadata. Value was preserved as-is in custom metadata.',
preserved: true,
});
unsupportedFields.add('agent_skill.SKILL.md.frontmatter.metadata');
customMetadata.agent_metadata = parsed.frontmatter.metadata;
}
const unknownFrontmatter = {};
for (const [key, value] of Object.entries(parsed.frontmatter)) {
if (!DIRECT_METADATA_FIELDS.has(key)) {
unknownFrontmatter[key] = value;
}
}
if (Object.keys(unknownFrontmatter).length > 0) {
customMetadata.agent_frontmatter_unknown = unknownFrontmatter;
}
metadata.custom = customMetadata;
const resourceDirectories = {};
const topLevelFiles = {};
for (const [pathKey, pathValue] of Object.entries(agentSkill)) {
if (pathKey === 'SKILL.md') {
continue;
}
if (pathKey.endsWith('/')) {
if (!isStringRecord(pathValue)) {
warnings.push({
code: 'invalid_input',
path: `agent_skill.${pathKey}`,
message: `Directory '${pathKey}' must be a map of filename -> string content.`,
preserved: false,
});
unsupportedFields.add(`agent_skill.${pathKey}`);
continue;
}
if (pathMode === 'lossless') {
resourceDirectories[pathKey] = clone(pathValue);
continue;
}
if (isAllowedAgentDirectory(pathKey) && isSafeDirectoryName(pathKey)) {
resourceDirectories[pathKey] = clone(pathValue);
continue;
}
warnings.push({
code: 'ambiguous_mapping',
path: `agent_skill.${pathKey}`,
message: `Directory '${pathKey}' is outside allowed directories and was remapped under references/${REMAPPED_DIRECTORY_PREFIX}/.`,
preserved: true,
});
const remapRoot = `${REMAPPED_DIRECTORY_PREFIX}/${sanitizePathToken(pathKey.replace(/\/+$/u, ''))}`;
if (!resourceDirectories['references/']) {
resourceDirectories['references/'] = {};
}
for (const [fileName, fileContent] of Object.entries(pathValue)) {
const safeFilePath = sanitizeRelativePathForReference(fileName);
resourceDirectories['references/'][`${remapRoot}/${safeFilePath}`] = fileContent;
}
continue;
}
if (typeof pathValue !== 'string') {
warnings.push({
code: 'invalid_input',
path: `agent_skill.${pathKey}`,
message: `Top-level file '${pathKey}' must contain string content.`,
preserved: false,
});
unsupportedFields.add(`agent_skill.${pathKey}`);
continue;
}
if (pathMode === 'lossless' || isSafeTopLevelFileName(pathKey)) {
topLevelFiles[pathKey] = pathValue;
continue;
}
warnings.push({
code: 'ambiguous_mapping',
path: `agent_skill.${pathKey}`,
message: `Top-level path '${pathKey}' is unsafe and was remapped under references/${REMAPPED_TOP_LEVEL_PREFIX}/.`,
preserved: true,
});
if (!resourceDirectories['references/']) {
resourceDirectories['references/'] = {};
}
const safeFilePath = sanitizeRelativePathForReference(pathKey);
resourceDirectories['references/'][`${REMAPPED_TOP_LEVEL_PREFIX}/${safeFilePath}`] = pathValue;
}
const content = this.buildDollhouseContent(resourceDirectories, topLevelFiles);
const dollhouse = {
metadata,
instructions: parsed.body.trim(),
content,
};
const securedDollhouse = this.applyDollhouseSecurityPolicy(dollhouse, warnings, pathMode, securityMode);
const roundtrip_state = {
mappingVersion: AGENT_SKILL_MAPPING_VERSION,
agentSkill: clone(agentSkill),
};
return {
direction: 'agent_to_dollhouse',
mappingVersion: AGENT_SKILL_MAPPING_VERSION,
dollhouse: securedDollhouse,
dollhouse_markdown: this.serializeDollhouseMarkdown(securedDollhouse),
roundtrip_state,
report: {
mappingVersion: AGENT_SKILL_MAPPING_VERSION,
deterministic: true,
roundTripAvailable: true,
warnings,
unsupportedFields: [...unsupportedFields].sort((a, b) => a.localeCompare(b)),
},
};
}
convertDollhouseToAgent(options, pathMode = 'safe') {
const warnings = [];
const unsupportedFields = new Set();
const preferRoundTripState = options.prefer_roundtrip_state ?? true;
// Normalize dollhouse markdown input to NFC
if (options.dollhouse_markdown && typeof options.dollhouse_markdown === 'string') {
options.dollhouse_markdown = options.dollhouse_markdown.normalize('NFC');
}
if (preferRoundTripState && options.roundtrip_state) {
if (options.roundtrip_state.mappingVersion !== AGENT_SKILL_MAPPING_VERSION) {
warnings.push({
code: 'ambiguous_mapping',
path: 'roundtrip_state.mappingVersion',
message: `roundtrip_state mapping version '${options.roundtrip_state.mappingVersion}' does not match '${AGENT_SKILL_MAPPING_VERSION}'. Falling back to best-effort mapping.`,
preserved: false,
});
}
else {
return {
direction: 'dollhouse_to_agent',
mappingVersion: AGENT_SKILL_MAPPING_VERSION,
agent_skill: clone(options.roundtrip_state.agentSkill),
report: {
mappingVersion: AGENT_SKILL_MAPPING_VERSION,
deterministic: true,
roundTripAvailable: true,
warnings,
unsupportedFields: [...unsupportedFields].sort((a, b) => a.localeCompare(b)),
},
};
}
}
const dollhouse = this.resolveDollhouseInput(options, warnings, unsupportedFields);
const metadata = isRecord(dollhouse.metadata) ? dollhouse.metadata : {};
const name = this.readRequiredString(metadata, 'name', warnings, unsupportedFields, 'dollhouse.metadata.name');
const description = this.readRequiredString(metadata, 'description', warnings, unsupportedFields, 'dollhouse.metadata.description');
const frontmatter = {
name: name ?? 'Converted Dollhouse Skill',
description: description ?? 'No description provided',
};
for (const field of ['version', 'author', 'license', 'created', 'modified']) {
if (Object.hasOwn(metadata, field)) {
frontmatter[field] = metadata[field];
}
}
const mappedMetadata = {};
for (const field of ['category', 'tags', 'complexity', 'domains', 'dependencies', 'prerequisites', 'parameters', 'examples', 'languages', 'proficiency_level']) {
if (Object.hasOwn(metadata, field)) {
mappedMetadata[field] = metadata[field];
}
}
if (isRecord(metadata.custom)) {
const agentMetadata = metadata.custom.agent_metadata;
if (isRecord(agentMetadata)) {
Object.assign(mappedMetadata, clone(agentMetadata));
}
else if (agentMetadata !== undefined) {
mappedMetadata.dollhouse_custom_agent_metadata = clone(agentMetadata);
}
const unknownFrontmatter = metadata.custom.agent_frontmatter_unknown;
if (isRecord(unknownFrontmatter)) {
for (const [key, value] of Object.entries(unknownFrontmatter)) {
if (Object.hasOwn(frontmatter, key)) {
warnings.push({
code: 'ambiguous_mapping',
path: `dollhouse.metadata.custom.agent_frontmatter_unknown.${key}`,
message: `Unknown frontmatter key '${key}' conflicts with mapped frontmatter and was not applied.`,
preserved: false,
});
continue;
}
frontmatter[key] = clone(value);
}
}
}
if (Object.keys(mappedMetadata).length > 0) {
frontmatter.metadata = mappedMetadata;
}
for (const key of Object.keys(metadata)) {
if (!DIRECT_METADATA_FIELDS.has(key) && key !== 'custom') {
warnings.push({
code: 'unsupported_field',
path: `dollhouse.metadata.${key}`,
message: `Dollhouse metadata field '${key}' is not mapped to Agent Skill frontmatter.`,
preserved: false,
});
unsupportedFields.add(`dollhouse.metadata.${key}`);
}
}
const instructions = (typeof dollhouse.instructions === 'string' ? dollhouse.instructions : '').trim();
const content = (typeof dollhouse.content === 'string' ? dollhouse.content : '').trim();
const contentParseResult = this.extractResourcesFromDollhouseContent(content, warnings, unsupportedFields, pathMode);
let body = instructions;
if (contentParseResult.residualContent.length > 0) {
warnings.push({
code: 'ambiguous_mapping',
path: 'dollhouse.content',
message: 'Some Dollhouse content could not be mapped to Agent Skill subdirectories. Unmapped content was appended to SKILL.md body.',
preserved: true,
});
body = body.length > 0
? `${body}\n\n## Additional Dollhouse Content\n\n${contentParseResult.residualContent}`
: contentParseResult.residualContent;
}
const agentSkill = {
'SKILL.md': this.serializeSkillMarkdown(frontmatter, body),
};
for (const [directory, files] of Object.entries(contentParseResult.resourceDirectories)) {
if (Object.keys(files).length === 0) {
continue;
}
agentSkill[directory] = files;
}
for (const [fileName, fileContent] of Object.entries(contentParseResult.topLevelFiles)) {
agentSkill[fileName] = fileContent;
}
return {
direction: 'dollhouse_to_agent',
mappingVersion: AGENT_SKILL_MAPPING_VERSION,
agent_skill: agentSkill,
report: {
mappingVersion: AGENT_SKILL_MAPPING_VERSION,
deterministic: true,
roundTripAvailable: false,
warnings,
unsupportedFields: [...unsupportedFields].sort((a, b) => a.localeCompare(b)),
},
};
}
parseDollhouseMarkdown(markdown) {
const parsed = this.parseSkillMarkdown(markdown, 'dollhouse_markdown');
const frontmatter = clone(parsed.frontmatter);
const instructions = typeof frontmatter.instructions === 'string'
? frontmatter.instructions
: parsed.body.trim();
const content = typeof frontmatter.instructions === 'string'
? parsed.body.trim()
: '';
delete frontmatter.instructions;
return {
metadata: frontmatter,
instructions,
content,
};
}
serializeDollhouseMarkdown(skill) {
const metadata = clone(skill.metadata);
metadata.instructions = skill.instructions;
return this.serializeSkillMarkdown(metadata, skill.content);
}
resolveDollhouseInput(options, warnings, unsupportedFields) {
if (options.dollhouse) {
return options.dollhouse;
}
if (options.dollhouse_markdown) {
return this.parseDollhouseMarkdown(options.dollhouse_markdown);
}
warnings.push({
code: 'missing_required_field',
path: 'dollhouse',
message: `Provide either 'dollhouse' artifact or 'dollhouse_markdown' for direction '${options.direction}'.`,
preserved: false,
});
unsupportedFields.add('dollhouse');
throw new Error(`Missing required input for '${options.direction}': expected dollhouse or dollhouse_markdown`);
}
parseSkillMarkdown(markdown, pathLabel) {
const match = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/u.exec(markdown);
if (!match) {
throw new Error(`Missing YAML frontmatter in ${pathLabel}`);
}
if (!ContentValidator.validateYamlContent(match[1])) {
throw new Error(`Malicious or unsafe YAML frontmatter detected in ${pathLabel}`);
}
let parsedFrontmatter;
try {
parsedFrontmatter = SecureYamlParser.parseRawYaml(match[1]);
}
catch (error) {
throw new Error(`Invalid YAML frontmatter in ${pathLabel}: ${error instanceof Error ? error.message : String(error)}`);
}
if (!isRecord(parsedFrontmatter)) {
throw new Error(`Frontmatter in ${pathLabel} must be a YAML object`);
}
return {
frontmatter: parsedFrontmatter,
body: match[2] ?? '',
};
}
serializeSkillMarkdown(frontmatter, body) {
const yamlBody = yaml.dump(frontmatter, {
lineWidth: -1,
noRefs: true,
sortKeys: true,
});
const normalizedBody = body.trim();
return `---\n${yamlBody}---\n\n${normalizedBody}\n`;
}
readRequiredString(source, field, warnings, unsupportedFields, path) {
const value = source[field];
if (typeof value === 'string' && value.trim().length > 0) {
return value.trim();
}
warnings.push({
code: 'missing_required_field',
path,
message: `Required string field '${field}' was missing or empty.`,
preserved: false,
});
unsupportedFields.add(path);
return undefined;
}
readString(source, field) {
const value = source[field];
return typeof value === 'string' ? value : undefined;
}
buildDollhouseContent(resourceDirectories, topLevelFiles) {
const sections = [];
const knownOrder = ['references/', 'scripts/', 'agents/', 'assets/'];
const discoveredDirectories = Object.keys(resourceDirectories);
const orderedDirectories = [
...knownOrder.filter(path => Object.hasOwn(resourceDirectories, path)),
...discoveredDirectories
.filter(path => !knownOrder.includes(path))
.sort((a, b) => a.localeCompare(b)),
];
for (const directory of orderedDirectories) {
const files = resourceDirectories[directory];
if (!files) {
continue;
}
const sortedFiles = Object.keys(files).sort((a, b) => a.localeCompare(b));
if (sortedFiles.length === 0) {
continue;
}
const fileBlocks = [];
for (const fileName of sortedFiles) {
const content = files[fileName];
const pathReference = `${directory}${fileName}`;
fileBlocks.push(this.buildContentBlock(pathReference, content, directory));
}
sections.push(`## ${getSectionTitle(directory)}\n\n${fileBlocks.join('\n\n')}`);
}
const topLevelNames = Object.keys(topLevelFiles).sort((a, b) => a.localeCompare(b));
if (topLevelNames.length > 0) {
const topLevelBlocks = topLevelNames.map(fileName => this.buildContentBlock(`${TOP_LEVEL_CONTENT_PREFIX}${fileName}`, topLevelFiles[fileName], ''));
sections.push(`## Top-level Files\n\n${topLevelBlocks.join('\n\n')}`);
}
return sections.join('\n\n').trim();
}
buildContentBlock(pathReference, content, directory) {
if (isBinaryFile(pathReference, content)) {
const linkTarget = deriveBinaryLinkTarget(pathReference, content);
return `### ${pathReference}\n\`\`\`${BINARY_LINK_FENCE}\n${linkTarget}\n\`\`\``;
}
const defaultLanguage = getDefaultLanguageForDirectory(directory);
const shouldInferLanguage = shouldInferLanguageForDirectory(directory);
const language = shouldInferLanguage
? inferLanguageFromFilename(pathReference, defaultLanguage)
: defaultLanguage;
const normalizedContent = content.endsWith('\n')
? content
: `${content}\n`;
return `### ${pathReference}\n\`\`\`${language}\n${normalizedContent}\`\`\``;
}
extractResourcesFromDollhouseContent(content, warnings, unsupportedFields, pathMode) {
const resourceDirectories = {};
const topLevelFiles = {};
if (content.trim().length === 0) {
return {
resourceDirectories,
topLevelFiles,
residualContent: '',
};
}
const mappedSpans = [];
const blockRegex = /(?:^|\n)### ([^\n]+)\n(?:\n)?```([^\n]*)\n([\s\S]*?)\n```(?=\n|$)/g;
let match = null;
while ((match = blockRegex.exec(content)) !== null) {
const leadingOffset = match[0].startsWith('\n') ? 1 : 0;
const start = match.index + leadingOffset;
const end = start + match[0].length - leadingOffset;
const fileReference = match[1].trim();
const fenceLanguage = match[2].trim().toLowerCase();
let fileContent = match[3];
// Backward compatibility: earlier formatter inserted an extra blank line
// after the opening fence and before the closing fence.
if (match[0].includes('```\n\n') && fileContent.startsWith('\n')) {
fileContent = fileContent.slice(1);
}
if (match[0].includes('\n\n```') && fileContent.endsWith('\n')) {
fileContent = fileContent.slice(0, -1);
}
const normalizedFileContent = fenceLanguage === BINARY_LINK_FENCE
? `${BINARY_LINK_PREFIX}${fileContent.trim()}`
: fileContent;
if (fileReference.startsWith(TOP_LEVEL_CONTENT_PREFIX)) {
const topLevelName = fileReference.slice(TOP_LEVEL_CONTENT_PREFIX.length).trim();
if (topLevelName.length === 0 || (pathMode === 'safe' && !isSafeTopLevelFileName(topLevelName))) {
warnings.push({
code: 'invalid_input',
path: `dollhouse.content.${fileReference}`,
message: `Top-level content block '${fileReference}' is not a valid${pathMode === 'safe' ? ' safe' : ''} top-level filename.`,
preserved: false,
});
unsupportedFields.add(`dollhouse.content.${fileReference}`);
continue;
}
topLevelFiles[topLevelName] = normalizedFileContent;
mappedSpans.push({ start, end });
continue;
}
const slashIndex = fileReference.indexOf('/');
if (slashIndex <= 0 || slashIndex >= fileReference.length - 1) {
warnings.push({
code: 'unsupported_field',
path: `dollhouse.content.${fileReference}`,
message: `Content block '${fileReference}' is not in a recognized '<directory>/<file>' format.`,
preserved: true,
});
unsupportedFields.add(`dollhouse.content.${fileReference}`);
continue;
}
const directory = `${fileReference.slice(0, slashIndex + 1)}`;
const fileName = fileReference.slice(slashIndex + 1);
if (pathMode === 'safe' && (!isAllowedAgentDirectory(directory) || !isSafeDirectoryName(directory))) {
warnings.push({
code: 'unsupported_field',
path: `dollhouse.content.${fileReference}`,
message: `Directory '${directory}' is not in the allowed converter directory set.`,
preserved: true,
});
unsupportedFields.add(`dollhouse.content.${fileReference}`);
continue;
}
if (pathMode === 'safe' && !isSafeRelativePath(fileName)) {
warnings.push({
code: 'invalid_input',
path: `dollhouse.content.${fileReference}`,
message: `File path '${fileName}' is not a safe relative path.`,
preserved: false,
});
unsupportedFields.add(`dollhouse.content.${fileReference}`);
continue;
}
if (!resourceDirectories[directory]) {
resourceDirectories[directory] = {};
}
resourceDirectories[directory][fileName] = normalizedFileContent;
mappedSpans.push({ start, end });
}
let residualContent = content;
if (mappedSpans.length > 0) {
const sortedSpans = mappedSpans.sort((a, b) => a.start - b.start);
const pieces = [];
let cursor = 0;
for (const span of sortedSpans) {
pieces.push(residualContent.slice(cursor, span.start));
cursor = span.end;
}
pieces.push(residualContent.slice(cursor));
residualContent = pieces.join('');
}
residualContent = residualContent
.replace(/^## (References|Scripts|Assets|Agent Metadata|Top-level Files|Directory: .+)\n?/gm, '')
.replace(/\n{3,}/g, '\n\n');
residualContent = pruneOrphanSectionHeadings(residualContent).trim();
return {
resourceDirectories,
topLevelFiles,
residualContent,
};
}
}
function inferLanguageFromFilename(fileName, fallback) {
const extension = fileName.includes('.') ? fileName.split('.').pop()?.toLowerCase() : '';
if (!extension) {
return fallback;
}
return LANGUAGE_BY_EXTENSION[extension] ?? fallback;
}
function getSectionTitle(directory) {
return SECTION_TITLE_BY_DIRECTORY[directory] ?? `Directory: ${directory}`;
}
function getDefaultLanguageForDirectory(directory) {
if (directory === 'references/') {
return 'markdown';
}
if (directory === 'agents/') {
return 'yaml';
}
return 'text';
}
function shouldInferLanguageForDirectory(directory) {
return directory !== 'references/';
}
function isBinaryFile(pathReference, content) {
const trimmed = content.trim();
if (trimmed.startsWith(BINARY_LINK_PREFIX)) {
return true;
}
const extension = pathReference.includes('.') ? pathReference.split('.').pop()?.toLowerCase() : '';
if (extension && BINARY_EXTENSIONS.has(extension) && isLikelyPathOrUrl(trimmed) && !trimmed.includes('\n')) {
return true;
}
return false;
}
function deriveBinaryLinkTarget(pathReference, content) {
const trimmed = content.trim();
if (trimmed.startsWith(BINARY_LINK_PREFIX)) {
return trimmed.slice(BINARY_LINK_PREFIX.length).trim();
}
if (isLikelyPathOrUrl(trimmed) && !trimmed.includes('\n')) {
return trimmed;
}
return `./skills/binaries/${extractFileName(pathReference)}`;
}
function isLikelyPathOrUrl(value) {
if (value.length === 0) {
return false;
}
return /^(https?:\/\/|\.{0,2}\/|\/|~\/|[A-Za-z]:[\\/])/.test(value);
}
function pruneOrphanSectionHeadings(markdown) {
const lines = markdown.split('\n');
const cleaned = [];
let idx = 0;
while (idx < lines.length) {
const line = lines[idx];
if (!line.startsWith('## ')) {
cleaned.push(line);
idx += 1;
continue;
}
let probe = idx + 1;
while (probe < lines.length && lines[probe].trim() === '') {
probe += 1;
}
const isOrphan = probe >= lines.length || lines[probe].startsWith('## ');
if (isOrphan) {
idx = probe;
continue;
}
cleaned.push(line);
idx += 1;
}
return cleaned.join('\n');
}
function isAllowedAgentDirectory(directory) {
return ALLOWED_AGENT_DIRECTORIES.has(directory);
}
function isSafeDirectoryName(directory) {
return /^[A-Za-z0-9._-]+\/$/u.test(directory);
}
function isSafeTopLevelFileName(name) {
if (name.length === 0) {
return false;
}
if (name.includes('/') || name.includes('\\')) {
return false;
}
if (name === '.' || name === '..') {
return false;
}
if (name.includes('\0')) {
return false;
}
return true;
}
function isSafeRelativePath(pathValue) {
if (pathValue.length === 0) {
return false;
}
if (/^(\/|~\/|[A-Za-z]:[\\/]|\\\\)/u.test(pathValue)) {
return false;
}
if (pathValue.includes('\0') || pathValue.includes('\\')) {
return false;
}
const segments = pathValue.split('/');
if (segments.some(segment => segment.length === 0 || segment === '.' || segment === '..')) {
return false;
}
return true;
}
function sanitizeRelativePathForReference(pathValue) {
const normalized = pathValue.replace(/\\/g, '/').replace(/^\/+/u, '');
const pieces = normalized
.split('/')
.filter(segment => segment.length > 0 && segment !== '.' && segment !== '..')
.map(segment => sanitizePathToken(segment));
if (pieces.length === 0) {
return 'unknown-file';
}
return pieces.join('/');
}
function sanitizePathToken(token) {
const cleaned = token
.toLowerCase()
.replace(/[^a-z0-9._-]+/g, '-')
.replace(/-+/g, '-')
.replace(/^-+|-+$/g, '');
return cleaned.length > 0 ? cleaned : 'unknown';
}
function extractFileName(pathReference) {
const normalized = pathReference.replace(/\\/g, '/');
const segments = normalized.split('/').filter(segment => segment.length > 0);
const candidate = segments.length > 0 ? segments[segments.length - 1] : 'binary.dat';
return sanitizePathToken(candidate) || 'binary.dat';
}
function isRecord(value) {
return typeof value === 'object' && value !== null && !Array.isArray(value);
}
function isStringRecord(value) {
return isRecord(value) && Object.values(value).every(item => typeof item === 'string');
}
function clone(value) {
if (typeof globalThis.structuredClone === 'function') {
return globalThis.structuredClone(value);
}
return JSON.parse(JSON.stringify(value));
}
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQWdlbnRTa2lsbENvbnZlcnRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9jb252ZXJ0ZXJzL0FnZW50U2tpbGxDb252ZXJ0ZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLElBQUksTUFBTSxTQUFTLENBQUM7QUFDaEMsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDbkUsT0FBTyxFQUNMLHNCQUFzQixFQUN0QixxQkFBcUIsRUFDckIsbUJBQW1CLEVBQ25CLHFCQUFxQixFQUNyQiwwQkFBMEIsRUFDMUIsd0JBQXdCLEVBQ3hCLGlCQUFpQixFQUNqQixrQkFBa0IsRUFDbEIseUJBQXlCLEVBQ3pCLHlCQUF5QixFQUN6Qix5QkFBeUIsRUFDekIsaUJBQWlCLEVBQ2pCLGdDQUFnQyxFQUNoQywrQkFBK0IsRUFDL0Isb0JBQW9CLEVBQ3BCLDRDQUE0QyxFQUM1Qyw0Q0FBNEMsR0FDN0MsTUFBTSxvQ0FBb0MsQ0FBQztBQUM1QyxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNuRSxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFFNUMsTUFBTSxDQUFDLE1BQU0sMkJBQTJCLEdBQUcsZ0JBQWdCLENBQUM7QUFpRjVELE1BQU0sT0FBTyxtQkFBbUI7SUFDOUIsT0FBTyxDQUFDLE9BQStCO1FBQ3JDLE1BQU0sU0FBUyxHQUFHLFdBQVcsQ0FBQyxHQUFHLEVBQUUsQ0FBQztRQUNwQyxNQUFNLGNBQWMsR0FBRyxPQUFPLENBQUMsV0FBVyxFQUFFLENBQUMsUUFBUSxDQUFDO1FBQ3RELE1BQU0sUUFBUSxHQUFHLE9BQU8sQ0FBQyxTQUFTLElBQUksTUFBTSxDQUFDO1FBQzdDLE1BQU0sWUFBWSxHQUFHLE9BQU8sQ0FBQyxhQUFhLElBQUksUUFBUSxDQUFDO1FBQ3ZELElBQUksQ0FBQyxtQkFBbUIsQ0FBQyxPQUFPLENBQUMsQ0FB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