@pkagentic/mcp 1.4.0

package/dist/handlers/utility.d.ts

@@ -0,0 +1,41 @@
+import { InitProjectArgs, GetAgentGuideArgs, OptimizeImageArgs, DownloadImageArgs } from "../types.js";
+export declare class UtilityApi {
+    initProject(args: InitProjectArgs): Promise<{
+        success: boolean;
+        message: string;
+        root: string;
+        directories: string[];
+    }>;
+    getAgentGuide(args: GetAgentGuideArgs): Promise<{
+        success: boolean;
+        message: string;
+        file_written: string;
+        absolute_path: string;
+    }>;
+    optimizeImage(args: OptimizeImageArgs): Promise<{
+        success: boolean;
+        message: string;
+        input_path: string;
+        output_path: string;
+        original: {
+            width: number;
+            height: number;
+            size_bytes: number;
+            format: string;
+        };
+        output: {
+            width: number;
+            height: number;
+            size_bytes: number;
+            format: string;
+        };
+        resized: boolean;
+        converted_to_webp: boolean;
+        size_reduction: string;
+    }>;
+    downloadImage(args: DownloadImageArgs): Promise<{
+        success: boolean;
+        message: string;
+        path: string;
+    }>;
+}

package/dist/handlers/utility.js

@@ -0,0 +1,153 @@
+import fs from "fs";
+import path from "path";
+import axios from "axios";
+import sharp from "sharp";
+import { fileURLToPath } from "url";
+import { finished } from "stream/promises";
+// Resolve the directory of this compiled file so we can locate bundled guide files
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+export class UtilityApi {
+    async initProject(args) {
+        const rootPath = args.path || ".";
+        const dirs = [
+            ".pk-agentic/agent-guide",
+            "workspace/templates",
+            "workspace/scripts",
+            "workspace/contents/pages",
+            "workspace/contents/posts",
+            "resources/assets",
+            "resources/context",
+        ];
+        // Clear agent-guide contents so the latest guide is always used
+        const agentGuideDir = path.join(rootPath, ".pk-agentic/agent-guide");
+        if (fs.existsSync(agentGuideDir)) {
+            for (const entry of fs.readdirSync(agentGuideDir)) {
+                fs.rmSync(path.join(agentGuideDir, entry), { recursive: true, force: true });
+            }
+        }
+        for (const dir of dirs) {
+            const fullPath = path.join(rootPath, dir);
+            if (!fs.existsSync(fullPath)) {
+                fs.mkdirSync(fullPath, { recursive: true });
+                // Create .gitkeep to ensure empty directories are kept in version control
+                fs.writeFileSync(path.join(fullPath, ".gitkeep"), "");
+            }
+        }
+        return {
+            success: true,
+            message: "Project structure initialized successfully.",
+            root: path.resolve(rootPath),
+            directories: dirs
+        };
+    }
+    async getAgentGuide(args) {
+        const { guide } = args;
+        // Source: the agent-guide/ folder shipped alongside this MCP server
+        // Note: Since this is now in src/handlers/, the path to agent-guide/ might need adjustment
+        // relative to the compiled dist/handlers/ directory.
+        const sourceDir = path.resolve(__dirname, "..", "..", "agent-guide");
+        const sourceFile = path.join(sourceDir, `${guide}.md`);
+        if (!fs.existsSync(sourceFile)) {
+            throw new Error(`Guide file not found in MCP server: agent-guide/${guide}.md`);
+        }
+        // Destination: agent-guide/ in the agent's current working directory
+        const destDir = path.resolve(".pk-agentic/agent-guide");
+        if (!fs.existsSync(destDir)) {
+            fs.mkdirSync(destDir, { recursive: true });
+        }
+        const destFile = path.join(destDir, `${guide}.md`);
+        fs.copyFileSync(sourceFile, destFile);
+        const relativePath = `.pk-agentic/agent-guide/${guide}.md`;
+        return {
+            success: true,
+            message: `Guide written to ${relativePath}. Read that file now to learn about '${guide}'.`,
+            file_written: relativePath,
+            absolute_path: destFile,
+        };
+    }
+    async optimizeImage(args) {
+        const { file_path, output_path, width, height, quality = 80 } = args;
+        if (!fs.existsSync(file_path)) {
+            throw new Error(`File not found: ${file_path}`);
+        }
+        const ext = path.extname(file_path).toLowerCase().replace(".", "");
+        const convertToWebP = ["png", "jpg", "jpeg", "bmp", "tiff", "tif", "heic", "heif"].includes(ext);
+        // Output path: replace extension with .webp, or use provided path
+        const baseName = path.basename(file_path, path.extname(file_path));
+        const inputDir = path.dirname(file_path);
+        const resolvedOutput = output_path || path.join(inputDir, `${baseName}.webp`);
+        const outputDir = path.dirname(resolvedOutput);
+        if (!fs.existsSync(outputDir)) {
+            fs.mkdirSync(outputDir, { recursive: true });
+        }
+        const originalSize = fs.statSync(file_path).size;
+        let image = sharp(file_path);
+        const metadata = await image.metadata();
+        const originalWidth = metadata.width ?? 0;
+        const originalHeight = metadata.height ?? 0;
+        // Only resize if the image exceeds the specified dimension
+        const resizeWidth = (width && originalWidth > width) ? width : undefined;
+        const resizeHeight = (height && originalHeight > height) ? height : undefined;
+        if (resizeWidth || resizeHeight) {
+            image = image.resize({
+                width: resizeWidth,
+                height: resizeHeight,
+                fit: "inside",
+                withoutEnlargement: true,
+            });
+        }
+        const outputExt = path.extname(resolvedOutput).toLowerCase();
+        if (convertToWebP || outputExt === ".webp") {
+            image = image.webp({ quality });
+        }
+        const info = await image.toFile(resolvedOutput);
+        const newSize = fs.statSync(resolvedOutput).size;
+        const reduction = originalSize > 0
+            ? `${Math.round((1 - newSize / originalSize) * 100)}%`
+            : "0%";
+        return {
+            success: true,
+            message: "Image optimized successfully.",
+            input_path: file_path,
+            output_path: resolvedOutput,
+            original: {
+                width: originalWidth,
+                height: originalHeight,
+                size_bytes: originalSize,
+                format: ext,
+            },
+            output: {
+                width: info.width,
+                height: info.height,
+                size_bytes: newSize,
+                format: info.format,
+            },
+            resized: !!(resizeWidth || resizeHeight),
+            converted_to_webp: convertToWebP || outputExt === ".webp",
+            size_reduction: reduction,
+        };
+    }
+    async downloadImage(args) {
+        const { url, path: filePath } = args;
+        // Ensure directory exists
+        const dir = path.dirname(filePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        const writer = fs.createWriteStream(filePath);
+        const response = await axios({
+            method: "get",
+            url: url,
+            responseType: "stream",
+        });
+        response.data.pipe(writer);
+        await finished(writer);
+        return {
+            success: true,
+            message: `Image downloaded successfully to ${filePath}`,
+            path: filePath
+        };
+    }
+}
+//# sourceMappingURL=utility.js.map

package/dist/handlers/utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.js","sourceRoot":"","sources":["../../src/handlers/utility.ts"],"names":[],"mappings":"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"}

package/dist/handlers/web-crawler.d.ts

@@ -0,0 +1,30 @@
+import { ReadWebPageArgs } from "../types.js";
+export declare class WebCrawlerApi {
+    private turndownService;
+    constructor();
+    readWebPage(args: ReadWebPageArgs): Promise<{
+        success: boolean;
+        message: string;
+        url?: undefined;
+        title?: undefined;
+        content?: undefined;
+        byline?: undefined;
+        excerpt?: undefined;
+    } | {
+        success: boolean;
+        url: string;
+        title: string;
+        content: string;
+        message?: undefined;
+        byline?: undefined;
+        excerpt?: undefined;
+    } | {
+        success: boolean;
+        url: string;
+        title: string;
+        byline: string | null | undefined;
+        excerpt: string | null | undefined;
+        content: string;
+        message?: undefined;
+    }>;
+}

package/dist/handlers/web-crawler.js

@@ -0,0 +1,101 @@
+import axios from "axios";
+import { Readability } from "@mozilla/readability";
+import { JSDOM, VirtualConsole } from "jsdom";
+import TurndownService from "turndown";
+export class WebCrawlerApi {
+    turndownService;
+    constructor() {
+        this.turndownService = new TurndownService({
+            headingStyle: "atx",
+            codeBlockStyle: "fenced"
+        });
+    }
+    async readWebPage(args) {
+        const { url, render_js = true, wait_selector, css_selector } = args;
+        let dom;
+        if (render_js) {
+            const virtualConsole = new VirtualConsole();
+            // Forward virtual console logs to terminal if needed for debugging
+            // virtualConsole.sendTo(console);
+            try {
+                dom = await JSDOM.fromURL(url, {
+                    resources: "usable",
+                    runScripts: "dangerously",
+                    virtualConsole,
+                    pretendToBeVisual: true,
+                });
+                // Wait for JS to execute. JSDOM doesn't have a perfect "networkidle" 
+                // so we wait for the wait_selector or a fixed timeout.
+                if (wait_selector) {
+                    await new Promise((resolve) => {
+                        const start = Date.now();
+                        const interval = setInterval(() => {
+                            if (dom.window.document.querySelector(wait_selector) || Date.now() - start > 10000) {
+                                clearInterval(interval);
+                                resolve();
+                            }
+                        }, 100);
+                    });
+                }
+                else {
+                    // Default wait for some potential async rendering
+                    await new Promise(resolve => setTimeout(resolve, 2000));
+                }
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    message: `Failed to load page with JSDOM: ${error.message}`
+                };
+            }
+        }
+        else {
+            try {
+                const response = await axios.get(url);
+                dom = new JSDOM(response.data, { url });
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    message: `Failed to fetch page with Axios: ${error.message}`
+                };
+            }
+        }
+        const reader = new Readability(dom.window.document);
+        const article = reader.parse();
+        if (!article || !article.content) {
+            // If readability fails, try to get raw HTML from selector or body
+            let contentHtml;
+            if (css_selector) {
+                const el = dom.window.document.querySelector(css_selector);
+                contentHtml = el ? el.innerHTML : dom.window.document.body.innerHTML;
+            }
+            else {
+                contentHtml = dom.window.document.body.innerHTML;
+            }
+            if (!contentHtml) {
+                return {
+                    success: false,
+                    message: "Failed to extract content from the page."
+                };
+            }
+            const markdown = this.turndownService.turndown(contentHtml);
+            return {
+                success: true,
+                url,
+                title: dom.window.document.title,
+                content: markdown
+            };
+        }
+        const markdown = this.turndownService.turndown(article.content);
+        return {
+            success: true,
+            url,
+            title: article.title || dom.window.document.title,
+            byline: article.byline,
+            excerpt: article.excerpt,
+            content: markdown
+        };
+    }
+}
+//# sourceMappingURL=web-crawler.js.map

