html2pptx-local-mcp 1.1.28 → 1.1.31

package/app/docs/content.js

@@ -763,7 +763,7 @@ export const DOCS_COPY = {
     skillsDescription:
       'Skills are packaged capabilities that extend AI coding agents with domain-specific knowledge and workflows. The html2pptx.app skill teaches your agent how to author slide-safe HTML, validate it against the PPTX conversion contract, optionally open the local visual editor, export through remote or local MCP workflows, and publish HTML template drafts through its built-in remote MCP publishing workflow. Install once, and your agent can convert natural language instructions into production-ready PowerPoint files or creator-owned HTML drafts.',
     skillsHowItWorks: 'The skill bundles four core capabilities: (1) HTML authoring knowledge -- the rules for writing HTML/CSS that converts cleanly to editable PowerPoint, (2) MCP-based export automation -- connecting to the remote html2pptx.app MCP server or a local stdio MCP server to create jobs, poll status, and retrieve results, (3) local visual editing -- opening edit-slide through a localhost bridge when the user wants to inspect or tweak the HTML before export, and (4) template publishing -- requiring HTML drafts to go through the remote MCP validate/publish loop. The agent should ask before adding a local MCP server because that changes the user’s MCP configuration.',
-    skillsCompatibility: 'Works with 18+ AI agents including Claude Code, Grok Build, Cursor, GitHub Copilot, Windsurf, Cline, Codex, and more. Use the skills CLI command for Claude Code, Codex, Cursor, and Windsurf. For Grok Build, use the Grok-specific skills installer shown below.',
+    skillsCompatibility: 'Works with 18+ AI agents including Claude Code, Codex, Cursor, VS Code (GitHub Copilot), Grok Build, Antigravity, and more. Use the skills CLI command for Claude Code, Codex, and Cursor. For Grok Build, use the Grok-specific skills installer shown below.',
     skillsWorkflowTitle: 'Workflow',
 	    skillsWorkflow: [
 	      'Agent receives a user request (e.g., "Create a deck from these meeting notes")',
@@ -881,8 +881,8 @@ html2pptx edit ./html2pptx/slides.html --no-open`,
       {
         step: '1',
         title: 'Install MCP + Skill',
-        icons: ['claude-code', 'codex', 'cursor', 'windsurf'],
-        body: 'Choose the command for the agent you actually use: Claude Code, Codex, Cursor, or Windsurf. For Grok Build, use the Grok-specific installer. For other supported agents or multiple targets, use the interactive selector. Avoid --yes unless you intentionally want to install into every detected agent directory.',
+        icons: ['claude-code', 'codex', 'cursor'],
+        body: 'Choose the command for the agent you actually use: Claude Code, Codex, or Cursor. For Grok Build, use the Grok-specific installer. For other supported agents or multiple targets, use the interactive selector. Avoid --yes unless you intentionally want to install into every detected agent directory.',
         code: SKILL_INSTALL_COMMAND_EN,
       },
       {
@@ -974,20 +974,13 @@ echo 'HTML2PPTX_API_KEY=sk_live_xxxx' >> .env`,
         ],
       },
       {
-        id: 'windsurf',
-        label: 'Windsurf',
-        icon: 'https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/windsurf/default.svg',
-        steps: [
-          { title: 'Add to mcp_config.json', body: 'Edit ~/.codeium/windsurf/mcp_config.json and add the following. Restart Windsurf after saving.', code: `{\n  "mcpServers": {\n    "html2pptx": {\n      "serverUrl": "https://html2pptx.app/mcp"\n    }\n  }\n}` },
-        ],
-      },
-      {
-        id: 'cline',
-        label: 'Cline',
-        icon: 'https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/cline/default.svg',
+        id: 'antigravity',
+        label: 'Antigravity',
+        icon: 'https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/antigravity-google/default.svg',
         steps: [
-          { title: 'Add via Cline sidebar', body: 'Open the Cline sidebar > Configure tab > "Configure MCP Servers" and add the following.', code: `{\n  "mcpServers": {\n    "html2pptx": {\n      "url": "https://html2pptx.app/mcp",\n      "type": "streamableHttp"\n    }\n  }\n}` },
+          { title: 'Add to ~/.antigravity/mcp.json', body: 'Create or edit ~/.antigravity/mcp.json and add the following. Restart Antigravity after saving so the IDE picks up the new MCP server.', code: `{\n  "mcpServers": {\n    "html2pptx": {\n      "url": "https://html2pptx.app/mcp"\n    }\n  }\n}` },
         ],
+        tip: 'Antigravity (Google) uses the standard MCP mcpServers shape — same JSON as Cursor.',
       },
     ],
     mcpToolsTitle: 'Available MCP Tools',
