mcp-ghost-optimized 1.0.0

package/dist/index.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+/**
+ * MCP Ghost Optimized - Entry Point
+ *
+ * This MCP server provides Ghost Admin API tools with field projection
+ * for significant token reduction compared to standard Ghost MCP.
+ *
+ * Environment variables required:
+ * - GHOST_URL: Ghost site URL (e.g., https://your-blog.ghost.io)
+ * - GHOST_ADMIN_API_KEY: Admin API key in format "id:secret"
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+async function main() {
+    try {
+        const server = createServer();
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        // Log to stderr (stdout is reserved for MCP protocol)
+        console.error("MCP Ghost Optimized server running on stdio");
+    }
+    catch (error) {
+        console.error("Failed to start MCP server:", error);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEhC,sDAAsD;QACtD,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP Ghost Optimized Server
+ *
+ * Provides Ghost Admin API tools with field projection for token efficiency.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsDpE,wBAAgB,YAAY,IAAI,SAAS,CA2cxC"}

package/dist/server.js

@@ -0,0 +1,378 @@
+/**
+ * MCP Ghost Optimized Server
+ *
+ * Provides Ghost Admin API tools with field projection for token efficiency.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { GhostClient } from "./api/client.js";
+import { POST_FIELDS, TAG_FIELDS } from "./utils/fields.js";
+import { htmlToPlaintext } from "./utils/html.js";
+export function createServer() {
+    const server = new McpServer({
+        name: "ghost-optimized",
+        version: "1.0.0",
+    });
+    // Get config from environment
+    const ghostUrl = process.env.GHOST_URL;
+    const ghostKey = process.env.GHOST_ADMIN_API_KEY;
+    const defaultTemplate = process.env.GHOST_DEFAULT_TEMPLATE;
+    if (!ghostUrl || !ghostKey) {
+        throw new Error("GHOST_URL and GHOST_ADMIN_API_KEY environment variables must be set");
+    }
+    const client = new GhostClient({ url: ghostUrl, apiKey: ghostKey });
+    // ============================================================
+    // POSTS TOOLS
+    // ============================================================
+    /**
+     * posts_browse - List posts with optimized field projection
+     */
+    server.tool("posts_browse", "List posts with optimized field projection. Returns minimal data to save tokens.", {
+        status: z
+            .enum(["draft", "published", "scheduled", "all"])
+            .default("all")
+            .describe("Filter by post status"),
+        limit: z
+            .number()
+            .min(1)
+            .max(100)
+            .default(15)
+            .describe("Number of posts to return"),
+        page: z.number().min(1).default(1).describe("Page number for pagination"),
+        order: z
+            .enum(["published_at desc", "updated_at desc", "title asc"])
+            .default("updated_at desc")
+            .describe("Sort order"),
+        mode: z
+            .enum(["minimal", "compact", "standard"])
+            .default("compact")
+            .describe("Response detail level: minimal (~15 tokens/post), compact (~50), standard (~150)"),
+        filter: z
+            .string()
+            .optional()
+            .describe("NQL filter (e.g., 'tag:finance+status:published', 'author:matthieu'). Overrides status parameter if provided."),
+    }, async ({ status, limit, page, order, mode, filter: nqlFilter }) => {
+        // User-provided NQL filter takes precedence
+        let filter = nqlFilter;
+        // If no NQL filter, build from status
+        if (!filter && status !== "all") {
+            filter = `status:${status}`;
+        }
+        const fields = [...POST_FIELDS[mode]];
+        const result = await client.browse("posts", {
+            fields,
+            filter,
+            limit,
+            page,
+            order,
+            include: mode === "standard" ? ["tags"] : undefined,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    /**
+     * posts_read - Read a single post by ID or slug
+     */
+    server.tool("posts_read", "Read a single post. Use 'metadata' mode for info only, 'content' for readable text, 'full' for HTML.", {
+        id: z.string().optional().describe("Post ID"),
+        slug: z.string().optional().describe("Post slug (alternative to ID)"),
+        mode: z
+            .enum(["metadata", "content", "full"])
+            .default("content")
+            .describe("Response mode: metadata (~200 tokens), content (plaintext, ~500-2000), full (HTML, ~500-3000)"),
+    }, async ({ id, slug, mode }) => {
+        if (!id && !slug) {
+            throw new Error("Either id or slug must be provided");
+        }
+        const fields = [...POST_FIELDS[mode]];
+        const postId = id || `slug/${slug}`;
+        // Ghost requires formats=html to return HTML content
+        const needsHtml = mode === "content" || mode === "full";
+        const result = await client.read("posts", postId, {
+            fields,
+            include: ["tags"],
+            formats: needsHtml ? ["html"] : undefined,
+        });
+        // Convert HTML to plaintext if mode is 'content'
+        if (mode === "content" && result.posts?.[0]?.html) {
+            result.posts[0].plaintext = htmlToPlaintext(result.posts[0].html);
+            delete result.posts[0].html;
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    /**
+     * posts_add - Create a new post
+     */
+    server.tool("posts_add", "Create a new post. Returns minimal response with ID and URL.", {
+        title: z.string().min(1).describe("Post title"),
+        html: z.string().optional().describe("Post content as HTML"),
+        status: z
+            .enum(["draft", "published", "scheduled"])
+            .default("draft")
+            .describe("Post status"),
+        slug: z
+            .string()
+            .optional()
+            .describe("URL slug (auto-generated if not provided)"),
+        custom_excerpt: z
+            .string()
+            .optional()
+            .describe("Custom excerpt for SEO (replaces auto-generated)"),
+        custom_template: z
+            .string()
+            .optional()
+            .describe("Custom template name (e.g., 'custom-template-perso')"),
+        tags: z
+            .array(z.string())
+            .optional()
+            .describe("Array of tag slugs to assign"),
+        feature_image: z.string().url().optional().describe("Feature image URL"),
+        published_at: z
+            .string()
+            .datetime()
+            .optional()
+            .describe("Publication date (required for scheduled posts)"),
+    }, async (data) => {
+        const postData = {
+            title: data.title,
+            status: data.status,
+        };
+        if (data.html)
+            postData.html = data.html;
+        if (data.slug)
+            postData.slug = data.slug;
+        if (data.custom_excerpt)
+            postData.custom_excerpt = data.custom_excerpt;
+        // Use provided template or fall back to default from env
+        const template = data.custom_template ?? defaultTemplate;
+        if (template)
+            postData.custom_template = template;
+        if (data.feature_image)
+            postData.feature_image = data.feature_image;
+        if (data.published_at)
+            postData.published_at = data.published_at;
+        if (data.tags) {
+            postData.tags = data.tags.map((slug) => ({ slug }));
+        }
+        const result = await client.add("posts", postData);
+        // Return minimal response
+        const post = result.posts[0];
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        id: post.id,
+                        title: post.title,
+                        slug: post.slug,
+                        status: post.status,
+                        url: post.url,
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+    /**
+     * posts_edit - Update an existing post
+     */
+    server.tool("posts_edit", "Update a post. Automatically handles updated_at for optimistic locking.", {
+        id: z.string().describe("Post ID to update"),
+        title: z.string().optional().describe("New title"),
+        html: z.string().optional().describe("New content as HTML"),
+        status: z
+            .enum(["draft", "published", "scheduled"])
+            .optional()
+            .describe("New status"),
+        slug: z.string().optional().describe("New URL slug"),
+        custom_excerpt: z
+            .string()
+            .optional()
+            .describe("New custom excerpt (null to use auto-generated)"),
+        custom_template: z
+            .string()
+            .optional()
+            .describe("Custom template name (null to use default)"),
+        tags: z
+            .array(z.string())
+            .optional()
+            .describe("New tags (replaces existing). Array of tag slugs."),
+        feature_image: z
+            .string()
+            .url()
+            .nullable()
+            .optional()
+            .describe("New feature image URL (null to remove)"),
+    }, async ({ id, ...data }) => {
+        const updateData = {};
+        if (data.title !== undefined)
+            updateData.title = data.title;
+        if (data.html !== undefined)
+            updateData.html = data.html;
+        if (data.status !== undefined)
+            updateData.status = data.status;
+        if (data.slug !== undefined)
+            updateData.slug = data.slug;
+        if (data.custom_excerpt !== undefined)
+            updateData.custom_excerpt = data.custom_excerpt;
+        if (data.custom_template !== undefined)
+            updateData.custom_template = data.custom_template;
+        if (data.feature_image !== undefined)
+            updateData.feature_image = data.feature_image;
+        if (data.tags !== undefined) {
+            updateData.tags = data.tags.map((slug) => ({ slug }));
+        }
+        const result = await client.edit("posts", id, updateData);
+        const post = result.posts[0];
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        id: post.id,
+                        title: post.title,
+                        slug: post.slug,
+                        status: post.status,
+                        updated_at: post.updated_at,
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+    /**
+     * posts_delete - Delete a post
+     */
+    server.tool("posts_delete", "Permanently delete a post. This cannot be undone. CRITICAL: You MUST ask the user for explicit confirmation before calling this tool. Never call this tool without user approval first.", {
+        id: z.string().describe("Post ID to delete"),
+        title: z.string().describe("Post title (for confirmation display)"),
+        confirm: z.literal(true).describe("Must be true to confirm deletion"),
+    }, async ({ id, title }) => {
+        await client.delete("posts", id);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ success: true, deleted_id: id, title }),
+                },
+            ],
+        };
+    });
+    // ============================================================
+    // TAGS TOOLS
+    // ============================================================
+    /**
+     * tags_browse - List all tags
+     */
+    server.tool("tags_browse", "List all tags with optimized field projection.", {
+        limit: z
+            .number()
+            .min(1)
+            .max(100)
+            .default(50)
+            .describe("Number of tags to return"),
+        mode: z
+            .enum(["minimal", "standard"])
+            .default("minimal")
+            .describe("Response detail level: minimal (~15 tokens/tag), standard (~40)"),
+    }, async ({ limit, mode }) => {
+        const fields = [...TAG_FIELDS[mode]];
+        const result = await client.browse("tags", {
+            fields,
+            limit,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    /**
+     * tags_read - Read a single tag
+     */
+    server.tool("tags_read", "Read a single tag by ID or slug.", {
+        id: z.string().optional().describe("Tag ID"),
+        slug: z.string().optional().describe("Tag slug (alternative to ID)"),
+    }, async ({ id, slug }) => {
+        if (!id && !slug) {
+            throw new Error("Either id or slug must be provided");
+        }
+        const tagId = id || `slug/${slug}`;
+        const result = await client.read("tags", tagId, {
+            fields: [...TAG_FIELDS.standard],
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    // ============================================================
+    // IMAGES TOOLS
+    // ============================================================
+    /**
+     * images_upload - Upload an image to Ghost from local file or URL
+     */
+    server.tool("images_upload", "Upload an image to Ghost storage from a local file or URL. Returns the URL that can be used for feature_image or in post content.", {
+        file_path: z
+            .string()
+            .optional()
+            .describe("Absolute path to local image file (e.g., '/tmp/image.jpg')"),
+        url: z
+            .string()
+            .url()
+            .optional()
+            .describe("URL to download and upload (e.g., 'https://example.com/image.jpg')"),
+        filename: z
+            .string()
+            .optional()
+            .describe("Filename with extension (inferred from path/url if absent)"),
+    }, async ({ file_path, url: imageUrl, filename }) => {
+        if (!file_path && !imageUrl) {
+            throw new Error("Either file_path or url must be provided");
+        }
+        let resultUrl;
+        if (file_path) {
+            // Upload from local file
+            resultUrl = await client.uploadImageFromPath(file_path);
+        }
+        else if (imageUrl) {
+            // Upload from URL - filename is required
+            const inferredFilename = filename || imageUrl.split("/").pop() || "image.jpg";
+            if (!inferredFilename.includes(".")) {
+                throw new Error("Could not infer filename from URL. Please provide filename parameter.");
+            }
+            resultUrl = await client.uploadImageFromUrl(imageUrl, inferredFilename);
+        }
+        else {
+            throw new Error("Either file_path or url must be provided");
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ url: resultUrl }, null, 2),
+                },
+            ],
+        };
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/utils/fields.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Field presets for different response modes
+ *
+ * These presets control which fields are requested from Ghost API,
+ * enabling significant token reduction compared to full responses.
+ */
+/**
+ * Post field presets by response mode
+ *
+ * Token estimates per post:
+ * - minimal: ~15 tokens
+ * - compact: ~50 tokens
+ * - standard: ~150 tokens
+ * - metadata: ~200 tokens
+ * - content: ~500-2000 tokens (depends on article length)
+ * - full: ~500-3000 tokens
+ */
+export declare const POST_FIELDS: {
+    /** Bare minimum for listing - just identification and status */
+    readonly minimal: readonly ["id", "title", "status"];
+    /** Good for listing with actionable info */
+    readonly compact: readonly ["id", "title", "slug", "status", "published_at", "updated_at", "reading_time"];
+    /** For listing with preview info */
+    readonly standard: readonly ["id", "title", "slug", "status", "published_at", "updated_at", "reading_time", "excerpt", "feature_image"];
+    /** For reading post info without content */
+    readonly metadata: readonly ["id", "title", "slug", "status", "published_at", "updated_at", "reading_time", "excerpt", "feature_image"];
+    /** For reading post with content (HTML will be converted to plaintext) */
+    readonly content: readonly ["id", "title", "slug", "status", "published_at", "updated_at", "reading_time", "excerpt", "html"];
+    /** For reading post with full HTML */
+    readonly full: readonly ["id", "title", "slug", "status", "published_at", "updated_at", "reading_time", "excerpt", "feature_image", "html"];
+};
+/**
+ * Tag field presets by response mode
+ *
+ * Token estimates per tag:
+ * - minimal: ~15 tokens
+ * - standard: ~40 tokens
+ */
+export declare const TAG_FIELDS: {
+    /** Just identification */
+    readonly minimal: readonly ["id", "name", "slug"];
+    /** With description */
+    readonly standard: readonly ["id", "name", "slug", "description"];
+};
+/**
+ * Member field presets (if implementing members tools)
+ */
+export declare const MEMBER_FIELDS: {
+    readonly minimal: readonly ["id", "email", "name"];
+    readonly standard: readonly ["id", "email", "name", "status", "created_at"];
+};
+export type PostFieldMode = keyof typeof POST_FIELDS;
+export type TagFieldMode = keyof typeof TAG_FIELDS;
+export type MemberFieldMode = keyof typeof MEMBER_FIELDS;
+//# sourceMappingURL=fields.d.ts.map

package/dist/utils/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/utils/fields.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW;IACtB,gEAAgE;;IAGhE,4CAA4C;;IAW5C,oCAAoC;;IAapC,4CAA4C;;IAa5C,0EAA0E;;IAa1E,sCAAsC;;CAa9B,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,UAAU;IACrB,0BAA0B;;IAG1B,uBAAuB;;CAEf,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAGX,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,WAAW,CAAC;AACrD,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,UAAU,CAAC;AACnD,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,aAAa,CAAC"}

package/dist/utils/fields.js

@@ -0,0 +1,101 @@
+/**
+ * Field presets for different response modes
+ *
+ * These presets control which fields are requested from Ghost API,
+ * enabling significant token reduction compared to full responses.
+ */
+/**
+ * Post field presets by response mode
+ *
+ * Token estimates per post:
+ * - minimal: ~15 tokens
+ * - compact: ~50 tokens
+ * - standard: ~150 tokens
+ * - metadata: ~200 tokens
+ * - content: ~500-2000 tokens (depends on article length)
+ * - full: ~500-3000 tokens
+ */
+export const POST_FIELDS = {
+    /** Bare minimum for listing - just identification and status */
+    minimal: ["id", "title", "status"],
+    /** Good for listing with actionable info */
+    compact: [
+        "id",
+        "title",
+        "slug",
+        "status",
+        "published_at",
+        "updated_at",
+        "reading_time",
+    ],
+    /** For listing with preview info */
+    standard: [
+        "id",
+        "title",
+        "slug",
+        "status",
+        "published_at",
+        "updated_at",
+        "reading_time",
+        "excerpt",
+        "feature_image",
+    ],
+    /** For reading post info without content */
+    metadata: [
+        "id",
+        "title",
+        "slug",
+        "status",
+        "published_at",
+        "updated_at",
+        "reading_time",
+        "excerpt",
+        "feature_image",
+    ],
+    /** For reading post with content (HTML will be converted to plaintext) */
+    content: [
+        "id",
+        "title",
+        "slug",
+        "status",
+        "published_at",
+        "updated_at",
+        "reading_time",
+        "excerpt",
+        "html",
+    ],
+    /** For reading post with full HTML */
+    full: [
+        "id",
+        "title",
+        "slug",
+        "status",
+        "published_at",
+        "updated_at",
+        "reading_time",
+        "excerpt",
+        "feature_image",
+        "html",
+    ],
+};
+/**
+ * Tag field presets by response mode
+ *
+ * Token estimates per tag:
+ * - minimal: ~15 tokens
+ * - standard: ~40 tokens
+ */
+export const TAG_FIELDS = {
+    /** Just identification */
+    minimal: ["id", "name", "slug"],
+    /** With description */
+    standard: ["id", "name", "slug", "description"],
+};
+/**
+ * Member field presets (if implementing members tools)
+ */
+export const MEMBER_FIELDS = {
+    minimal: ["id", "email", "name"],
+    standard: ["id", "email", "name", "status", "created_at"],
+};
+//# sourceMappingURL=fields.js.map

package/dist/utils/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../src/utils/fields.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,gEAAgE;IAChE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC;IAElC,4CAA4C;IAC5C,OAAO,EAAE;QACP,IAAI;QACJ,OAAO;QACP,MAAM;QACN,QAAQ;QACR,cAAc;QACd,YAAY;QACZ,cAAc;KACf;IAED,oCAAoC;IACpC,QAAQ,EAAE;QACR,IAAI;QACJ,OAAO;QACP,MAAM;QACN,QAAQ;QACR,cAAc;QACd,YAAY;QACZ,cAAc;QACd,SAAS;QACT,eAAe;KAChB;IAED,4CAA4C;IAC5C,QAAQ,EAAE;QACR,IAAI;QACJ,OAAO;QACP,MAAM;QACN,QAAQ;QACR,cAAc;QACd,YAAY;QACZ,cAAc;QACd,SAAS;QACT,eAAe;KAChB;IAED,0EAA0E;IAC1E,OAAO,EAAE;QACP,IAAI;QACJ,OAAO;QACP,MAAM;QACN,QAAQ;QACR,cAAc;QACd,YAAY;QACZ,cAAc;QACd,SAAS;QACT,MAAM;KACP;IAED,sCAAsC;IACtC,IAAI,EAAE;QACJ,IAAI;QACJ,OAAO;QACP,MAAM;QACN,QAAQ;QACR,cAAc;QACd,YAAY;QACZ,cAAc;QACd,SAAS;QACT,eAAe;QACf,MAAM;KACP;CACO,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,0BAA0B;IAC1B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC;IAE/B,uBAAuB;IACvB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC;CACvC,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC;IAChC,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAC;CACjD,CAAC"}

package/dist/utils/html.d.ts

@@ -0,0 +1,26 @@
+/**
+ * HTML to plaintext conversion utilities
+ *
+ * Ghost stores content as HTML (or Lexical JSON internally).
+ * For LLM consumption, plaintext is more token-efficient.
+ */
+/**
+ * Convert HTML to plaintext
+ *
+ * Removes all HTML tags, scripts, styles, and normalizes whitespace.
+ * Also decodes common HTML entities.
+ *
+ * @param html - HTML string to convert
+ * @returns Clean plaintext
+ */
+export declare function htmlToPlaintext(html: string): string;
+/**
+ * Truncate text to a maximum length, preserving word boundaries
+ *
+ * @param text - Text to truncate
+ * @param maxLength - Maximum character length
+ * @param suffix - Suffix to add if truncated (default: "...")
+ * @returns Truncated text
+ */
+export declare function truncateText(text: string, maxLength: number, suffix?: string): string;
+//# sourceMappingURL=html.d.ts.map

package/dist/utils/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/utils/html.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkCpD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,MAAc,GACrB,MAAM,CAcR"}