@mcpc-tech/plugin-markdown-loader 0.0.2

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@mcpc-tech/plugin-markdown-loader",
+  "version": "0.0.2",
+  "homepage": "https://jsr.io/@mcpc/plugin-markdown-loader",
+  "dependencies": {
+    "@ai-sdk/provider": "^2.0.0",
+    "@mcpc-tech/acp-ai-provider": "^0.1.20",
+    "@mcpc-tech/ripgrep-napi": "^0.0.4",
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.56.0",
+    "@opentelemetry/resources": "^1.29.0",
+    "@opentelemetry/sdk-trace-base": "^1.29.0",
+    "@opentelemetry/sdk-trace-node": "^1.29.0",
+    "@opentelemetry/semantic-conventions": "^1.29.0",
+    "@segment/ajv-human-errors": "^2.15.0",
+    "ai": "^5.0.60",
+    "ajv": "^8.17.1",
+    "ajv-errors": "^3.0.0",
+    "ajv-formats": "^3.0.1",
+    "cheerio": "^1.0.0",
+    "json-schema-traverse": "^1.0.0",
+    "jsonrepair": "^3.13.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./types/mod.d.ts",
+      "import": "./index.mjs",
+      "require": "./index.cjs"
+    },
+    "./types/*": "./types/*"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mcpc-tech/mcpc.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mcpc-tech/mcpc/issues"
+  },
+  "main": "./index.cjs",
+  "module": "./index.mjs"
+}

package/types/mod.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @mcpc/plugin-markdown-loader
+ *
+ * Markdown agent definition loader plugin for MCPC.
+ * Enables loading agent definitions from Markdown files with YAML front matter.
+ *
+ * @example
+ * ```typescript
+ * // Option 1: String path (recommended)
+ * const server = await mcpc(
+ *   [{ name: "server", version: "1.0.0" }, { capabilities: { tools: {} } }],
+ *   ["./agents/my-agent.md"],
+ *   { plugins: ["@mcpc/plugin-markdown-loader"] }
+ * );
+ *
+ * // Option 2: Import directly
+ * import { markdownLoaderPlugin } from "@mcpc/plugin-markdown-loader";
+ * const server = await mcpc(
+ *   [{ name: "server", version: "1.0.0" }, { capabilities: { tools: {} } }],
+ *   ["./agents/my-agent.md"],
+ *   { plugins: [markdownLoaderPlugin()] }
+ * );
+ * ```
+ *
+ * @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";
+/**
+ * Create a Markdown loader plugin for mcpc().
+ *
+ * This plugin registers the Markdown file loader, enabling you to use
+ * Markdown file paths as compose inputs.
+ */ export declare function markdownLoaderPlugin(): ToolPlugin;
+/** Factory function for string-based plugin loading */ export declare const createPlugin: any;
+/** Default plugin instance for string-based plugin loading */ declare const defaultPlugin: ToolPlugin;
+export default defaultPlugin;
+//# sourceMappingURL=mod.d.ts.map

package/types/mod.d.ts.map

@@ -0,0 +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"}

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

@@ -0,0 +1,85 @@
+/**
+ * Markdown Agent Definition Loader
+ *
+ * This module provides utilities to load agent definitions from Markdown files
+ * with YAML front matter for configuration.
+ *
+ * Markdown agent files use the following format:
+ * ```markdown
+ * ---
+ * name: my-agent
+ * mode: agentic
+ * maxSteps: 50
+ * deps:
+ *   mcpServers:
+ *     desktop-commander:
+ *       command: npx
+ *       args: ["-y", "@wonderwhy-er/desktop-commander@latest"]
+ *       transportType: stdio
+ * ---
+ *
+ * # Agent Description
+ *
+ * Your agent description goes here in Markdown format.
+ * You can use <tool name="server.tool_name"/> to reference tools.
+ * ```
+ *
+ * @module
+ */ import { type ComposeDefinition, isMarkdownFile, type McpServerConfig, type SamplingConfig } from "@jsr/mcpc__core";
+export { isMarkdownFile as isMarkdownAgentFile };
+/**
+ * Front matter configuration for Markdown agent definitions
+ */ export interface MarkdownAgentFrontMatter {
+  /** Agent name (required) */ name: string;
+  /** Execution mode */ mode?: "agentic" | "ai_sampling" | "ai_acp" | "code_execution";
+  /** Maximum execution steps */ maxSteps?: number;
+  /** Maximum tokens for sampling */ maxTokens?: number;
+  /** Enable tracing */ tracingEnabled?: boolean;
+  /** MCP server dependencies */ deps?: {
+    mcpServers: Record<string, McpServerConfig>;
+  };
+  /** Plugin file paths */ plugins?: string[];
+  /** Tool references */ refs?: string[];
+  /** Sampling configuration */ samplingConfig?: SamplingConfig;
+  /** Provider options for AI SDK sampling mode */ providerOptions?: {
+    modelPreferences?: {
+      hints?: Array<{
+        name?: string;
+      }>;
+      costPriority?: number;
+      speedPriority?: number;
+      intelligencePriority?: number;
+    };
+  };
+  /** ACP settings for AI SDK ACP mode */ acpSettings?: {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    session?: {
+      cwd?: string;
+      mcpServers?: Array<{
+        name: string;
+        command: string;
+        args?: string[];
+        env?: Record<string, string>;
+      }>;
+    };
+    persistSession?: boolean;
+  };
+}
+/**
+ * Result of parsing a Markdown agent file
+ */ export interface ParsedMarkdownAgent {
+  frontMatter: MarkdownAgentFrontMatter;
+  description: string;
+}
+/**
+ * Parse YAML front matter and Markdown content from a string
+ */ export declare function parseMarkdownAgent(content: string): ParsedMarkdownAgent;
+/**
+ * Convert parsed Markdown agent to ComposeDefinition
+ */ export declare function markdownAgentToComposeDefinition(parsed: ParsedMarkdownAgent): ComposeDefinition;
+/**
+ * Load a Markdown agent definition from a file path
+ */ export declare function loadMarkdownAgentFile(filePath: string): Promise<ComposeDefinition>;
+//# sourceMappingURL=markdown-loader.d.ts.map

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

@@ -0,0 +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"}