@@ -1675,7 +1668,7 @@ echo 'HTML2PPTX_API_KEY=sk_live_xxxx' >> .env`,
     skillsDescription:
       'Skillsは、AIコーディングエージェントにドメイン固有の知識とワークフローを追加するパッケージ機能です。html2pptx.app のスキルをインストールすると、エージェントがスライド用HTMLの作成方法を理解し、PPTX変換契約に対する検証を行い、必要に応じてローカル Visual Editor を開き、remote MCP または local MCP のワークフローでエクスポートし、内蔵のremote MCP公開ワークフローでHTMLテンプレートdraftを作成できます。自然言語の指示だけで、本番品質のPowerPointファイルや作成者所有のHTML draftを生成できます。',
     skillsHowItWorks: 'スキルには4つのコア機能がバンドルされています: (1) HTMLオーサリング知識 -- 高品質なPowerPointに変換されるHTML/CSSの書き方ルール、(2) MCPベースのエクスポート自動化 -- remote MCP または local stdio MCP に接続してジョブ作成・ステータスポーリング・結果取得を行う仕組み、(3) ローカル Visual Editor -- ユーザーがPPTX出力前にHTMLを目視確認・微調整したい場合に edit-slide を localhost bridge 経由で開く仕組み、(4) テンプレート公開 -- HTML draft を remote MCP の validate/publish ループに限定する仕組みです。local MCP の追加はユーザーのMCP設定を変更するため、エージェントは必ず事前に確認します。',
-    skillsCompatibility: 'Claude Code、Grok Build、Cursor、GitHub Copilot、Windsurf、Cline、Codex 等 18以上のAIエージェントに対応。Claude Code、Codex、Cursor、Windsurf は skills CLI コマンドを使います。Grok Build は下に表示している Grok 専用の skills installer を使います。',
+    skillsCompatibility: 'Claude Code、Codex、Cursor、VS Code (GitHub Copilot)、Grok Build、Antigravity 等 18以上のAIエージェントに対応。Claude Code、Codex、Cursor は skills CLI コマンドを使います。Grok Build は下に表示している Grok 専用の skills installer を使います。',
     skillsWorkflowTitle: 'ワークフロー',
 	    skillsWorkflow: [
 	      'エージェントがユーザーリクエストを受信（例: 「この会議メモからデッキを作成して」）',
@@ -1793,8 +1786,8 @@ html2pptx edit ./html2pptx/slides.html --no-open`,
       {
         step: '1',
         title: 'MCP + スキルをインストール',
-        icons: ['claude-code', 'codex', 'cursor', 'windsurf'],
-        body: 'Claude Code、Codex、Cursor、Windsurf のうち、実際に使うエージェントのコマンドを選んで実行してください。Grok Build は Grok 専用 installer を使います。その他の対応エージェントや複数指定の場合は対話形式で選択します。--yes は検出された全エージェントのディレクトリへ入るため、全対応が必要な場合以外は使わないでください。',
+        icons: ['claude-code', 'codex', 'cursor'],
+        body: 'Claude Code、Codex、Cursor のうち、実際に使うエージェントのコマンドを選んで実行してください。Grok Build は Grok 専用 installer を使います。その他の対応エージェントや複数指定の場合は対話形式で選択します。--yes は検出された全エージェントのディレクトリへ入るため、全対応が必要な場合以外は使わないでください。',
         code: SKILL_INSTALL_COMMAND_JA,
       },
       {
@@ -1886,20 +1879,13 @@ echo 'HTML2PPTX_API_KEY=sk_live_xxxx' >> .env`,
         ],
       },
       {
-        id: 'windsurf',
-        label: 'Windsurf',
-        icon: 'https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/windsurf/default.svg',
-        steps: [
-          { title: 'mcp_config.json に追加', body: '~/.codeium/windsurf/mcp_config.json を編集し、以下を追加してください。保存後 Windsurf を再起動してください。', code: `{\n  "mcpServers": {\n    "html2pptx": {\n      "serverUrl": "https://html2pptx.app/mcp"\n    }\n  }\n}` },
-        ],
-      },
-      {
-        id: 'cline',
-        label: 'Cline',
-        icon: 'https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/cline/default.svg',
+        id: 'antigravity',
+        label: 'Antigravity',
+        icon: 'https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/antigravity-google/default.svg',
         steps: [
-          { title: 'Cline サイドバーから追加', body: 'Cline サイドバー > Configure タブ > 「Configure MCP Servers」を開き、以下を追加してください。', code: `{\n  "mcpServers": {\n    "html2pptx": {\n      "url": "https://html2pptx.app/mcp",\n      "type": "streamableHttp"\n    }\n  }\n}` },
+          { title: '~/.antigravity/mcp.json に追加', body: '~/.antigravity/mcp.json を作成または編集し、以下を追加してください。保存後 Antigravity を再起動するとMCPサーバが読み込まれます。', code: `{\n  "mcpServers": {\n    "html2pptx": {\n      "url": "https://html2pptx.app/mcp"\n    }\n  }\n}` },
         ],
+        tip: 'Antigravity (Google) は標準の MCP mcpServers 形式をそのまま使えます。Cursor とまったく同じ JSON です。',
       },
     ],
     mcpToolsTitle: '利用可能なMCPツール',

package/cli/dist/commands/edit.d.ts

@@ -1,4 +1,3 @@
-import { type IncomingMessage, type ServerResponse } from "node:http";
 export interface EditOptions {
     port?: string;
     baseUrl?: string;
@@ -18,7 +17,7 @@ declare function normalizeBaseUrl(raw: string): URL;
 declare function readRegisteredEditorBaseUrl(root: string): Promise<string | null>;
 declare function resolveEditorBaseUrl(root: string, explicitBaseUrl: string | undefined): Promise<URL>;
 declare function buildEditorUrl(baseUrl: URL, rel: string, bridgeUrl: string, sessionToken: string): URL;
-declare function createBridgeServer(ctx: BridgeContext): import("node:http").Server<typeof IncomingMessage, typeof ServerResponse>;
+declare function createBridgeServer(ctx: BridgeContext): any;
 declare function listen(server: ReturnType<typeof createBridgeServer>, requestedPort: number): Promise<number>;
 export declare function editCommand(input: string | undefined, options?: EditOptions): Promise<void>;
 export declare const editCommandInternalsForTest: {

package/cli/dist/dist/commands/config-show.d.ts

@@ -0,0 +1 @@
+export declare function configShowCommand(): Promise<void>;

package/cli/dist/dist/commands/config-show.js

@@ -0,0 +1,16 @@
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+import { loadConfig, getConfigPath } from "../config.js";
+export async function configShowCommand() {
+    const config = await loadConfig();
+    const configPath = getConfigPath();
+    p.log.info(pc.bold("Config file: ") + pc.dim(configPath));
+    if (!config.apiKey) {
+        p.log.warn("No configuration found. Run " + pc.cyan("html2pptx login") + " to set up.");
+        return;
+    }
+    p.log.info(pc.bold("API Key: ") +
+        pc.dim(config.apiKey.slice(0, 12) + "..." + config.apiKey.slice(-4)));
+    p.log.info(pc.bold("API Base URL: ") +
+        (config.baseUrl ?? "https://html2pptx.app") + pc.dim(" (default)"));
+}

package/cli/dist/dist/commands/convert.d.ts

@@ -0,0 +1,10 @@
+interface ConvertOptions {
+    output?: string;
+    size?: string;
+    css?: string;
+    json?: boolean;
+    open?: boolean;
+    baseUrl?: string;
+}
+export declare function convertCommand(input?: string, options?: ConvertOptions): Promise<void>;
+export {};

package/cli/dist/dist/commands/convert.js

@@ -0,0 +1,311 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { exec } from "node:child_process";
+import { platform } from "node:os";
+import { basename, resolve } from "node:path";
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+import { loadConfig } from "../config.js";
+function parseSize(size) {
+    if (size === "16:9")
+        return { layout: "LAYOUT_16x9" };
+    if (size === "4:3")
+        return { layout: "LAYOUT_4x3" };
+    const match = size.match(/^(\d+)x(\d+)$/);
+    if (match)
+        return { width: parseInt(match[1]), height: parseInt(match[2]) };
+    return { layout: "LAYOUT_16x9" };
+}
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+function openFile(filePath) {
+    const os = platform();
+    const cmd = os === "darwin" ? "open" : os === "win32" ? "start" : "xdg-open";
+    exec(`${cmd} "${filePath}"`);
+}
+async function interactivePrompt() {
+    p.intro(pc.bgCyan(pc.black(" html2pptx convert ")));
+    const result = await p.group({
+        input: () => p.text({
+            message: "HTML file to convert",
+            placeholder: "./slides.html",
+            validate(value) {
+                if (!value)
+                    return "HTML file path is required";
+                if (!value.endsWith(".html") && !value.endsWith(".htm"))
+                    return "File must be .html or .htm";
+            },
+        }),
+        size: () => p.select({
+            message: "Slide size",
+            options: [
+                { value: "16:9", label: "16:9 (1600x900)", hint: "default" },
+                { value: "4:3", label: "4:3 (1024x768)" },
+                { value: "custom", label: "Custom size" },
+            ],
+        }),
+        customSize: ({ results }) => {
+            if (results.size !== "custom")
+                return;
+            return p.text({
+                message: "Enter custom size (WxH)",
+                placeholder: "1920x1080",
+                validate(value) {
+                    if (!value?.match(/^\d+x\d+$/))
+                        return 'Format: WIDTHxHEIGHT (e.g. 1920x1080)';
+                },
+            });
+        },
+        css: () => p.text({
+            message: "External CSS file (optional)",
+            placeholder: "Press Enter to skip",
+        }),
+        output: ({ results }) => {
+            const defaultName = basename(results.input).replace(/\.html?$/, "") + ".pptx";
+            return p.text({
+                message: "Output filename",
+                placeholder: defaultName,
+                initialValue: defaultName,
+            });
+        },
+    }, {
+        onCancel() {
+            p.cancel("Conversion cancelled.");
+            process.exit(0);
+        },
+    });
+    return {
+        input: result.input,
+        output: result.output,
+        size: result.customSize ?? result.size,
+        css: result.css || undefined,
+    };
+}
+async function runExport(html, css, size, fileName, baseUrl, apiKey) {
+    const sizeParams = parseSize(size);
+    const body = {
+        html,
+        fileName,
+        responseFormat: "url",
+        ...sizeParams,
+    };
+    if (css)
+        body.css = css;
+    const res = await fetch(`${baseUrl}/api/v1/export/jobs`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify(body),
+    });
+    if (res.status === 401) {
+        throw new Error("Invalid API key. Run `html2pptx login` to update your key.");
+    }
+    if (res.status === 403) {
+        throw new Error("Access denied. Your API key may be expired or your plan may have changed. Visit https://html2pptx.app/dashboard to check.");
+    }
+    if (res.status === 413) {
+        throw new Error("HTML payload too large for your plan. Try reducing the HTML size or upgrading your plan.");
+    }
+    if (res.status === 429) {
+        throw new Error("Rate limit exceeded. Please wait a moment and try again, or upgrade your plan for higher limits.");
+    }
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`API error ${res.status}: ${text}`);
+    }
+    return (await res.json());
+}
+async function pollJob(statusUrl, apiKey, baseUrl) {
+    if (!statusUrl.startsWith(baseUrl)) {
+        throw new Error("Unexpected status URL from server");
+    }
+    const maxAttempts = 60;
+    for (let i = 0; i < maxAttempts; i++) {
+        await new Promise((r) => setTimeout(r, 2000));
+        const res = await fetch(statusUrl, {
+            headers: { Authorization: `Bearer ${apiKey}` },
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`Poll error ${res.status}: ${text}`);
+        }
+        const data = (await res.json());
+        if (data.status === "completed")
+            return data;
+        if (data.status === "failed")
+            throw new Error(data.error ?? "Export failed");
+    }
+    throw new Error("Export timed out after 2 minutes");
+}
+async function downloadFile(url, outputPath) {
+    const res = await fetch(url);
+    if (!res.ok)
+        throw new Error(`Download failed: ${res.status}`);
+    const buffer = Buffer.from(await res.arrayBuffer());
+    await writeFile(outputPath, buffer);
+    return buffer.byteLength;
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+export async function convertCommand(input, options = {}) {
+    const config = await loadConfig();
+    const apiKey = config.apiKey;
+    const baseUrl = options.baseUrl ?? config.baseUrl ?? "https://html2pptx.app";
+    const jsonMode = options.json ?? false;
+    if (!apiKey) {
+        if (jsonMode) {
+            console.log(JSON.stringify({ success: false, error: "No API key found. Run html2pptx login first." }));
+            process.exit(1);
+        }
+        p.log.error("No API key found. Run " + pc.cyan("html2pptx login") + " first.");
+        process.exit(1);
+    }
+    let htmlPath;
+    let outputFile;
+    let size;
+    let cssPath;
+    // If args provided -> direct mode, else -> interactive mode
+    if (input) {
+        htmlPath = resolve(input);
+        outputFile =
+            options.output ?? basename(htmlPath).replace(/\.html?$/, "") + ".pptx";
+        size = options.size ?? "16:9";
+        cssPath = options.css;
+    }
+    else {
+        const answers = await interactivePrompt();
+        htmlPath = resolve(answers.input);
+        outputFile = answers.output;
+        size = answers.size;
+        cssPath = answers.css;
+    }
+    const startTime = Date.now();
+    const spinner = jsonMode ? null : p.spinner();
+    spinner?.start("Reading HTML file...");
+    let html;
+    try {
+        html = await readFile(htmlPath, "utf-8");
+    }
+    catch {
+        if (jsonMode) {
+            console.log(JSON.stringify({ success: false, error: `Could not read file: ${htmlPath}` }));
+        }
+        else {
+            spinner?.stop("Failed");
+            p.log.error(`Could not read file: ${pc.dim(htmlPath)}`);
+        }
+        process.exit(1);
+    }
+    let css;
+    if (cssPath) {
+        try {
+            css = await readFile(resolve(cssPath), "utf-8");
+        }
+        catch {
+            if (jsonMode) {
+                console.log(JSON.stringify({ success: false, error: `Could not read CSS file: ${cssPath}` }));
+            }
+            else {
+                spinner?.stop("Failed");
+                p.log.error(`Could not read CSS file: ${pc.dim(cssPath)}`);
+            }
+            process.exit(1);
+        }
+    }
+    spinner?.message("Sending to html2pptx API...");
+    let job;
+    try {
+        job = await runExport(html, css, size, outputFile, baseUrl, apiKey);
+    }
+    catch (e) {
+        const errMsg = e.message;
+        if (jsonMode) {
+            console.log(JSON.stringify({ success: false, error: errMsg }));
+        }
+        else {
+            spinner?.stop("Failed");
+            p.log.error(errMsg);
+        }
+        process.exit(1);
+    }
+    const finishConversion = async (downloadUrl) => {
+        spinner?.message("Downloading PPTX...");
+        const fileSize = await downloadFile(downloadUrl, resolve(outputFile));
+        const duration = Date.now() - startTime;
+        if (jsonMode) {
+            const result = {
+                success: true,
+                file: outputFile,
+                size: formatBytes(fileSize),
+                duration: formatDuration(duration),
+            };
+            console.log(JSON.stringify(result));
+        }
+        else {
+            spinner?.stop(pc.green("Done!"));
+            p.log.success(`Saved to ${pc.cyan(outputFile)} ${pc.dim(`(${formatBytes(fileSize)}, ${formatDuration(duration)})`)}`);
+            // Next steps guidance
+            p.log.info(pc.dim("Next: ") +
+                `Open the file or run ${pc.cyan("html2pptx status")} to check your usage.`);
+        }
+        if (options.open) {
+            openFile(resolve(outputFile));
+        }
+    };
+    // If job completed immediately
+    if (job.status === "completed" && job.downloadUrl) {
+        try {
+            await finishConversion(job.downloadUrl);
+            return;
+        }
+        catch (e) {
+            const errMsg = e.message;
+            if (jsonMode) {
+                console.log(JSON.stringify({ success: false, error: errMsg }));
+            }
+            else {
+                spinner?.stop("Failed");
+                p.log.error(errMsg);
+            }
+            process.exit(1);
+        }
+    }
+    // Poll for completion
+    spinner?.message("Converting... this may take a moment");
+    try {
+        const result = await pollJob(job.statusUrl, apiKey, baseUrl);
+        if (result.downloadUrl) {
+            await finishConversion(result.downloadUrl);
+        }
+        else {
+            if (jsonMode) {
+                console.log(JSON.stringify({ success: false, error: "No download URL returned" }));
+            }
+            else {
+                spinner?.stop("Failed");
+                p.log.error("No download URL returned");
+            }
+            process.exit(1);
+        }
+    }
+    catch (e) {
+        const errMsg = e.message;
+        if (jsonMode) {
+            console.log(JSON.stringify({ success: false, error: errMsg }));
+        }
+        else {
+            spinner?.stop("Failed");
+            p.log.error(errMsg);
+        }
+        process.exit(1);
+    }
+}

package/cli/dist/dist/commands/edit.d.ts

@@ -0,0 +1,34 @@
+import { type IncomingMessage, type ServerResponse } from "node:http";
+export interface EditOptions {
+    port?: string;
+    baseUrl?: string;
+    noOpen?: boolean;
+    open?: boolean;
+    json?: boolean;
+}
+interface BridgeContext {
+    root: string;
+    editorOrigin: string;
+    localStateDir: string;
+    sessionToken: string;
+}
+declare function generateSessionToken(): string;
+declare function parsePort(value: string | undefined): number;
+declare function normalizeBaseUrl(raw: string): URL;
+declare function readRegisteredEditorBaseUrl(root: string): Promise<string | null>;
+declare function resolveEditorBaseUrl(root: string, explicitBaseUrl: string | undefined): Promise<URL>;
+declare function buildEditorUrl(baseUrl: URL, rel: string, bridgeUrl: string, sessionToken: string): URL;
+declare function createBridgeServer(ctx: BridgeContext): import("http").Server<typeof IncomingMessage, typeof ServerResponse>;
+declare function listen(server: ReturnType<typeof createBridgeServer>, requestedPort: number): Promise<number>;
+export declare function editCommand(input: string | undefined, options?: EditOptions): Promise<void>;
+export declare const editCommandInternalsForTest: {
+    buildEditorUrl: typeof buildEditorUrl;
+    createBridgeServer: typeof createBridgeServer;
+    generateSessionToken: typeof generateSessionToken;
+    listen: typeof listen;
+    normalizeBaseUrl: typeof normalizeBaseUrl;
+    parsePort: typeof parsePort;
+    readRegisteredEditorBaseUrl: typeof readRegisteredEditorBaseUrl;
+    resolveEditorBaseUrl: typeof resolveEditorBaseUrl;
+};
+export {};