@mcpc-tech/plugin-markdown-loader 0.0.5 → 0.0.7

package/index.cjs

@@ -32,7 +32,9 @@ var mod_exports = {};
 __export(mod_exports, {
   createPlugin: () => createPlugin,
   default: () => mod_default,
+  isDirectory: () => isDirectory,
   isMarkdownAgentFile: () => isMarkdownFile,
+  loadMarkdownAgentDirectory: () => loadMarkdownAgentDirectory,
   loadMarkdownAgentFile: () => loadMarkdownAgentFile,
   markdownAgentToComposeDefinition: () => markdownAgentToComposeDefinition,
   markdownLoaderPlugin: () => markdownLoaderPlugin,
@@ -1559,7 +1561,7 @@ IMPORTANT: You MUST respond with valid JSON only. Do not include any text before
     let enhanced = systemPrompt || "";
     const toolsPrompt = `
 
-AVAILABLE TOOLS:
+<available_tools>
 You have access to the following tools. To use a tool, respond with this XML format:
 <use_tool tool="tool_name">
 {"param1": "value1", "param2": "value2"}
@@ -1568,23 +1570,34 @@ You have access to the following tools. To use a tool, respond with this XML for
 Follow the JSON schema definition for each tool's parameters.
 You can use multiple tools in one response. DO NOT include text before or after tool calls - wait for the tool results first.
 
-Tools:`;
+<tools>`;
     const toolDescriptions = tools.map((tool2) => {
       if (tool2.type === "function") {
         const toolAny = tool2;
         const description = toolAny.description || "No description provided";
         const schema = toolAny.inputSchema || toolAny.parameters;
-        const params = schema ? `
-  JSON Schema: ${JSON.stringify(schema, null, 2)}` : "";
+        const schemaStr = schema ? `
+<schema>
+${JSON.stringify(schema, null, 2)}
+</schema>` : "";
         return `
-- ${tool2.name}: ${description}${params}`;
+<tool name="${tool2.name}">
+<description>
+${description}
+</description>${schemaStr}
+</tool>`;
       } else if (tool2.type === "provider-defined") {
         return `
-- ${tool2.name}: ${tool2.id || "No description provided"}`;
+<tool name="${tool2.name}">
+<description>${tool2.id || "No description provided"}</description>
+</tool>`;
       }
       return "";
     }).filter(Boolean).join("");
-    enhanced = enhanced ? `${enhanced}${toolsPrompt}${toolDescriptions}` : `${toolsPrompt}${toolDescriptions}`.trim();
+    const toolsEnd = `
+</tools>
+</available_tools>`;
+    enhanced = enhanced ? `${enhanced}${toolsPrompt}${toolDescriptions}${toolsEnd}` : `${toolsPrompt}${toolDescriptions}${toolsEnd}`.trim();
     return enhanced || void 0;
   }
   /**
@@ -4002,10 +4015,15 @@ function parse(content, options = {}) {
 }
 
 // __mcpc__plugin-markdown-loader_latest/node_modules/@mcpc/plugin-markdown-loader/src/markdown-loader.js
+var import_node_path = require("node:path");
 var import_node_process5 = __toESM(require("node:process"), 1);
 function replaceEnvVars(str2) {
-  return str2.replace(/\$([A-Za-z_][A-Za-z0-9_]*)/g, (_match, varName) => {
-    return import_node_process5.default.env[varName] || "";
+  return str2.replace(/\$([A-Za-z_][A-Za-z0-9_]*)(?!\s*\()/g, (match, varName) => {
+    const value = import_node_process5.default.env[varName];
+    if (value !== void 0) {
+      return value;
+    }
+    return match;
   });
 }
 function replaceEnvVarsInObject(obj) {
@@ -4042,7 +4060,7 @@ function parseMarkdownAgent(content) {
   }
   return {
     frontMatter,
-    description: markdownContent.trim()
+    body: markdownContent.trim()
   };
 }
 var OPTION_KEYS = [
@@ -4057,16 +4075,20 @@ var OPTION_KEYS = [
 ];
 function markdownAgentToComposeDefinition(parsed) {
   const frontMatter = replaceEnvVarsInObject(parsed.frontMatter);
-  const description = replaceEnvVars(parsed.description);
+  const body = replaceEnvVars(parsed.body);
   const options = {};
   for (const key of OPTION_KEYS) {
     if (frontMatter[key] !== void 0) {
       options[key] = frontMatter[key];
     }
   }
+  const hasDescription = frontMatter.description !== void 0 && frontMatter.description !== "";
   return {
     name: frontMatter.name,
-    description,
+    description: hasDescription ? frontMatter.description : body,
+    ...hasDescription && body ? {
+      manual: body
+    } : {},
     deps: frontMatter.deps,
     plugins: frontMatter.plugins,
     ...Object.keys(options).length > 0 ? {
@@ -4079,6 +4101,45 @@ async function loadMarkdownAgentFile(filePath) {
   const parsed = parseMarkdownAgent(content);
   return markdownAgentToComposeDefinition(parsed);
 }
+async function loadMarkdownAgentDirectory(dirPath, options = {}) {
+  const { recursive = false } = options;
+  const definitions = [];
+  const errors = [];
+  async function processDirectory(dir) {
+    const entries = await (0, import_promises.readdir)(dir, {
+      withFileTypes: true
+    });
+    for (const entry of entries) {
+      const fullPath = (0, import_node_path.join)(dir, entry.name);
+      if (entry.isDirectory() && recursive) {
+        await processDirectory(fullPath);
+      } else if (entry.isFile() && isMarkdownFile(entry.name)) {
+        try {
+          const definition = await loadMarkdownAgentFile(fullPath);
+          definitions.push(definition);
+        } catch (error) {
+          errors.push({
+            path: fullPath,
+            error: error instanceof Error ? error.message : String(error)
+          });
+        }
+      }
+    }
+  }
+  await processDirectory(dirPath);
+  return {
+    definitions,
+    errors
+  };
+}
+async function isDirectory(path) {
+  try {
+    const stats = await (0, import_promises.stat)(path);
+    return stats.isDirectory();
+  } catch {
+    return false;
+  }
+}
 
 // __mcpc__plugin-markdown-loader_latest/node_modules/@mcpc/plugin-markdown-loader/mod.ts
 function markdownLoaderPlugin() {
@@ -4098,7 +4159,9 @@ var mod_default = defaultPlugin;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createPlugin,
+  isDirectory,
   isMarkdownAgentFile,
+  loadMarkdownAgentDirectory,
   loadMarkdownAgentFile,
   markdownAgentToComposeDefinition,
   markdownLoaderPlugin,

package/index.mjs

@@ -1520,7 +1520,7 @@ IMPORTANT: You MUST respond with valid JSON only. Do not include any text before
     let enhanced = systemPrompt || "";
     const toolsPrompt = `
 
-AVAILABLE TOOLS:
+<available_tools>
 You have access to the following tools. To use a tool, respond with this XML format:
 <use_tool tool="tool_name">
 {"param1": "value1", "param2": "value2"}
@@ -1529,23 +1529,34 @@ You have access to the following tools. To use a tool, respond with this XML for
 Follow the JSON schema definition for each tool's parameters.
 You can use multiple tools in one response. DO NOT include text before or after tool calls - wait for the tool results first.
 
-Tools:`;
+<tools>`;
     const toolDescriptions = tools.map((tool2) => {
       if (tool2.type === "function") {
         const toolAny = tool2;
         const description = toolAny.description || "No description provided";
         const schema = toolAny.inputSchema || toolAny.parameters;
-        const params = schema ? `
-  JSON Schema: ${JSON.stringify(schema, null, 2)}` : "";
+        const schemaStr = schema ? `
+<schema>
+${JSON.stringify(schema, null, 2)}
+</schema>` : "";
         return `
-- ${tool2.name}: ${description}${params}`;
+<tool name="${tool2.name}">
+<description>
+${description}
+</description>${schemaStr}
+</tool>`;
       } else if (tool2.type === "provider-defined") {
         return `
-- ${tool2.name}: ${tool2.id || "No description provided"}`;
+<tool name="${tool2.name}">
+<description>${tool2.id || "No description provided"}</description>
+</tool>`;
       }
       return "";
     }).filter(Boolean).join("");
-    enhanced = enhanced ? `${enhanced}${toolsPrompt}${toolDescriptions}` : `${toolsPrompt}${toolDescriptions}`.trim();
+    const toolsEnd = `
+</tools>
+</available_tools>`;
+    enhanced = enhanced ? `${enhanced}${toolsPrompt}${toolDescriptions}${toolsEnd}` : `${toolsPrompt}${toolDescriptions}${toolsEnd}`.trim();
     return enhanced || void 0;
   }
   /**
@@ -2024,7 +2035,7 @@ function isMarkdownFile(path) {
 }
 
 // __mcpc__plugin-markdown-loader_latest/node_modules/@mcpc/plugin-markdown-loader/src/markdown-loader.js
-import { readFile } from "node:fs/promises";
+import { readdir, readFile, stat } from "node:fs/promises";
 
 // __mcpc__plugin-markdown-loader_latest/node_modules/@jsr/std__yaml/_chars.js
 var TAB = 9;
@@ -3963,10 +3974,15 @@ function parse(content, options = {}) {
 }
 
 // __mcpc__plugin-markdown-loader_latest/node_modules/@mcpc/plugin-markdown-loader/src/markdown-loader.js
+import { join } from "node:path";
 import process5 from "node:process";
 function replaceEnvVars(str2) {
-  return str2.replace(/\$([A-Za-z_][A-Za-z0-9_]*)/g, (_match, varName) => {
-    return process5.env[varName] || "";
+  return str2.replace(/\$([A-Za-z_][A-Za-z0-9_]*)(?!\s*\()/g, (match, varName) => {
+    const value = process5.env[varName];
+    if (value !== void 0) {
+      return value;
+    }
+    return match;
   });
 }
 function replaceEnvVarsInObject(obj) {
@@ -4003,7 +4019,7 @@ function parseMarkdownAgent(content) {
   }
   return {
     frontMatter,
-    description: markdownContent.trim()
+    body: markdownContent.trim()
   };
 }
 var OPTION_KEYS = [
@@ -4018,16 +4034,20 @@ var OPTION_KEYS = [
 ];
 function markdownAgentToComposeDefinition(parsed) {
   const frontMatter = replaceEnvVarsInObject(parsed.frontMatter);
-  const description = replaceEnvVars(parsed.description);
+  const body = replaceEnvVars(parsed.body);
   const options = {};
   for (const key of OPTION_KEYS) {
     if (frontMatter[key] !== void 0) {
       options[key] = frontMatter[key];
     }
   }
+  const hasDescription = frontMatter.description !== void 0 && frontMatter.description !== "";
   return {
     name: frontMatter.name,
-    description,
+    description: hasDescription ? frontMatter.description : body,
+    ...hasDescription && body ? {
+      manual: body
+    } : {},
     deps: frontMatter.deps,
     plugins: frontMatter.plugins,
     ...Object.keys(options).length > 0 ? {
@@ -4040,6 +4060,45 @@ async function loadMarkdownAgentFile(filePath) {
   const parsed = parseMarkdownAgent(content);
   return markdownAgentToComposeDefinition(parsed);
 }
+async function loadMarkdownAgentDirectory(dirPath, options = {}) {
+  const { recursive = false } = options;
+  const definitions = [];
+  const errors = [];
+  async function processDirectory(dir) {
+    const entries = await readdir(dir, {
+      withFileTypes: true
+    });
+    for (const entry of entries) {
+      const fullPath = join(dir, entry.name);
+      if (entry.isDirectory() && recursive) {
+        await processDirectory(fullPath);
+      } else if (entry.isFile() && isMarkdownFile(entry.name)) {
+        try {
+          const definition = await loadMarkdownAgentFile(fullPath);
+          definitions.push(definition);
+        } catch (error) {
+          errors.push({
+            path: fullPath,
+            error: error instanceof Error ? error.message : String(error)
+          });
+        }
+      }
+    }
+  }
+  await processDirectory(dirPath);
+  return {
+    definitions,
+    errors
+  };
+}
+async function isDirectory(path) {
+  try {
+    const stats = await stat(path);
+    return stats.isDirectory();
+  } catch {
+    return false;
+  }
+}
 
 // __mcpc__plugin-markdown-loader_latest/node_modules/@mcpc/plugin-markdown-loader/mod.ts
 function markdownLoaderPlugin() {
@@ -4059,7 +4118,9 @@ var mod_default = defaultPlugin;
 export {
   createPlugin,
   mod_default as default,
+  isDirectory,
   isMarkdownFile as isMarkdownAgentFile,
+  loadMarkdownAgentDirectory,
   loadMarkdownAgentFile,
   markdownAgentToComposeDefinition,
   markdownLoaderPlugin,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcpc-tech/plugin-markdown-loader",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "homepage": "https://jsr.io/@mcpc/plugin-markdown-loader",
   "dependencies": {
     "@ai-sdk/provider": "^2.0.0",

package/types/mod.d.ts

@@ -25,7 +25,7 @@
  * @module
  */ import { type ToolPlugin } from "@jsr/mcpc__core";
 export { setMarkdownAgentLoader } from "@jsr/mcpc__core";
-export { isMarkdownAgentFile, loadMarkdownAgentFile, type MarkdownAgentFrontMatter, markdownAgentToComposeDefinition, type ParsedMarkdownAgent, parseMarkdownAgent } from "./src/markdown-loader.js";
+export { isDirectory, isMarkdownAgentFile, type LoadDirectoryResult, loadMarkdownAgentDirectory, loadMarkdownAgentFile, type MarkdownAgentFrontMatter, markdownAgentToComposeDefinition, type ParsedMarkdownAgent, parseMarkdownAgent } from "./src/markdown-loader.js";
 /**
  * Create a Markdown loader plugin for mcpc().
  *

package/types/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sources":["../mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;CAyBC,GAED,SAAiC,KAAK,UAAU,0BAAiC;AAIjF,SAAS,sBAAsB,0BAAiC;AAEhE,SACE,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,wBAAwB,EAC7B,gCAAgC,EAChC,KAAK,mBAAmB,EACxB,kBAAkB,mCACc;AAElC;;;;;CAKC,GACD,OAAO,iBAAS,wBAAwB;AAWxC,qDAAqD,GACrD,OAAO,cAAM,kBAAoC;AAEjD,4DAA4D,GAC5D,cAAM,eAAe;AACrB,eAAe,cAAc"}
+{"version":3,"file":"mod.d.ts","sources":["../mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;CAyBC,GAED,SAAiC,KAAK,UAAU,0BAAiC;AAIjF,SAAS,sBAAsB,0BAAiC;AAEhE,SACE,WAAW,EACX,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,KAAK,wBAAwB,EAC7B,gCAAgC,EAChC,KAAK,mBAAmB,EACxB,kBAAkB,mCACc;AAElC;;;;;CAKC,GACD,OAAO,iBAAS,wBAAwB;AAWxC,qDAAqD,GACrD,OAAO,cAAM,kBAAoC;AAEjD,4DAA4D,GAC5D,cAAM,eAAe;AACrB,eAAe,cAAc"}

package/types/src/markdown-loader.d.ts

@@ -31,6 +31,11 @@ export { isMarkdownFile as isMarkdownAgentFile };
  * Front matter configuration for Markdown agent definitions
  */ export interface MarkdownAgentFrontMatter {
   /** Agent name (required) */ name: string;
+  /**
+   * Short description for progressive disclosure.
+   * If provided, the Markdown body becomes the `manual` field.
+   * If not provided, the Markdown body becomes the `description` field.
+   */ description?: string;
   /** Execution mode */ mode?: "agentic" | "ai_sampling" | "ai_acp" | "code_execution";
   /** Maximum execution steps */ maxSteps?: number;
   /** Maximum tokens for sampling */ maxTokens?: number;
@@ -71,7 +76,7 @@ export { isMarkdownFile as isMarkdownAgentFile };
  * Result of parsing a Markdown agent file
  */ export interface ParsedMarkdownAgent {
   frontMatter: MarkdownAgentFrontMatter;
-  description: string;
+  /** The Markdown body content */ body: string;
 }
 /**
  * Parse YAML front matter and Markdown content from a string
@@ -82,4 +87,27 @@ export { isMarkdownFile as isMarkdownAgentFile };
 /**
  * Load a Markdown agent definition from a file path
  */ export declare function loadMarkdownAgentFile(filePath: string): Promise<ComposeDefinition>;
+/**
+ * Result of loading agents from a directory
+ */ export interface LoadDirectoryResult {
+  /** Successfully loaded agent definitions */ definitions: ComposeDefinition[];
+  /** Errors encountered during loading (file path and error message) */ errors: Array<{
+    path: string;
+    error: string;
+  }>;
+}
+/**
+ * Load all Markdown agent definitions from a directory.
+ * Only loads .md files in the directory (non-recursive by default).
+ *
+ * @param dirPath - Path to the directory containing Markdown agent files
+ * @param options - Options for loading
+ * @param options.recursive - If true, recursively search subdirectories (default: false)
+ * @returns Object containing definitions and any errors encountered
+ */ export declare function loadMarkdownAgentDirectory(dirPath: string, options?: {
+  recursive?: boolean;
+}): Promise<LoadDirectoryResult>;
+/**
+ * Check if a path is a directory
+ */ export declare function isDirectory(path: string): Promise<boolean>;
 //# sourceMappingURL=markdown-loader.d.ts.map

package/types/src/markdown-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown-loader.d.ts","sources":["../../src/markdown-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BC,GAED,SACE,KAAK,iBAAiB,EACtB,cAAc,EACd,KAAK,eAAe,EAEpB,KAAK,cAAc,0BACW;AAMhC,SAAyB,kBAAkB,mBAAmB,GAAG;AAgCjE;;CAEC,GACD,iBAAiB;EACf,0BAA0B,GAC1B,MAAM,MAAM;EACZ,mBAAmB,GACnB,OAAO,YAAY,gBAAgB,WAAW;EAC9C,4BAA4B,GAC5B,WAAW,MAAM;EACjB,gCAAgC,GAChC,YAAY,MAAM;EAClB,mBAAmB,GACnB,iBAAiB,OAAO;EACxB,4BAA4B,GAC5B;IACE,YAAY,OAAO,MAAM,EAAE;;EAE7B,sBAAsB,GACtB,UAAU,MAAM;EAChB,oBAAoB,GACpB,OAAO,MAAM;EACb,2BAA2B,GAC3B,iBAAiB;EACjB,8CAA8C,GAC9C;IACE;MACE,QAAQ;QAAQ,OAAO,MAAM;;MAC7B,eAAe,MAAM;MACrB,gBAAgB,MAAM;MACtB,uBAAuB,MAAM;;;EAGjC,qCAAqC,GACrC;IACE,SAAS,MAAM;IACf,OAAO,MAAM;IACb,MAAM,OAAO,MAAM,EAAE,MAAM;IAC3B;MACE,MAAM,MAAM;MACZ,aAAa;QACX,MAAM,MAAM;QACZ,SAAS,MAAM;QACf,OAAO,MAAM;QACb,MAAM,OAAO,MAAM,EAAE,MAAM;;;IAG/B,iBAAiB,OAAO;;;AAI5B;;CAEC,GACD,iBAAiB;EACf,aAAa;EACb,aAAa,MAAM;;AAGrB;;CAEC,GACD,OAAO,iBAAS,mBAAmB,SAAS,MAAM,GAAG;AA8CrD;;CAEC,GACD,OAAO,iBAAS,iCACd,QAAQ,mBAAmB,GAC1B;AAsBH;;CAEC,GACD,OAAO,iBAAe,sBACpB,UAAU,MAAM,GACf,QAAQ"}
+{"version":3,"file":"markdown-loader.d.ts","sources":["../../src/markdown-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BC,GAED,SACE,KAAK,iBAAiB,EACtB,cAAc,EACd,KAAK,eAAe,EAEpB,KAAK,cAAc,0BACW;AAOhC,SAAyB,kBAAkB,mBAAmB,GAAG;AA0CjE;;CAEC,GACD,iBAAiB;EACf,0BAA0B,GAC1B,MAAM,MAAM;EACZ;;;;GAIC,GACD,cAAc,MAAM;EACpB,mBAAmB,GACnB,OAAO,YAAY,gBAAgB,WAAW;EAC9C,4BAA4B,GAC5B,WAAW,MAAM;EACjB,gCAAgC,GAChC,YAAY,MAAM;EAClB,mBAAmB,GACnB,iBAAiB,OAAO;EACxB,4BAA4B,GAC5B;IACE,YAAY,OAAO,MAAM,EAAE;;EAE7B,sBAAsB,GACtB,UAAU,MAAM;EAChB,oBAAoB,GACpB,OAAO,MAAM;EACb,2BAA2B,GAC3B,iBAAiB;EACjB,8CAA8C,GAC9C;IACE;MACE,QAAQ;QAAQ,OAAO,MAAM;;MAC7B,eAAe,MAAM;MACrB,gBAAgB,MAAM;MACtB,uBAAuB,MAAM;;;EAGjC,qCAAqC,GACrC;IACE,SAAS,MAAM;IACf,OAAO,MAAM;IACb,MAAM,OAAO,MAAM,EAAE,MAAM;IAC3B;MACE,MAAM,MAAM;MACZ,aAAa;QACX,MAAM,MAAM;QACZ,SAAS,MAAM;QACf,OAAO,MAAM;QACb,MAAM,OAAO,MAAM,EAAE,MAAM;;;IAG/B,iBAAiB,OAAO;;;AAI5B;;CAEC,GACD,iBAAiB;EACf,aAAa;EACb,8BAA8B,GAC9B,MAAM,MAAM;;AAGd;;CAEC,GACD,OAAO,iBAAS,mBAAmB,SAAS,MAAM,GAAG;AA8CrD;;CAEC,GACD,OAAO,iBAAS,iCACd,QAAQ,mBAAmB,GAC1B;AA6BH;;CAEC,GACD,OAAO,iBAAe,sBACpB,UAAU,MAAM,GACf,QAAQ;AAMX;;CAEC,GACD,iBAAiB;EACf,0CAA0C,GAC1C,aAAa;EACb,oEAAoE,GACpE,QAAQ;IAAQ,MAAM,MAAM;IAAE,OAAO,MAAM;;;AAG7C;;;;;;;;CAQC,GACD,OAAO,iBAAe,2BACpB,SAAS,MAAM,EACf;EAAW,YAAY,OAAO;CAAO,GACpC,QAAQ;AAgCX;;CAEC,GACD,OAAO,iBAAe,YAAY,MAAM,MAAM,GAAG,QAAQ,OAAO"}