@aiquants/html-to-markdown 0.2.6 → 0.3.0

package/dist/mcp-streamable.cjs

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-"use strict";require("./mcp-server-streamable-Cc4QsZQe.cjs").runStreamableMcpServer().catch(e=>{process.exit(1)});
+"use strict";require("./mcp-server-streamable-mF26pg3E.cjs").runStreamableMcpServer().catch(e=>{process.exit(1)});

package/dist/mcp-streamable.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { r as runStreamableMcpServer } from "./mcp-server-streamable-3B3B1fuS.js";
+import { r as runStreamableMcpServer } from "./mcp-server-streamable-CVDJHcWu.js";
 runStreamableMcpServer().catch((error) => {
   console.error("Failed to start streamable MCP server:", error);
   process.exit(1);

package/dist/mcp.cjs

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-const e=new(require("happy-dom").Window);Object.assign(global,{document:e.document,window:e,self:e});require("./mcp-server-Bo_mCvzz.cjs").runMcpServer().catch(e=>{process.exit(1)});
+const e=new(require("happy-dom").Window);Object.assign(global,{document:e.document,window:e,self:e});require("./mcp-server-CCu0Pcm3.cjs").runMcpServer().catch(e=>{process.exit(1)});

package/dist/mcp.js

@@ -6,7 +6,7 @@ Object.assign(global, {
   window,
   self: window
 });
-import { r as runMcpServer } from "./mcp-server-B8hz3lXI.js";
+import { r as runMcpServer } from "./mcp-server-BAmy7d8r.js";
 runMcpServer().catch((error) => {
   console.error("Failed to start MCP server:", error);
   process.exit(1);

package/dist/src/mcp-common.d.ts

@@ -0,0 +1,107 @@
+import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Arguments for HTML to Markdown conversion tool.
+ * HTML から Markdown への変換ツールの引数
+ */
+export interface HtmlToMarkdownArgs {
+    url?: string;
+    html_content?: string;
+    locale?: "en-US" | "ja-JP";
+}
+/**
+ * Arguments for file saving tool.
+ * ファイル保存ツールの引数
+ */
+export interface SaveContentArgs {
+    content: string;
+    save_path?: string;
+    save_directory?: string;
+    filename?: string;
+}
+/**
+ * Validate and parse arguments for HTML to Markdown conversion.
+ * HTML から Markdown への変換の引数を検証・解析
+ */
+export declare function parseHtmlToMarkdownArgs(args: HtmlToMarkdownArgs | undefined): HtmlToMarkdownArgs;
+/**
+ * Validate and parse arguments for content saving.
+ * コンテンツ保存の引数を検証・解析
+ */
+export declare function parseSaveContentArgs(args: SaveContentArgs | undefined): SaveContentArgs;
+/**
+ * Generate filename from URL or use default.
+ * URL からファイル名を生成または既定値を使用
+ */
+export declare function generateFilename(url?: string): string;
+/**
+ * Save content to file and return the saved path.
+ * コンテンツをファイルに保存し、保存したパスを返す
+ */
+export declare function saveContentToFile(content: string, savePath?: string, saveDirectory?: string, filename?: string): Promise<string>;
+/**
+ * Tool schema definitions for MCP servers.
+ * MCP サーバー用のツールスキーマ定義
+ */
+export declare const MCP_TOOL_SCHEMAS: {
+    htmlToMarkdown: {
+        readonly type: "object";
+        readonly properties: {
+            readonly url: {
+                readonly type: "string";
+                readonly description: "URL of the web page to convert (e.g., https://example.com). Handles JavaScript-rendered dynamic content effectively.";
+            };
+            readonly html_content: {
+                readonly type: "string";
+                readonly description: "HTML string to convert directly. Use instead of URL for local files or API response HTML content.";
+            };
+            readonly locale: {
+                readonly type: "string";
+                readonly description: "Browser locale setting. Use 'ja-JP' for Japanese sites, 'en-US' for English sites. Affects content rendering and language detection.";
+                readonly enum: readonly ["en-US", "ja-JP"];
+                readonly default: "en-US";
+            };
+        };
+        readonly anyOf: readonly [{
+            readonly required: readonly ["url"];
+        }, {
+            readonly required: readonly ["html_content"];
+        }];
+    };
+    saveContentToFile: {
+        readonly type: "object";
+        readonly properties: {
+            readonly content: {
+                readonly type: "string";
+                readonly description: "Text content to save to file. Will be saved as Markdown format.";
+            };
+            readonly save_path: {
+                readonly type: "string";
+                readonly description: "Complete file path including filename to save content (e.g., '/home/user/output.md'). Cannot be used with save_directory.";
+            };
+            readonly save_directory: {
+                readonly type: "string";
+                readonly description: "Directory path to save content with auto-generated filename (e.g., '/home/user/downloads'). Cannot be used with save_path.";
+            };
+            readonly filename: {
+                readonly type: "string";
+                readonly description: "Base filename to use when save_directory is specified (e.g., 'my-document'). Extension .md will be added automatically.";
+            };
+        };
+        readonly required: readonly ["content"];
+        readonly anyOf: readonly [{
+            readonly required: readonly ["save_path"];
+        }, {
+            readonly required: readonly ["save_directory"];
+        }];
+    };
+};
+/**
+ * Common error handling utility for MCP tools.
+ * MCP ツール用の共通エラーハンドリングユーティリティ
+ */
+export declare function createErrorResult(error: unknown): CallToolResult;
+/**
+ * Common success result utility for MCP tools.
+ * MCP ツール用の共通成功結果ユーティリティ
+ */
+export declare function createSuccessResult(text: string): CallToolResult;

package/dist/src/mcp-server-streamable.d.ts

@@ -1,5 +1,6 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { CallToolResult, Progress, Tool } from '@modelcontextprotocol/sdk/types.js';
+import { HtmlToMarkdownArgs, SaveContentArgs } from './mcp-common.ts';
 /**
  * The context for a tool call.
  * ツール呼び出しのコンテキスト
@@ -7,24 +8,12 @@ import { CallToolResult, Progress, Tool } from '@modelcontextprotocol/sdk/types.
 export type ToolContext<T = unknown> = {
     [toolName: string]: T;
 };
-/**
- * Arguments for HTML to Markdown conversion tool.
- * HTML から Markdown への変換ツールの引数
- */
-interface HtmlToMarkdownArgs {
-    url?: string;
-    html_content?: string;
-    locale?: "en-US" | "ja-JP";
-    output_format?: "markdown" | "html" | "both";
-    save_path?: string;
-    save_directory?: string;
-}
 /**
  * Extended Tool interface with handler function.
  * ハンドラー関数を含む拡張 Tool インターフェース
  */
 interface ExtendedTool extends Tool {
-    handler: (args: HtmlToMarkdownArgs, context: ToolContext<HtmlToMarkdownArgs>) => AsyncGenerator<Progress | {
+    handler: (args: HtmlToMarkdownArgs | SaveContentArgs, context: ToolContext<HtmlToMarkdownArgs | SaveContentArgs>) => AsyncGenerator<Progress | {
         type: "result";
         result: CallToolResult;
     }>;
@@ -57,6 +46,14 @@ export declare class StreamableHtmlToMarkdownMcpServer {
         type: "result";
         result: CallToolResult;
     }>;
+    /**
+     * Handle save content to file tool call with streamable support.
+     * streamable サポート付きのファイル保存ツール呼び出しを処理
+     */
+    handleSaveContentToFile(args: SaveContentArgs, _context: ToolContext<SaveContentArgs>): AsyncGenerator<Progress | {
+        type: "result";
+        result: CallToolResult;
+    }>;
     /**
      * Start the streamable MCP server.
      * streamable MCP サーバーを開始

package/dist/src/mcp-server.d.ts

@@ -1,21 +1,6 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-/**
- * Arguments for HTML to Markdown conversion tool.
- * HTML から Markdown への変換ツールの引数
- */
-interface HtmlToMarkdownArgs {
-    url?: string;
-    html_content?: string;
-    locale?: "en-US" | "ja-JP";
-    output_format?: "markdown" | "html" | "both";
-    save_path?: string;
-    save_directory?: string;
-}
-/**
- * Validate and parse arguments for HTML to Markdown conversion.
- * HTML から Markdown への変換の引数を検証・解析
- */
-export declare function parseHtmlToMarkdownArgs(args: HtmlToMarkdownArgs | undefined): HtmlToMarkdownArgs;
+import { HtmlToMarkdownArgs, SaveContentArgs } from './mcp-common.ts';
+export { type HtmlToMarkdownArgs, type SaveContentArgs, parseHtmlToMarkdownArgs, parseSaveContentArgs, saveContentToFile, createErrorResult, createSuccessResult, MCP_TOOL_SCHEMAS, } from './mcp-common.ts';
 /**
  * MCP Server for HTML to Markdown conversion.
  * HTML から Markdown への変換を行う MCP サーバー
@@ -34,11 +19,144 @@ export declare class HtmlToMarkdownMcpServer {
      * HTML から Markdown への変換ツール呼び出しを処理
      */
     handleHtmlToMarkdown(args: HtmlToMarkdownArgs | undefined): Promise<{
-        content: {
-            type: string;
+        [x: string]: unknown;
+        content: ({
+            [x: string]: unknown;
+            text: string;
+            type: "text";
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "image";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "audio";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource_link";
+            name: string;
+            uri: string;
+            title?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            mimeType?: string | undefined;
+            description?: string | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource";
+            resource: {
+                [x: string]: unknown;
+                text: string;
+                uri: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            } | {
+                [x: string]: unknown;
+                uri: string;
+                blob: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            };
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+        isError?: boolean | undefined;
+    }>;
+    /**
+     * Handle save content to file tool call.
+     * ファイル保存ツール呼び出しを処理
+     */
+    handleSaveContentToFile(args: SaveContentArgs | undefined): Promise<{
+        [x: string]: unknown;
+        content: ({
+            [x: string]: unknown;
             text: string;
-        }[];
-        isError: boolean;
+            type: "text";
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "image";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "audio";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource_link";
+            name: string;
+            uri: string;
+            title?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            mimeType?: string | undefined;
+            description?: string | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource";
+            resource: {
+                [x: string]: unknown;
+                text: string;
+                uri: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            } | {
+                [x: string]: unknown;
+                uri: string;
+                blob: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            };
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+        isError?: boolean | undefined;
     }>;
     /**
      * Start the MCP server.
@@ -56,4 +174,3 @@ export declare const createMcpServer: () => HtmlToMarkdownMcpServer;
  * MCP サーバーを実行するメイン関数
  */
 export declare const runMcpServer: () => Promise<void>;
-export {};

package/dist/{version-PCzxchJe.js → version-BF9-U8Ef.js}

@@ -6,8 +6,10 @@ Object.assign(global, {
   self: window
 });
 import { b as getDefaultExportFromCjs } from "./core-CouDTni-.js";
+import { promises } from "fs";
+import { resolve, dirname } from "path";
 import { readFileSync } from "node:fs";
-import { dirname, resolve } from "node:path";
+import { dirname as dirname$1, resolve as resolve$1 } from "node:path";
 import { fileURLToPath } from "node:url";
 var util$1;
 (function(util2) {
@@ -11290,11 +11292,150 @@ class Server extends Protocol {
     return this.notification({ method: "notifications/prompts/list_changed" });
   }
 }
+function parseHtmlToMarkdownArgs(args) {
+  if (!args || typeof args !== "object") {
+    throw new Error("Arguments are required");
+  }
+  const { url, html_content, locale = "en-US" } = args;
+  if (!url && !html_content) {
+    throw new Error("Either 'url' or 'html_content' is required");
+  }
+  if (url && typeof url !== "string") {
+    throw new Error("'url' must be a string");
+  }
+  if (html_content && typeof html_content !== "string") {
+    throw new Error("'html_content' must be a string");
+  }
+  if (locale && !["en-US", "ja-JP"].includes(locale)) {
+    throw new Error("'locale' must be 'en-US' or 'ja-JP'");
+  }
+  return {
+    url,
+    html_content,
+    locale
+  };
+}
+function parseSaveContentArgs(args) {
+  if (!args || typeof args !== "object") {
+    throw new Error("Arguments are required");
+  }
+  const { content, save_path, save_directory, filename } = args;
+  if (!content || typeof content !== "string") {
+    throw new Error("'content' is required and must be a string");
+  }
+  if (!save_path && !save_directory) {
+    throw new Error("Either 'save_path' or 'save_directory' is required");
+  }
+  if (save_path && typeof save_path !== "string") {
+    throw new Error("'save_path' must be a string");
+  }
+  if (save_directory && typeof save_directory !== "string") {
+    throw new Error("'save_directory' must be a string");
+  }
+  if (filename && typeof filename !== "string") {
+    throw new Error("'filename' must be a string");
+  }
+  if (save_path && save_directory) {
+    throw new Error("Cannot specify both 'save_path' and 'save_directory'");
+  }
+  return {
+    content,
+    save_path,
+    save_directory,
+    filename
+  };
+}
+function generateFilename(url) {
+  return "page";
+}
+async function saveContentToFile(content, savePath, saveDirectory, filename) {
+  let finalPath;
+  if (savePath) {
+    finalPath = resolve(savePath);
+  } else if (saveDirectory) {
+    const baseFilename = filename || generateFilename();
+    const extension = ".md";
+    finalPath = resolve(saveDirectory, `${baseFilename}${extension}`);
+  } else {
+    throw new Error("Either save_path or save_directory must be specified");
+  }
+  await promises.mkdir(dirname(finalPath), { recursive: true });
+  await promises.writeFile(finalPath, content, "utf-8");
+  return finalPath;
+}
+const MCP_TOOL_SCHEMAS = {
+  htmlToMarkdown: {
+    type: "object",
+    properties: {
+      url: {
+        type: "string",
+        description: "URL of the web page to convert (e.g., https://example.com). Handles JavaScript-rendered dynamic content effectively."
+      },
+      html_content: {
+        type: "string",
+        description: "HTML string to convert directly. Use instead of URL for local files or API response HTML content."
+      },
+      locale: {
+        type: "string",
+        description: "Browser locale setting. Use 'ja-JP' for Japanese sites, 'en-US' for English sites. Affects content rendering and language detection.",
+        enum: ["en-US", "ja-JP"],
+        default: "en-US"
+      }
+    },
+    anyOf: [{ required: ["url"] }, { required: ["html_content"] }]
+  },
+  saveContentToFile: {
+    type: "object",
+    properties: {
+      content: {
+        type: "string",
+        description: "Text content to save to file. Will be saved as Markdown format."
+      },
+      save_path: {
+        type: "string",
+        description: "Complete file path including filename to save content (e.g., '/home/user/output.md'). Cannot be used with save_directory."
+      },
+      save_directory: {
+        type: "string",
+        description: "Directory path to save content with auto-generated filename (e.g., '/home/user/downloads'). Cannot be used with save_path."
+      },
+      filename: {
+        type: "string",
+        description: "Base filename to use when save_directory is specified (e.g., 'my-document'). Extension .md will be added automatically."
+      }
+    },
+    required: ["content"],
+    anyOf: [{ required: ["save_path"] }, { required: ["save_directory"] }]
+  }
+};
+function createErrorResult(error) {
+  const errorMessage = error instanceof Error ? error.message : String(error);
+  return {
+    content: [
+      {
+        type: "text",
+        text: `Error: ${errorMessage}`
+      }
+    ],
+    isError: true
+  };
+}
+function createSuccessResult(text) {
+  return {
+    content: [
+      {
+        type: "text",
+        text
+      }
+    ],
+    isError: false
+  };
+}
 const getPackageVersion = () => {
   try {
     const __filename = fileURLToPath(import.meta.url);
-    const __dirname = dirname(__filename);
-    const packageJsonPath = resolve(__dirname, "../package.json");
+    const __dirname = dirname$1(__filename);
+    const packageJsonPath = resolve$1(__dirname, "../package.json");
     const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
     return packageJson.version || "0.0.0";
   } catch (error) {
@@ -11308,11 +11449,17 @@ export {
   InitializeRequestSchema as I,
   JSONRPCMessageSchema as J,
   ListToolsRequestSchema as L,
+  MCP_TOOL_SCHEMAS as M,
   Server as S,
-  isJSONRPCRequest as a,
-  SUPPORTED_PROTOCOL_VERSIONS as b,
-  isJSONRPCResponse as c,
-  isJSONRPCError as d,
+  createErrorResult as a,
+  parseSaveContentArgs as b,
+  createSuccessResult as c,
+  isJSONRPCRequest as d,
+  SUPPORTED_PROTOCOL_VERSIONS as e,
+  isJSONRPCResponse as f,
   getPackageVersion as g,
-  isInitializeRequest as i
+  isJSONRPCError as h,
+  isInitializeRequest as i,
+  parseHtmlToMarkdownArgs as p,
+  saveContentToFile as s
 };