@holoscript/framework 6.0.3 → 6.0.4

package/dist/skills/index.js

@@ -1,1079 +0,0 @@
-// src/skills/skill-md-bridge.ts
-function parseHsplus(source) {
-  const errors = [];
-  const warnings = [];
-  const sourceComments = extractLeadingComments(source);
-  const compositionMatch = source.match(/composition\s+"([^"]+)"\s*\{/);
-  if (!compositionMatch) {
-    errors.push('No composition declaration found. Expected: composition "name" { ... }');
-    return { success: false, errors, warnings };
-  }
-  const compositionName = compositionMatch[1];
-  const description = extractDescription(sourceComments);
-  const versionMatch = source.match(/@version\s+([\d.]+)/);
-  const version = versionMatch ? versionMatch[1] : "1.0.0";
-  const traits = extractTraits(source);
-  const state = extractStateVars(source);
-  const steps = extractBTSteps(source);
-  const tests = extractTests(source);
-  const environment = extractEnvironment(source);
-  const objects = extractObjectNames(source);
-  const economyTrait = traits.find((t) => t.name === "economy");
-  const spendLimit = economyTrait?.config?.default_spend_limit;
-  const inputSchema = extractSchemaFields(source, "input_schema");
-  const outputSchema = extractSchemaFields(source, "output_schema");
-  const tagsMatch = source.match(/@tags\s+(.+)/);
-  const tags = tagsMatch ? tagsMatch[1].split(",").map((t) => t.trim()).filter(Boolean) : void 0;
-  const metadata = {
-    name: compositionName,
-    description: description || `HoloClaw skill: ${compositionName}`,
-    version,
-    author: "HoloScript",
-    holoCliVersion: "5.0.0",
-    nodeVersion: "20",
-    spendLimit,
-    userInvocable: true,
-    inputSchema: inputSchema.length > 0 ? inputSchema : void 0,
-    outputSchema: outputSchema.length > 0 ? outputSchema : void 0,
-    tags
-  };
-  return {
-    success: true,
-    data: {
-      metadata,
-      traits,
-      state,
-      steps,
-      tests,
-      environment: environment || void 0,
-      objects: objects.length > 0 ? objects : void 0,
-      sourceComments
-    },
-    errors,
-    warnings
-  };
-}
-function toSkillMd(skill) {
-  const errors = [];
-  const warnings = [];
-  const lines = [];
-  lines.push("---");
-  lines.push(`name: ${skill.metadata.name}`);
-  lines.push("description: >");
-  const descWords = skill.metadata.description.split(/\s+/);
-  let descLine = "  ";
-  for (const word of descWords) {
-    if (descLine.length + word.length + 1 > 80) {
-      lines.push(descLine);
-      descLine = "  " + word;
-    } else {
-      descLine += (descLine.trim().length > 0 ? " " : "") + word;
-    }
-  }
-  if (descLine.trim().length > 0) lines.push(descLine);
-  if (skill.metadata.version !== "1.0.0") {
-    lines.push(`version: ${skill.metadata.version}`);
-  }
-  if (skill.metadata.author && skill.metadata.author !== "HoloScript") {
-    lines.push(`author: ${skill.metadata.author}`);
-  }
-  if (skill.metadata.category) {
-    lines.push(`category: ${skill.metadata.category}`);
-  }
-  if (skill.metadata.tags && skill.metadata.tags.length > 0) {
-    lines.push(`tags: [${skill.metadata.tags.join(", ")}]`);
-  }
-  if (skill.metadata.homepage) {
-    lines.push(`homepage: ${skill.metadata.homepage}`);
-  }
-  if (skill.metadata.license) {
-    lines.push(`license: ${skill.metadata.license}`);
-  }
-  if (skill.metadata.repository) {
-    lines.push(`repository: ${skill.metadata.repository}`);
-  }
-  if (skill.metadata.inputSchema && skill.metadata.inputSchema.length > 0) {
-    lines.push("input_schema:");
-    for (const field of skill.metadata.inputSchema) {
-      lines.push(`  - name: ${field.name}`);
-      lines.push(`    type: ${field.type}`);
-      if (field.required !== void 0) lines.push(`    required: ${field.required}`);
-      lines.push(`    description: ${field.description}`);
-      if (field.default !== void 0) lines.push(`    default: ${JSON.stringify(field.default)}`);
-    }
-  }
-  if (skill.metadata.outputSchema && skill.metadata.outputSchema.length > 0) {
-    lines.push("output_schema:");
-    for (const field of skill.metadata.outputSchema) {
-      lines.push(`  - name: ${field.name}`);
-      lines.push(`    type: ${field.type}`);
-      lines.push(`    description: ${field.description}`);
-    }
-  }
-  lines.push("---");
-  lines.push("");
-  const titleName = skill.metadata.name.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
-  lines.push(`# ${titleName}`);
-  lines.push("");
-  lines.push(skill.metadata.description);
-  lines.push("");
-  lines.push("## Runtime Requirements");
-  lines.push("");
-  lines.push(`- **holoscript-cli** >= ${skill.metadata.holoCliVersion || "5.0.0"}`);
-  lines.push(`- **Node.js** >= ${skill.metadata.nodeVersion || "20"}`);
-  if (skill.metadata.spendLimit !== void 0) {
-    lines.push(`- **Economy budget**: $${skill.metadata.spendLimit.toFixed(2)} per invocation`);
-  }
-  lines.push("");
-  if (skill.traits.length > 0) {
-    lines.push("## Traits");
-    lines.push("");
-    for (const trait of skill.traits) {
-      const configStr = Object.keys(trait.config).length > 0 ? ` (${Object.entries(trait.config).map(([k, v]) => `${k}: ${JSON.stringify(v)}`).join(", ")})` : "";
-      lines.push(`- \`@${trait.name}\`${configStr}`);
-    }
-    lines.push("");
-  }
-  if (skill.state.length > 0) {
-    lines.push("## State Schema");
-    lines.push("");
-    lines.push("| Variable | Type | Default |");
-    lines.push("|----------|------|---------|");
-    for (const sv of skill.state) {
-      lines.push(`| \`${sv.name}\` | ${sv.type} | \`${JSON.stringify(sv.defaultValue)}\` |`);
-    }
-    lines.push("");
-  }
-  if (skill.metadata.inputSchema && skill.metadata.inputSchema.length > 0) {
-    lines.push("## Input Schema");
-    lines.push("");
-    lines.push("| Field | Type | Required | Description |");
-    lines.push("|-------|------|----------|-------------|");
-    for (const field of skill.metadata.inputSchema) {
-      const req = field.required ? "yes" : "no";
-      const defaultStr = field.default !== void 0 ? ` (default: \`${JSON.stringify(field.default)}\`)` : "";
-      lines.push(
-        `| \`${field.name}\` | ${field.type} | ${req} | ${field.description}${defaultStr} |`
-      );
-    }
-    lines.push("");
-  }
-  if (skill.metadata.outputSchema && skill.metadata.outputSchema.length > 0) {
-    lines.push("## Output Schema");
-    lines.push("");
-    lines.push("| Field | Type | Description |");
-    lines.push("|-------|------|-------------|");
-    for (const field of skill.metadata.outputSchema) {
-      lines.push(`| \`${field.name}\` | ${field.type} | ${field.description} |`);
-    }
-    lines.push("");
-  }
-  if (skill.environment && Object.keys(skill.environment).length > 0) {
-    lines.push("## Environment");
-    lines.push("");
-    lines.push("```yaml");
-    for (const [key, val] of Object.entries(skill.environment)) {
-      lines.push(`${key}: ${JSON.stringify(val)}`);
-    }
-    lines.push("```");
-    lines.push("");
-  }
-  if (skill.steps.length > 0) {
-    lines.push("## Workflow");
-    lines.push("");
-    let stepNum = 1;
-    for (const step of skill.steps) {
-      if (step.nodeType === "sequence" || step.nodeType === "selector") {
-        lines.push(`### ${step.description || step.action}`);
-        lines.push("");
-      } else {
-        const paramsStr = Object.keys(step.params).length > 0 ? ` (${Object.entries(step.params).map(([k, v]) => `${k}: ${JSON.stringify(v)}`).join(", ")})` : "";
-        lines.push(`${stepNum}. **${step.action}**${paramsStr}`);
-        if (step.description) {
-          lines.push(`   ${step.description}`);
-        }
-        stepNum++;
-      }
-    }
-    lines.push("");
-  }
-  if (skill.objects && skill.objects.length > 0) {
-    lines.push("## Scene Objects");
-    lines.push("");
-    for (const obj of skill.objects) {
-      lines.push(`- \`${obj}\``);
-    }
-    lines.push("");
-  }
-  if (skill.tests.length > 0) {
-    lines.push("## Tests");
-    lines.push("");
-    lines.push(`${skill.tests.length} built-in assertions:`);
-    lines.push("");
-    for (const test of skill.tests) {
-      lines.push(`- **${test.name}**: \`${test.assert}\``);
-    }
-    lines.push("");
-  }
-  lines.push("## Installation");
-  lines.push("");
-  lines.push("```bash");
-  lines.push(`# Via HoloClaw CLI`);
-  lines.push(`hs claw install ${skill.metadata.name}`);
-  lines.push("");
-  lines.push("# Via ClawHub registry");
-  lines.push(`clawhub install @holoscript/${skill.metadata.name}`);
-  lines.push("");
-  lines.push("# Manual: copy to compositions/skills/");
-  lines.push(`cp ${skill.metadata.name}.hsplus compositions/skills/`);
-  lines.push("```");
-  lines.push("");
-  lines.push("## Usage");
-  lines.push("");
-  lines.push("```bash");
-  lines.push(`# Run standalone`);
-  lines.push(`hs run compositions/skills/${skill.metadata.name}.hsplus`);
-  lines.push("");
-  lines.push("# Run as HoloClaw skill (hot-reload)");
-  lines.push(`hs daemon compositions/holoclaw.hsplus --always-on`);
-  lines.push("```");
-  lines.push("");
-  lines.push("---");
-  lines.push("");
-  lines.push(`*Generated by HoloScript Skill-MD Bridge v1.0.0*`);
-  lines.push(`*Source format: .hsplus (HoloClaw native composition)*`);
-  lines.push("");
-  return {
-    success: true,
-    data: lines.join("\n"),
-    errors,
-    warnings
-  };
-}
-function hsplusToSkillMd(source) {
-  const parsed = parseHsplus(source);
-  if (!parsed.success || !parsed.data) {
-    return { success: false, errors: parsed.errors, warnings: parsed.warnings };
-  }
-  return toSkillMd(parsed.data);
-}
-function parseSkillMd(markdown) {
-  const errors = [];
-  const warnings = [];
-  const frontmatter = extractFrontmatter(markdown);
-  if (!frontmatter) {
-    errors.push("No YAML frontmatter found. Expected --- delimited block at start of file.");
-    return { success: false, errors, warnings };
-  }
-  const name = frontmatter.name;
-  if (!name) {
-    errors.push('Frontmatter missing required "name" field.');
-    return { success: false, errors, warnings };
-  }
-  const description = frontmatter.description || "";
-  const version = frontmatter.version || "1.0.0";
-  const author = frontmatter.author || "HoloScript";
-  const body = extractBody(markdown);
-  const inputSchemaFm = parseFrontmatterSchemaList(frontmatter["input_schema"]);
-  const outputSchemaFm = parseFrontmatterSchemaList(frontmatter["output_schema"]);
-  const inputSchemaBody = extractInputSchemaFromMd(body);
-  const outputSchemaBody = extractOutputSchemaFromMd(body);
-  const inputSchema = inputSchemaFm.length > 0 ? inputSchemaFm : inputSchemaBody;
-  const outputSchema = outputSchemaFm.length > 0 ? outputSchemaFm : outputSchemaBody;
-  const metadata = {
-    name,
-    description: typeof description === "string" ? description.trim() : String(description),
-    version,
-    author,
-    category: frontmatter.category,
-    tags: frontmatter.tags,
-    inputSchema: inputSchema.length > 0 ? inputSchema : void 0,
-    outputSchema: outputSchema.length > 0 ? outputSchema : void 0,
-    holoCliVersion: frontmatter["holoscript-cli"] || "5.0.0",
-    nodeVersion: frontmatter["node-version"] || "20",
-    license: frontmatter.license,
-    homepage: frontmatter.homepage,
-    repository: frontmatter.repository,
-    userInvocable: frontmatter["user-invocable"] !== false
-  };
-  const traits = extractTraitsFromMd(body);
-  const state = extractStateFromMd(body);
-  const steps = extractStepsFromMd(body);
-  const tests = extractTestsFromMd(body);
-  const environment = extractEnvironmentFromMd(body);
-  return {
-    success: true,
-    data: {
-      metadata,
-      traits: traits.length > 0 ? traits : getDefaultTraits(),
-      state,
-      steps,
-      tests,
-      environment: environment || void 0,
-      sourceComments: []
-    },
-    errors,
-    warnings
-  };
-}
-function toHsplus(skill) {
-  const errors = [];
-  const warnings = [];
-  const lines = [];
-  lines.push(
-    `// ${titleCase(skill.metadata.name)} -- ${skill.metadata.description.split("\n")[0]}`
-  );
-  if (skill.metadata.description.includes("\n")) {
-    for (const line of skill.metadata.description.split("\n").slice(1)) {
-      if (line.trim()) lines.push(`// ${line.trim()}`);
-    }
-  }
-  lines.push(`// Installed via HoloClaw Shelf. Hot-reloads into running daemon.`);
-  if (skill.metadata.version !== "1.0.0") {
-    lines.push(`//`);
-    lines.push(`// @version ${skill.metadata.version}`);
-  }
-  lines.push("");
-  lines.push(`composition "${skill.metadata.name}" {`);
-  for (const trait of skill.traits) {
-    const configEntries = Object.entries(trait.config);
-    if (configEntries.length === 0) {
-      lines.push(`  @${trait.name}`);
-    } else if (configEntries.length === 1) {
-      const [k, v] = configEntries[0];
-      lines.push(`  @${trait.name} (${k}: ${formatHsplusValue(v)})`);
-    } else {
-      lines.push(`  @${trait.name} {`);
-      for (const [k, v] of configEntries) {
-        lines.push(`    ${k}: ${formatHsplusValue(v)}`);
-      }
-      lines.push(`  }`);
-    }
-  }
-  lines.push("");
-  for (const sv of skill.state) {
-    lines.push(`  state ${sv.name}: ${sv.type} = ${formatHsplusValue(sv.defaultValue)}`);
-  }
-  if (skill.state.length > 0) lines.push("");
-  if (skill.environment && Object.keys(skill.environment).length > 0) {
-    lines.push("  environment {");
-    for (const [key, val] of Object.entries(skill.environment)) {
-      lines.push(`    ${key}: ${formatHsplusValue(val)}`);
-    }
-    lines.push("  }");
-    lines.push("");
-  }
-  if (skill.steps.length > 0) {
-    const topSequences = groupStepsIntoSequences(skill.steps);
-    for (const seq of topSequences) {
-      emitBTNode(lines, seq, 2);
-    }
-    lines.push("");
-  }
-  if (skill.tests.length > 0) {
-    lines.push("  // -- Tests --");
-    lines.push("");
-    for (const test of skill.tests) {
-      lines.push("  @test {");
-      lines.push(`    name: "${test.name}"`);
-      if (test.setup) {
-        lines.push(`    setup: { ${test.setup} }`);
-      }
-      lines.push(`    assert: { ${test.assert} }`);
-      lines.push("  }");
-      lines.push("");
-    }
-  }
-  lines.push("}");
-  lines.push("");
-  return {
-    success: true,
-    data: lines.join("\n"),
-    errors,
-    warnings
-  };
-}
-function skillMdToHsplus(markdown) {
-  const parsed = parseSkillMd(markdown);
-  if (!parsed.success || !parsed.data) {
-    return { success: false, errors: parsed.errors, warnings: parsed.warnings };
-  }
-  return toHsplus(parsed.data);
-}
-function generateClawHubManifest(skill, registryUrl = "https://registry.clawhub.com") {
-  return {
-    name: `@holoscript/${skill.metadata.name}`,
-    version: skill.metadata.version,
-    description: skill.metadata.description,
-    author: skill.metadata.author,
-    license: skill.metadata.license || "MIT",
-    registryUrl,
-    tags: skill.metadata.tags,
-    homepage: skill.metadata.homepage,
-    repository: skill.metadata.repository,
-    holoScript: {
-      format: "hsplus",
-      minCliVersion: skill.metadata.holoCliVersion || "5.0.0",
-      traits: skill.traits.map((t) => t.name),
-      stateVars: skill.state.map((s) => s.name),
-      testCount: skill.tests.length,
-      inputFields: (skill.metadata.inputSchema || []).map((f) => f.name),
-      outputFields: (skill.metadata.outputSchema || []).map((f) => f.name)
-    },
-    files: [`${skill.metadata.name}.hsplus`, "SKILL.md", "clawhub.json"]
-  };
-}
-function generateClawHubPackage(source) {
-  const parsed = parseHsplus(source);
-  if (!parsed.success || !parsed.data) {
-    return { success: false, errors: parsed.errors, warnings: parsed.warnings };
-  }
-  const skill = parsed.data;
-  const skillMdResult = toSkillMd(skill);
-  if (!skillMdResult.success || !skillMdResult.data) {
-    return { success: false, errors: skillMdResult.errors, warnings: skillMdResult.warnings };
-  }
-  const manifest = generateClawHubManifest(skill);
-  const files = /* @__PURE__ */ new Map();
-  files.set(`${skill.metadata.name}.hsplus`, source);
-  files.set("SKILL.md", skillMdResult.data);
-  files.set("clawhub.json", JSON.stringify(manifest, null, 2));
-  return {
-    success: true,
-    data: files,
-    errors: [],
-    warnings: []
-  };
-}
-function getPublishCommand(skillName, registry = "https://registry.clawhub.com") {
-  return `clawhub publish @holoscript/${skillName} --registry ${registry}`;
-}
-function getInstallCommand(skillName, targetDir = "compositions/skills", registry = "https://registry.clawhub.com") {
-  return `clawhub install @holoscript/${skillName} --target ${targetDir} --registry ${registry}`;
-}
-function getHsInstallCommand(skillName) {
-  return `hs claw install ${skillName}`;
-}
-function extractLeadingComments(source) {
-  const lines = source.split("\n");
-  const comments = [];
-  for (const line of lines) {
-    const trimmed = line.trim();
-    if (trimmed.startsWith("//")) {
-      comments.push(trimmed.replace(/^\/\/\s?/, ""));
-    } else if (trimmed === "" && comments.length > 0) {
-      continue;
-    } else {
-      break;
-    }
-  }
-  return comments;
-}
-function extractDescription(comments) {
-  const descLines = [];
-  for (const line of comments) {
-    if (line.startsWith("@") || line.startsWith("*") || line === "") continue;
-    descLines.push(line);
-  }
-  return descLines.join(" ").trim();
-}
-function extractTraits(source) {
-  const traits = [];
-  const traitRegex = /^\s{2}@(\w+)(?:\s*\(([^)]*)\))?(?:\s*\{([^}]*)\})?/gm;
-  let match;
-  while ((match = traitRegex.exec(source)) !== null) {
-    const name = match[1];
-    if (name === "test" || name === "version") continue;
-    const config = {};
-    const inlineConfig = match[2] || match[3];
-    if (inlineConfig) {
-      parseTraitConfig(inlineConfig, config);
-    }
-    traits.push({ name, config });
-  }
-  return traits;
-}
-function parseTraitConfig(configStr, config) {
-  const pairs = configStr.split(/,|\n/).map((s) => s.trim()).filter(Boolean);
-  for (const pair of pairs) {
-    const colonIdx = pair.indexOf(":");
-    if (colonIdx === -1) continue;
-    const key = pair.slice(0, colonIdx).trim();
-    const rawVal = pair.slice(colonIdx + 1).trim();
-    config[key] = parseConfigValue(rawVal);
-  }
-}
-function parseConfigValue(raw) {
-  if (/^-?\d+(\.\d+)?$/.test(raw)) return parseFloat(raw);
-  if (raw === "true") return true;
-  if (raw === "false") return false;
-  if (raw.startsWith('"') && raw.endsWith('"') || raw.startsWith("'") && raw.endsWith("'")) {
-    return raw.slice(1, -1);
-  }
-  return raw;
-}
-function extractStateVars(source) {
-  const vars = [];
-  const inlineRegex = /^\s+state\s+(\w+)\s*:\s*(\w+)\s*=\s*(.+)$/gm;
-  let match;
-  while ((match = inlineRegex.exec(source)) !== null) {
-    const name = match[1];
-    const type = match[2];
-    const rawVal = match[3].trim();
-    vars.push({ name, type, defaultValue: parseStateDefault(rawVal, type) });
-  }
-  const blockMatch = source.match(/\bstate\s*\{([^}]*)\}/);
-  if (blockMatch && vars.length === 0) {
-    const blockContent = blockMatch[1];
-    const lineRegex = /^\s*(\w+)\s*:\s*(.+)$/gm;
-    let lineMatch;
-    while ((lineMatch = lineRegex.exec(blockContent)) !== null) {
-      const name = lineMatch[1];
-      const rawVal = lineMatch[2].trim();
-      const type = inferType(rawVal);
-      vars.push({ name, type, defaultValue: parseStateDefault(rawVal, type) });
-    }
-  }
-  return vars;
-}
-function parseStateDefault(raw, type) {
-  const cleaned = raw.replace(/[,;]$/, "").trim();
-  if (type === "number") return parseFloat(cleaned) || 0;
-  if (type === "boolean") return cleaned === "true";
-  if (cleaned.startsWith('"') && cleaned.endsWith('"')) return cleaned.slice(1, -1);
-  if (cleaned.startsWith("'") && cleaned.endsWith("'")) return cleaned.slice(1, -1);
-  return cleaned;
-}
-function inferType(raw) {
-  const cleaned = raw.replace(/[,;]$/, "").trim();
-  if (/^-?\d+(\.\d+)?$/.test(cleaned)) return "number";
-  if (cleaned === "true" || cleaned === "false") return "boolean";
-  return "string";
-}
-function extractBTSteps(source) {
-  const steps = [];
-  const seqRegex = /\b(sequence|selector)\s+"([^"]+)"\s*\{/g;
-  let match;
-  while ((match = seqRegex.exec(source)) !== null) {
-    steps.push({
-      action: match[2],
-      description: match[2].replace(/-/g, " "),
-      params: {},
-      nodeType: match[1]
-    });
-  }
-  const actionRegex = /\baction\s+"([^"]+)"\s*\{([^}]*)\}/g;
-  while ((match = actionRegex.exec(source)) !== null) {
-    const actionName = match[1];
-    const body = match[2];
-    const params = {};
-    const desc = extractActionComment(body);
-    const paramRegex = /^\s*(\w+)\s*:\s*(.+)$/gm;
-    let paramMatch;
-    while ((paramMatch = paramRegex.exec(body)) !== null) {
-      const key = paramMatch[1];
-      const val = paramMatch[2].trim();
-      if (val.startsWith("//")) continue;
-      params[key] = parseConfigValue(val);
-    }
-    steps.push({
-      action: actionName,
-      description: desc || actionName.replace(/_/g, " "),
-      params,
-      nodeType: "action"
-    });
-  }
-  return steps;
-}
-function extractActionComment(body) {
-  const commentMatch = body.match(/\/\/\s*(.+)/);
-  return commentMatch ? commentMatch[1].trim() : "";
-}
-function extractTests(source) {
-  const tests = [];
-  const testStarts = [...source.matchAll(/@test\s*\{/g)];
-  for (const startMatch of testStarts) {
-    const startIdx = startMatch.index + startMatch[0].length;
-    let depth = 1;
-    let i = startIdx;
-    while (i < source.length && depth > 0) {
-      if (source[i] === "{") depth++;
-      if (source[i] === "}") depth--;
-      i++;
-    }
-    const block = source.slice(startIdx, i - 1);
-    const nameMatch = block.match(/name\s*:\s*"([^"]+)"/);
-    const assertMatch = block.match(/assert\s*:\s*\{([^}]+)\}/);
-    const setupMatch = block.match(/setup\s*:\s*\{([^}]+)\}/);
-    if (nameMatch && assertMatch) {
-      tests.push({
-        name: nameMatch[1],
-        assert: assertMatch[1].trim(),
-        setup: setupMatch ? setupMatch[1].trim() : void 0
-      });
-    }
-  }
-  return tests;
-}
-function extractEnvironment(source) {
-  const envMatch = source.match(/\benvironment\s*\{([^}]*)\}/);
-  if (!envMatch) return null;
-  const config = {};
-  const lineRegex = /^\s*(\w+)\s*:\s*(.+)$/gm;
-  let match;
-  while ((match = lineRegex.exec(envMatch[1])) !== null) {
-    config[match[1]] = parseConfigValue(match[2].trim());
-  }
-  return config;
-}
-function extractObjectNames(source) {
-  const names = [];
-  const objRegex = /\bobject\s+"([^"]+)"\s*\{/g;
-  let match;
-  while ((match = objRegex.exec(source)) !== null) {
-    names.push(match[1]);
-  }
-  return names;
-}
-function extractSchemaFields(source, blockName) {
-  const fields = [];
-  const startRegex = new RegExp(`@${blockName}\\s*\\{`);
-  const startMatch = startRegex.exec(source);
-  if (!startMatch) return fields;
-  const startIdx = startMatch.index + startMatch[0].length;
-  let depth = 1;
-  let i = startIdx;
-  while (i < source.length && depth > 0) {
-    if (source[i] === "{") depth++;
-    if (source[i] === "}") depth--;
-    i++;
-  }
-  const block = source.slice(startIdx, i - 1);
-  const lineRegex = /^\s*(\w+)\s*:\s*(\w+)(?:\s*\(required\))?(?:\s*=\s*([^\s"]+))?(?:\s*"([^"]*)")?/gm;
-  let lineMatch;
-  while ((lineMatch = lineRegex.exec(block)) !== null) {
-    const name = lineMatch[1];
-    const type = lineMatch[2];
-    const isRequired = lineMatch[0].includes("(required)");
-    const defaultVal = lineMatch[3] ? parseConfigValue(lineMatch[3]) : void 0;
-    const description = lineMatch[4] || name;
-    fields.push({
-      name,
-      type,
-      required: isRequired || void 0,
-      description,
-      default: defaultVal
-    });
-  }
-  return fields;
-}
-function extractFrontmatter(markdown) {
-  const fmMatch = markdown.match(/^---\s*\n([\s\S]*?)\n---/);
-  if (!fmMatch) return null;
-  return parseSimpleYaml(fmMatch[1]);
-}
-function parseSimpleYaml(yaml) {
-  const result = {};
-  const lines = yaml.split("\n");
-  let currentKey = null;
-  let multilineValue = [];
-  let inMultiline = false;
-  let inListOfObjects = false;
-  let listKey = null;
-  let currentListItem = null;
-  let listItems = [];
-  for (let lineIdx = 0; lineIdx < lines.length; lineIdx++) {
-    const line = lines[lineIdx];
-    if (inListOfObjects && listKey) {
-      const listItemStart = line.match(/^\s{2,}-\s+(\w[\w-]*)\s*:\s*(.*)/);
-      if (listItemStart) {
-        if (currentListItem) listItems.push(currentListItem);
-        currentListItem = {};
-        const key = listItemStart[1];
-        const val = listItemStart[2].trim();
-        currentListItem[key] = parseConfigValue(val);
-        continue;
-      }
-      const listItemCont = line.match(/^\s{4,}(\w[\w-]*)\s*:\s*(.*)/);
-      if (listItemCont && currentListItem) {
-        const key = listItemCont[1];
-        const val = listItemCont[2].trim();
-        currentListItem[key] = parseConfigValue(val);
-        continue;
-      }
-      if (currentListItem) listItems.push(currentListItem);
-      result[listKey] = listItems;
-      inListOfObjects = false;
-      listKey = null;
-      currentListItem = null;
-      listItems = [];
-    }
-    if (inMultiline) {
-      if (line.match(/^\s{2,}/) && !line.match(/^\S/)) {
-        multilineValue.push(line.trim());
-        continue;
-      } else {
-        if (currentKey) {
-          result[currentKey] = multilineValue.join(" ");
-        }
-        inMultiline = false;
-        currentKey = null;
-        multilineValue = [];
-      }
-    }
-    const kvMatch = line.match(/^([a-zA-Z_][\w-]*)\s*:\s*(.*)/);
-    if (kvMatch) {
-      const key = kvMatch[1];
-      const rawVal = kvMatch[2].trim();
-      if (rawVal === ">") {
-        currentKey = key;
-        inMultiline = true;
-        multilineValue = [];
-        continue;
-      }
-      if (rawVal === "") {
-        let peekIdx = lineIdx + 1;
-        while (peekIdx < lines.length && lines[peekIdx].trim() === "") peekIdx++;
-        if (peekIdx < lines.length && /^\s{2,}-\s/.test(lines[peekIdx])) {
-          inListOfObjects = true;
-          listKey = key;
-          currentListItem = null;
-          listItems = [];
-          continue;
-        }
-        result[key] = "";
-        continue;
-      }
-      if (rawVal.startsWith("[") && rawVal.endsWith("]")) {
-        result[key] = rawVal.slice(1, -1).split(",").map((s) => s.trim()).filter(Boolean);
-        continue;
-      }
-      result[key] = parseConfigValue(rawVal);
-    }
-  }
-  if (inMultiline && currentKey) {
-    result[currentKey] = multilineValue.join(" ");
-  }
-  if (inListOfObjects && listKey) {
-    if (currentListItem) listItems.push(currentListItem);
-    result[listKey] = listItems;
-  }
-  return result;
-}
-function extractBody(markdown) {
-  const fmEnd = markdown.indexOf("---", 3);
-  if (fmEnd === -1) return markdown;
-  return markdown.slice(fmEnd + 3).trim();
-}
-function extractTraitsFromMd(body) {
-  const traits = [];
-  const traitsSection = extractSection(body, "Traits");
-  if (!traitsSection) return traits;
-  const traitRegex = /`@(\w+)`(?:\s*\(([^)]+)\))?/g;
-  let match;
-  while ((match = traitRegex.exec(traitsSection)) !== null) {
-    const config = {};
-    if (match[2]) {
-      parseTraitConfig(match[2], config);
-    }
-    traits.push({ name: match[1], config });
-  }
-  return traits;
-}
-function extractStateFromMd(body) {
-  const vars = [];
-  const stateSection = extractSection(body, "State Schema");
-  if (!stateSection) return vars;
-  const rowRegex = /\|\s*`(\w+)`\s*\|\s*(\w+)\s*\|\s*`([^`]+)`\s*\|/g;
-  let match;
-  while ((match = rowRegex.exec(stateSection)) !== null) {
-    const name = match[1];
-    const type = match[2];
-    const rawDefault = match[3];
-    vars.push({
-      name,
-      type,
-      defaultValue: parseStateDefault(rawDefault, type)
-    });
-  }
-  return vars;
-}
-function extractStepsFromMd(body) {
-  const steps = [];
-  const workflowSection = extractSection(body, "Workflow");
-  if (!workflowSection) return steps;
-  const subsectionRegex = /###\s+(.+)/g;
-  let match;
-  while ((match = subsectionRegex.exec(workflowSection)) !== null) {
-    steps.push({
-      action: match[1].trim().toLowerCase().replace(/\s+/g, "-"),
-      description: match[1].trim(),
-      params: {},
-      nodeType: "sequence"
-    });
-  }
-  const stepRegex = /\d+\.\s+\*\*([^*]+)\*\*(?:\s*\(([^)]+)\))?(?:\s*\n\s+(.+))?/g;
-  while ((match = stepRegex.exec(workflowSection)) !== null) {
-    const params = {};
-    if (match[2]) {
-      parseTraitConfig(match[2], params);
-    }
-    steps.push({
-      action: match[1].trim(),
-      description: match[3]?.trim() || match[1].trim().replace(/_/g, " "),
-      params,
-      nodeType: "action"
-    });
-  }
-  return steps;
-}
-function extractTestsFromMd(body) {
-  const tests = [];
-  const testsSection = extractSection(body, "Tests");
-  if (!testsSection) return tests;
-  const testRegex = /-\s+\*\*([^*]+)\*\*\s*:\s*`([^`]+)`/g;
-  let match;
-  while ((match = testRegex.exec(testsSection)) !== null) {
-    tests.push({
-      name: match[1].trim(),
-      assert: match[2].trim()
-    });
-  }
-  return tests;
-}
-function extractEnvironmentFromMd(body) {
-  const envSection = extractSection(body, "Environment");
-  if (!envSection) return null;
-  const config = {};
-  const codeBlockMatch = envSection.match(/```(?:yaml)?\s*\n([\s\S]*?)```/);
-  if (codeBlockMatch) {
-    const parsed = parseSimpleYaml(codeBlockMatch[1]);
-    for (const [k, v] of Object.entries(parsed)) {
-      config[k] = v;
-    }
-  }
-  return Object.keys(config).length > 0 ? config : null;
-}
-function extractSection(body, heading) {
-  const escapedHeading = heading.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-  const sectionRegex = new RegExp(`##\\s+${escapedHeading}\\s*
-([\\s\\S]*?)(?=\\n##\\s|$)`);
-  const match = body.match(sectionRegex);
-  return match ? match[1].trim() : null;
-}
-function parseFrontmatterSchemaList(raw) {
-  if (!raw) return [];
-  if (Array.isArray(raw)) {
-    return raw.filter(
-      (item) => item && typeof item === "object" && "name" in item
-    ).map((item) => ({
-      name: String(item.name || ""),
-      type: String(item.type || "string"),
-      required: item.required === true || item.required === "true" || void 0,
-      description: String(item.description || item.name || ""),
-      default: item.default
-    }));
-  }
-  return [];
-}
-function extractInputSchemaFromMd(body) {
-  const fields = [];
-  const section = extractSection(body, "Input Schema");
-  if (!section) return fields;
-  const rowRegex = /\|\s*`(\w+)`\s*\|\s*(\w+)\s*\|\s*(yes|no)\s*\|\s*([^|]+)\|/g;
-  let match;
-  while ((match = rowRegex.exec(section)) !== null) {
-    const name = match[1];
-    const type = match[2];
-    const required = match[3] === "yes";
-    let description = match[4].trim();
-    let defaultVal;
-    const defaultMatch = description.match(/\(default:\s*`([^`]+)`\)/);
-    if (defaultMatch) {
-      defaultVal = parseConfigValue(defaultMatch[1]);
-      description = description.replace(/\s*\(default:\s*`[^`]+`\)/, "").trim();
-    }
-    fields.push({ name, type, required: required || void 0, description, default: defaultVal });
-  }
-  return fields;
-}
-function extractOutputSchemaFromMd(body) {
-  const fields = [];
-  const section = extractSection(body, "Output Schema");
-  if (!section) return fields;
-  const rowRegex = /\|\s*`(\w+)`\s*\|\s*(\w+)\s*\|\s*([^|]+)\|/g;
-  let match;
-  while ((match = rowRegex.exec(section)) !== null) {
-    const name = match[1];
-    const type = match[2];
-    const description = match[3].trim();
-    if (name === "-------" || name === "------" || description === "---") continue;
-    fields.push({ name, type, description });
-  }
-  return fields;
-}
-function getDefaultTraits() {
-  return [
-    { name: "rate_limiter", config: {} },
-    { name: "economy", config: { default_spend_limit: 0.1 } },
-    { name: "timeout_guard", config: {} }
-  ];
-}
-function formatHsplusValue(value) {
-  if (typeof value === "string") return `"${value}"`;
-  if (typeof value === "number") return String(value);
-  if (typeof value === "boolean") return String(value);
-  if (Array.isArray(value)) return `[${value.map(formatHsplusValue).join(", ")}]`;
-  if (value === null || value === void 0) return '""';
-  return JSON.stringify(value);
-}
-function titleCase(kebab) {
-  return kebab.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
-}
-function groupStepsIntoSequences(steps) {
-  const nodes = [];
-  let currentParent = null;
-  for (const step of steps) {
-    if (step.nodeType === "sequence" || step.nodeType === "selector") {
-      currentParent = {
-        type: step.nodeType,
-        name: step.action,
-        description: step.description,
-        params: {},
-        children: []
-      };
-      nodes.push(currentParent);
-    } else {
-      const actionNode = {
-        type: "action",
-        name: step.action,
-        description: step.description,
-        params: step.params,
-        children: []
-      };
-      if (currentParent) {
-        currentParent.children.push(actionNode);
-      } else {
-        if (nodes.length === 0 || nodes[nodes.length - 1].type === "action") {
-          const implicitSeq = {
-            type: "sequence",
-            name: "main",
-            description: "main",
-            params: {},
-            children: [actionNode]
-          };
-          nodes.push(implicitSeq);
-          currentParent = implicitSeq;
-        } else {
-          nodes[nodes.length - 1].children.push(actionNode);
-        }
-      }
-    }
-  }
-  if (nodes.length === 0 && steps.length > 0) {
-    const seq = {
-      type: "sequence",
-      name: "main",
-      description: "main",
-      params: {},
-      children: steps.map((s) => ({
-        type: "action",
-        name: s.action,
-        description: s.description,
-        params: s.params,
-        children: []
-      }))
-    };
-    nodes.push(seq);
-  }
-  return nodes;
-}
-function emitBTNode(lines, node, indent) {
-  const pad = " ".repeat(indent);
-  if (node.type === "sequence" || node.type === "selector") {
-    lines.push(`${pad}${node.type} "${node.name}" {`);
-    for (const child of node.children) {
-      emitBTNode(lines, child, indent + 2);
-    }
-    lines.push(`${pad}}`);
-  } else {
-    lines.push(`${pad}action "${node.name}" {`);
-    if (node.description && node.description !== node.name.replace(/_/g, " ")) {
-      lines.push(`${pad}  // ${node.description}`);
-    }
-    for (const [key, val] of Object.entries(node.params)) {
-      lines.push(`${pad}  ${key}: ${formatHsplusValue(val)}`);
-    }
-    lines.push(`${pad}}`);
-  }
-  lines.push("");
-}
-function toHoloClawSkill(parsed) {
-  return {
-    id: parsed.metadata.name,
-    name: titleCase(parsed.metadata.name),
-    description: parsed.metadata.description,
-    version: parsed.metadata.version,
-    author: parsed.metadata.author,
-    inputs: (parsed.metadata.inputSchema || []).map((f) => ({
-      name: f.name,
-      type: f.type,
-      required: f.required ?? false,
-      description: f.description,
-      default: f.default
-    })),
-    outputs: (parsed.metadata.outputSchema || []).map((f) => ({
-      name: f.name,
-      type: f.type,
-      description: f.description
-    })),
-    sandbox: true
-  };
-}
-function fromHoloClawSkill(skill) {
-  const inputSchema = skill.inputs.map((i) => ({
-    name: i.name,
-    type: i.type,
-    required: i.required || void 0,
-    description: i.description,
-    default: i.default
-  }));
-  const outputSchema = skill.outputs.map((o) => ({
-    name: o.name,
-    type: o.type,
-    description: o.description
-  }));
-  return {
-    metadata: {
-      name: skill.id,
-      description: skill.description,
-      version: skill.version,
-      author: skill.author,
-      inputSchema: inputSchema.length > 0 ? inputSchema : void 0,
-      outputSchema: outputSchema.length > 0 ? outputSchema : void 0,
-      holoCliVersion: "5.0.0",
-      nodeVersion: "20",
-      userInvocable: true
-    },
-    traits: getDefaultTraits(),
-    state: [],
-    steps: [],
-    tests: [],
-    sourceComments: []
-  };
-}
-export {
-  fromHoloClawSkill,
-  generateClawHubManifest,
-  generateClawHubPackage,
-  getHsInstallCommand,
-  getInstallCommand,
-  getPublishCommand,
-  hsplusToSkillMd,
-  parseHsplus,
-  parseSkillMd,
-  skillMdToHsplus,
-  toHoloClawSkill,
-  toHsplus,
-  toSkillMd
-};