package/dist/handlers/web-crawler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-crawler.js","sourceRoot":"","sources":["../../src/handlers/web-crawler.ts"],"names":[],"mappings":"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"}

package/dist/handlers.d.ts

@@ -0,0 +1,234 @@
+import { SyncArgs, GetFileArgs, GetFilesBatchArgs, SaveItemArgs, PublishItemArgs, CreateItemArgs, ToggleItemArgs, UpdateConditionsArgs, UpdateMetadataArgs, DeleteItemArgs, GetRevisionsArgs, RestoreRevisionArgs, SearchContentsArgs, MarkContentEditArgs, UploadMediaArgs, GetImageSrcsetArgs, DownloadImageArgs, ReadWebPageArgs, InitProjectArgs, SearchMediaArgs, GetAgentGuideArgs, UpdateTailwindConfigArgs, GenerateImageArgs, OptimizeImageArgs, ListLibrariesArgs, CreateLibraryArgs, UpdateLibraryArgs, DeleteLibraryArgs, SearchLibrariesArgs, GetLibraryArgs, CdnDownloadLibraryArgs, SaveLibraryFilesArgs, RestoreLibraryBackupArgs, UpdateLibraryConditionsArgs, ToggleLibraryArgs, ToggleLibraryLockArgs, TailwindOptimizeArgs } from "./types.js";
+export declare class ImageGenerationApi {
+    private client;
+    private modelId;
+    constructor(apiKey?: string, modelId?: string);
+    generateImage(args: GenerateImageArgs): Promise<{
+        success: boolean;
+        message: string;
+        file_path: string;
+        image_name: string;
+        page_name: string;
+        model: string;
+    }>;
+}
+export declare class UtilityApi {
+    initProject(args: InitProjectArgs): Promise<{
+        success: boolean;
+        message: string;
+        root: string;
+        directories: string[];
+    }>;
+    getAgentGuide(args: GetAgentGuideArgs): Promise<{
+        success: boolean;
+        message: string;
+        file_written: string;
+        absolute_path: string;
+    }>;
+    optimizeImage(args: OptimizeImageArgs): Promise<{
+        success: boolean;
+        message: string;
+        input_path: string;
+        output_path: string;
+        original: {
+            width: number;
+            height: number;
+            size_bytes: number;
+            format: string;
+        };
+        output: {
+            width: number;
+            height: number;
+            size_bytes: number;
+            format: string;
+        };
+        resized: boolean;
+        converted_to_webp: boolean;
+        size_reduction: string;
+    }>;
+    downloadImage(args: DownloadImageArgs): Promise<{
+        success: boolean;
+        message: string;
+        path: string;
+    }>;
+}
+export declare class TailwindApi {
+    optimize(args: TailwindOptimizeArgs): Promise<{
+        success: boolean;
+        message: string;
+        output_path: string;
+        css_size: number;
+    }>;
+}
+export declare class WebCrawlerApi {
+    private turndownService;
+    constructor();
+    readWebPage(args: ReadWebPageArgs): Promise<{
+        success: boolean;
+        message: string;
+        url?: undefined;
+        title?: undefined;
+        content?: undefined;
+        byline?: undefined;
+        excerpt?: undefined;
+    } | {
+        success: boolean;
+        url: string;
+        title: string;
+        content: string;
+        message?: undefined;
+        byline?: undefined;
+        excerpt?: undefined;
+    } | {
+        success: boolean;
+        url: string;
+        title: string;
+        byline: string | null | undefined;
+        excerpt: string | null | undefined;
+        content: string;
+        message?: undefined;
+    }>;
+}
+export declare class PKAgentApi {
+    private axiosInstance;
+    constructor(baseURL: string, key: string, email: string);
+    /**
+     * Ensure a directory exists and write JSON content to a file.
+     */
+    private writeJsonFile;
+    /**
+     * Write downloaded code fields (html/css/js) from an API item to the
+     * correct workspace sub-directory derived from the item's virtual_path.
+     *
+     * Layout:
+     *   template → workspace/templates/{slug}/{slug}.php  .css  .js
+     *   script   → workspace/scripts/{slug}/{slug}.php    .css  .js
+     *   content  → workspace/contents/{vp_parts}/{slug}.html .css .js
+     *
+     * Returns relative paths of every file that was written.
+     */
+    private writeItemFiles;
+    getSiteInfo(): Promise<{
+        success: boolean;
+        message: string;
+        file_written: string;
+        summary: {
+            site_name: any;
+            site_url: any;
+            batch_file_limit: any;
+            css_framework: any;
+            timezone: any;
+            language: any;
+            permissions: any;
+            menu_locations: any;
+        };
+    }>;
+    syncItems(args: SyncArgs): Promise<{
+        success: boolean;
+        message: string;
+        file_written: string;
+        summary: {
+            page: any;
+            per_page: any;
+            total_items: any;
+            total_pages: any;
+            has_more: any;
+            items_on_page: {
+                templates: any;
+                scripts: any;
+                content: any;
+            };
+        };
+    }>;
+    getFile(args: GetFileArgs): Promise<{
+        success: boolean;
+        partial_download: boolean;
+        message: string;
+        metadata: {
+            id: any;
+            type: any;
+            slug: any;
+            virtual_path: any;
+            download_type: any;
+            total_lines: any;
+            line_range: any;
+            is_locked?: undefined;
+            status?: undefined;
+            description?: undefined;
+            document_content?: undefined;
+        };
+        content: {
+            js?: any;
+            css?: any;
+            html?: any;
+        };
+        files_written?: undefined;
+        files_count?: undefined;
+    } | {
+        success: boolean;
+        message: string;
+        files_written: string[];
+        files_count: number;
+        metadata: {
+            id: any;
+            type: any;
+            slug: any;
+            virtual_path: any;
+            is_locked: any;
+            status: any;
+            download_type: any;
+            total_lines: any;
+            description: any;
+            document_content: any;
+            line_range?: undefined;
+        };
+        partial_download?: undefined;
+        content?: undefined;
+    }>;
+    getFilesBatch(args: GetFilesBatchArgs): Promise<{
+        success: boolean;
+        message: string;
+        items_downloaded: number;
+        total_files_written: number;
+        items: any[];
+    }>;
+    getTemplateInfo(id: number): Promise<any>;
+    getScriptInfo(id: number): Promise<any>;
+    getContentInfo(id: number): Promise<any>;
+    private readFileContent;
+    saveItem(args: SaveItemArgs): Promise<any>;
+    publishItem(args: PublishItemArgs): Promise<any>;
+    createItem(args: CreateItemArgs): Promise<any>;
+    toggleItem(args: ToggleItemArgs): Promise<any>;
+    updateConditions(args: UpdateConditionsArgs): Promise<any>;
+    updateMetadata(args: UpdateMetadataArgs): Promise<any>;
+    deleteItem(args: DeleteItemArgs): Promise<any>;
+    getRevisions(args: GetRevisionsArgs): Promise<any>;
+    restoreRevision(args: RestoreRevisionArgs): Promise<any>;
+    searchContents(args: SearchContentsArgs): Promise<any>;
+    markContentEdit(args: MarkContentEditArgs): Promise<any>;
+    searchMedia(args: SearchMediaArgs): Promise<any>;
+    uploadMedia(args: UploadMediaArgs): Promise<any>;
+    getImageSrcset(args: GetImageSrcsetArgs): Promise<any>;
+    getRoles(): Promise<any>;
+    getTailwindConfig(): Promise<any>;
+    updateTailwindConfig(args: UpdateTailwindConfigArgs): Promise<any>;
+    listLibraries(args: ListLibrariesArgs): Promise<{
+        success: boolean;
+        message: string;
+        file_written: string;
+        data: any;
+        pagination: any;
+    }>;
+    createLibrary(args: CreateLibraryArgs): Promise<any>;
+    updateLibrary(args: UpdateLibraryArgs): Promise<any>;
+    deleteLibrary(args: DeleteLibraryArgs): Promise<any>;
+    searchLibraries(args: SearchLibrariesArgs): Promise<any>;
+    getLibrary(args: GetLibraryArgs): Promise<any>;
+    cdnDownloadLibrary(args: CdnDownloadLibraryArgs): Promise<any>;
+    saveLibraryFiles(args: SaveLibraryFilesArgs): Promise<any>;
+    restoreLibraryBackup(args: RestoreLibraryBackupArgs): Promise<any>;
+    updateLibraryConditions(args: UpdateLibraryConditionsArgs): Promise<any>;
+    toggleLibrary(args: ToggleLibraryArgs): Promise<any>;
+    toggleLibraryLock(args: ToggleLibraryLockArgs): Promise<any>;
+}