toolnexus 0.2.0 → 0.2.1

package/dist/skill.js

@@ -7,6 +7,7 @@
 import { readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
+import { parse as parseYaml } from "yaml";
 export const SKILL_TOOL_DESCRIPTION = `Load a specialized skill when the task at hand matches one of the skills listed in the system prompt.
 
 Use this tool to inject the skill's instructions and resources into current conversation. The output may contain detailed workflow guidance as well as references to scripts, files, etc in the same directory as the skill.
@@ -18,24 +19,31 @@ The skill name must match one of the skills listed in your system prompt.`;
  */
 export const SKILLS_PROMPT_PREAMBLE = "Skills provide specialized instructions and workflows for specific tasks.\n" +
     "Use the skill tool to load a skill when a task matches its description.";
-/** Minimal YAML frontmatter parser — only flat `key: value` pairs are needed. */
+/**
+ * Parse YAML frontmatter (between the leading `---` fences) with a real YAML
+ * parser, so folded (`>`)/literal (`|`) block scalars, quoting, and multi-line
+ * values all resolve correctly. Scalar values are coerced to strings.
+ */
 function parseFrontmatter(text) {
     const match = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/.exec(text);
     if (!match)
         return { data: {}, content: text };
     const data = {};
-    for (const line of match[1].split(/\r?\n/)) {
-        const idx = line.indexOf(":");
-        if (idx === -1)
-            continue;
-        const key = line.slice(0, idx).trim();
-        let value = line.slice(idx + 1).trim();
-        if ((value.startsWith('"') && value.endsWith('"')) ||
-            (value.startsWith("'") && value.endsWith("'"))) {
-            value = value.slice(1, -1);
+    let parsed;
+    try {
+        parsed = parseYaml(match[1]);
+    }
+    catch {
+        parsed = null;
+    }
+    if (parsed && typeof parsed === "object") {
+        for (const [key, value] of Object.entries(parsed)) {
+            // Trim so block-scalar trailing newlines (chomping differs subtly between
+            // YAML libs) don't leak — keeps the five ports byte-identical.
+            if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+                data[key] = String(value).trim();
+            }
         }
-        if (key)
-            data[key] = value;
     }
     return { data, content: match[2] };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolnexus",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Dynamic MCP servers + agent skills as uniform tools for any LLM (opencode-style).",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,22 +11,40 @@
       "import": "./dist/index.js"
     }
   },
-  "files": ["dist", "src"],
+  "files": [
+    "dist",
+    "src"
+  ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "test": "npm run build && node --experimental-strip-types --test test/unit.test.ts",
     "example": "node --experimental-strip-types examples/basic.ts"
   },
-  "keywords": ["mcp", "llm", "agent", "skills", "tools", "openai", "anthropic", "gemini"],
+  "keywords": [
+    "mcp",
+    "llm",
+    "agent",
+    "skills",
+    "tools",
+    "openai",
+    "anthropic",
+    "gemini"
+  ],
   "license": "MIT",
-  "repository": { "type": "git", "url": "git+https://github.com/muthuishere/toolnexus.git" },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/muthuishere/toolnexus.git"
+  },
   "homepage": "https://github.com/muthuishere/toolnexus#readme",
-  "bugs": { "url": "https://github.com/muthuishere/toolnexus/issues" },
+  "bugs": {
+    "url": "https://github.com/muthuishere/toolnexus/issues"
+  },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.0"
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "yaml": "^2.9.0"
   },
   "devDependencies": {
-    "typescript": "^5.6.0",
-    "@types/node": "^22.0.0"
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
   }
 }

package/src/skill.ts

@@ -7,6 +7,7 @@
 import { readFileSync, readdirSync, realpathSync, statSync } from "node:fs"
 import path from "node:path"
 import { pathToFileURL } from "node:url"
+import { parse as parseYaml } from "yaml"
 import type { Tool, ToolResult } from "./types.js"
 
 export const SKILL_TOOL_DESCRIPTION = `Load a specialized skill when the task at hand matches one of the skills listed in the system prompt.
@@ -30,23 +31,29 @@ export interface SkillInfo {
   content: string // body after frontmatter
 }
 
-/** Minimal YAML frontmatter parser — only flat `key: value` pairs are needed. */
+/**
+ * Parse YAML frontmatter (between the leading `---` fences) with a real YAML
+ * parser, so folded (`>`)/literal (`|`) block scalars, quoting, and multi-line
+ * values all resolve correctly. Scalar values are coerced to strings.
+ */
 function parseFrontmatter(text: string): { data: Record<string, string>; content: string } {
   const match = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/.exec(text)
   if (!match) return { data: {}, content: text }
   const data: Record<string, string> = {}
-  for (const line of match[1].split(/\r?\n/)) {
-    const idx = line.indexOf(":")
-    if (idx === -1) continue
-    const key = line.slice(0, idx).trim()
-    let value = line.slice(idx + 1).trim()
-    if (
-      (value.startsWith('"') && value.endsWith('"')) ||
-      (value.startsWith("'") && value.endsWith("'"))
-    ) {
-      value = value.slice(1, -1)
+  let parsed: unknown
+  try {
+    parsed = parseYaml(match[1])
+  } catch {
+    parsed = null
+  }
+  if (parsed && typeof parsed === "object") {
+    for (const [key, value] of Object.entries(parsed as Record<string, unknown>)) {
+      // Trim so block-scalar trailing newlines (chomping differs subtly between
+      // YAML libs) don't leak — keeps the five ports byte-identical.
+      if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+        data[key] = String(value).trim()
+      }
     }
-    if (key) data[key] = value
   }
   return { data, content: match[2] }
 }