@wootsup/yt-builder-mcp 0.2.0-alpha.2

package/dist/tools/tool-builder/results.js.map

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

package/dist/tools/tool-builder/types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * `tool-builder/types` — pure type declarations for the tool-definition
+ * system. Split from `tool-builder.ts` in Round-1.5 (replaces the
+ * Round-1 LoC-exception spec-amendment with a structural code-fix).
+ *
+ * @license MIT
+ */
+import type { ServerNotification } from '@modelcontextprotocol/sdk/types.js';
+import type { ZodRawShape, z } from 'zod';
+/**
+ * A content item the SDK accepts. Mirrors the SDK
+ * `CallToolResult.content[number]` union (text/image/resource). Tools
+ * in this server only emit text, but the toolkit's structured builders
+ * return the wider union, so the envelope-merger must accept it.
+ */
+export type ToolContent = {
+    type: string;
+    [key: string]: unknown;
+};
+/**
+ * MCP-compatible content envelope. Fields:
+ *  - `content`            — text blocks shown to the LLM.
+ *  - `isError`            — flag honoured by the SDK for error results.
+ *  - `_meta.ui`           — Rich-Card hints (toolkit structured-display
+ *                            protocol: data-table, detail, stats, error).
+ *  - `structuredContent`  — domain-typed payload validated against the
+ *                            tool's optional `outputSchema`.
+ */
+export interface ToolResult {
+    content: ToolContent[];
+    isError?: boolean;
+    _meta?: {
+        ui?: unknown;
+    } & Record<string, unknown>;
+    structuredContent?: Record<string, unknown>;
+}
+export interface ToolAnnotations {
+    readonly title?: string;
+    /** Tool does not mutate state. */
+    readonly readOnlyHint?: boolean;
+    /** Tool may delete or otherwise destroy state. */
+    readonly destructiveHint?: boolean;
+    /** Tool talks to a system outside the host process. */
+    readonly openWorldHint?: boolean;
+    /** Identical invocations have identical effects (PUT-style). */
+    readonly idempotentHint?: boolean;
+}
+/**
+ * Minimal MCP-handler `extra` surface used by Wave G.5 progress reports.
+ * Only `_meta.progressToken` and `sendNotification` are consumed; the
+ * toolkit's `createProgressReporter` is defined against this same
+ * minimal shape so we forward verbatim with no cast at the call site.
+ */
+export interface HandlerExtra {
+    readonly _meta?: {
+        progressToken?: string | number;
+    };
+    readonly sendNotification: (notification: ServerNotification) => Promise<void>;
+}
+export type ToolHandler<TSchema extends ZodRawShape> = (args: z.infer<z.ZodObject<TSchema>>, extra?: HandlerExtra) => Promise<ToolResult>;
+export interface ToolDefinition<TSchema extends ZodRawShape = ZodRawShape> {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: TSchema;
+    /**
+     * Optional Zod schema describing the `structuredContent` payload.
+     * Hosts that support MCP structured output validate responses
+     * against this schema. Set on migrated tools using
+     * `structuredResult` / `tableResult` / `detailResult` /
+     * `statsResult`; tools on `jsonResult` may omit it.
+     */
+    readonly outputSchema?: z.ZodTypeAny;
+    readonly annotations: ToolAnnotations;
+    readonly handler: ToolHandler<TSchema>;
+}
+/**
+ * Type-erased tool definition used by the aggregator and server. Tools
+ * carry their own runtime-typed handler internally — at the registry
+ * boundary we only need the metadata + an opaque handler.
+ */
+export type AnyToolDefinition = ToolDefinition<any>;
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/tool-builder/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/tool-builder/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,kDAAkD;IAClD,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,uDAAuD;IACvD,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,gEAAgE;IAChE,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACrC;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACrD,QAAQ,CAAC,gBAAgB,EAAE,CAAC,YAAY,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAClF;AAED,MAAM,MAAM,WAAW,CAAC,OAAO,SAAS,WAAW,IAAI,CACnD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,EACnC,KAAK,CAAC,EAAE,YAAY,KACnB,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzB,MAAM,WAAW,cAAc,CAAC,OAAO,SAAS,WAAW,GAAG,WAAW;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CAC1C;AAED;;;;GAIG;AAEH,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC"}

package/dist/tools/tool-builder/types.js

@@ -0,0 +1,9 @@
+/**
+ * `tool-builder/types` — pure type declarations for the tool-definition
+ * system. Split from `tool-builder.ts` in Round-1.5 (replaces the
+ * Round-1 LoC-exception spec-amendment with a structural code-fix).
+ *
+ * @license MIT
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/tool-builder/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/tool-builder/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/tools/tool-builder.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `tool-builder.ts` — backward-compat re-export barrel.
+ *
+ * The implementation was split into `tool-builder/{types,annotations,
+ * results,define}.ts` in Round-1.5 (replaces the Round-1 LoC-exception
+ * spec-amendment with a structural code-fix). All existing
+ * `./tool-builder.js` imports continue to work via this re-export.
+ *
+ * For new code, prefer importing from `./tool-builder/index.js` (or
+ * the specific submodule) — but the barrel here is the stable
+ * public-import path for the package's internal modules.
+ *
+ * @license MIT
+ */
+export * from './tool-builder/index.js';
+//# sourceMappingURL=tool-builder.d.ts.map

package/dist/tools/tool-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-builder.d.ts","sourceRoot":"","sources":["../../src/tools/tool-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,yBAAyB,CAAC"}

package/dist/tools/tool-builder.js

@@ -0,0 +1,16 @@
+/**
+ * `tool-builder.ts` — backward-compat re-export barrel.
+ *
+ * The implementation was split into `tool-builder/{types,annotations,
+ * results,define}.ts` in Round-1.5 (replaces the Round-1 LoC-exception
+ * spec-amendment with a structural code-fix). All existing
+ * `./tool-builder.js` imports continue to work via this re-export.
+ *
+ * For new code, prefer importing from `./tool-builder/index.js` (or
+ * the specific submodule) — but the barrel here is the stable
+ * public-import path for the package's internal modules.
+ *
+ * @license MIT
+ */
+export * from './tool-builder/index.js';
+//# sourceMappingURL=tool-builder.js.map

package/dist/tools/tool-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-builder.js","sourceRoot":"","sources":["../../src/tools/tool-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,yBAAyB,CAAC"}

package/manifest.json

@@ -0,0 +1,63 @@
+{
+    "dxt_version": "0.1",
+    "name": "@wootsup/yt-builder-mcp",
+    "display_name": "YT Builder MCP for YOOtheme Pro (unofficial)",
+    "version": "0.2.0-alpha.1",
+    "description": "Drive your page builder programmatically from Claude, Cursor, ChatGPT, Continue, Cline, or Roo Code — read layouts, edit settings, add elements, bind dynamic sources. Built for YOOtheme Pro 4.0+. Independent third-party project, not affiliated with YOOtheme GmbH.",
+    "long_description": "YT Builder MCP gives AI assistants a typed, scoped, and idempotent surface for your YOOtheme Pro page builder. Tools cover page discovery, layout inspection, element CRUD, source binding, and diagnostics. Bearer auth, optimistic locking via ETag, scope hierarchy (read < write < admin), and structured-error responses keep the agent safe and the workflow correct on first try. Independent third-party project — YOOtheme® is a registered trademark of YOOtheme GmbH (yootheme.com); YT Builder MCP is built by WootsUp (getimo productions) and is not affiliated with, endorsed by, or sponsored by YOOtheme.",
+    "icon": "icon.png",
+    "author": {
+        "name": "WootsUp",
+        "email": "hello@wootsup.com",
+        "url": "https://wootsup.com"
+    },
+    "homepage": "https://github.com/wootsup/yt-builder-mcp",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/wootsup/yt-builder-mcp"
+    },
+    "license": "MIT",
+    "keywords": [
+        "yootheme",
+        "yootheme-pro",
+        "wordpress",
+        "page-builder",
+        "mcp",
+        "model-context-protocol",
+        "ai-assistant",
+        "claude",
+        "cursor"
+    ],
+    "server": {
+        "type": "node",
+        "entry_point": "dist/index.js",
+        "mcp_config": {
+            "command": "node",
+            "args": ["dist/index.js"],
+            "env": {
+                "YTB_MCP_WP_URL": "${user_config.YTB_MCP_WP_URL}",
+                "YTB_MCP_BEARER_TOKEN": "${user_config.YTB_MCP_BEARER_TOKEN}"
+            }
+        }
+    },
+    "user_config": [
+        {
+            "key": "YTB_MCP_WP_URL",
+            "label": "WordPress site URL",
+            "type": "string",
+            "required": true,
+            "description": "Base URL of the WordPress install (e.g. https://example.com). Without trailing slash. The MCP server appends `/wp-json/yt-builder-mcp/v1` internally."
+        },
+        {
+            "key": "YTB_MCP_BEARER_TOKEN",
+            "label": "Bearer key",
+            "type": "secret",
+            "required": true,
+            "description": "Bearer key generated by the YT Builder MCP plugin Settings page (wp-admin → Tools → \"YT Builder MCP\" → Bearer Keys → Generate New Key). The scope (read / write / admin) controls which tools work."
+        }
+    ],
+    "compatibility": {
+        "platforms": ["darwin", "win32", "linux"],
+        "node": ">=18.17.0"
+    }
+}

package/package.json

@@ -0,0 +1,81 @@
+{
+    "name": "@wootsup/yt-builder-mcp",
+    "version": "0.2.0-alpha.2",
+    "type": "module",
+    "description": "YT Builder MCP — drive your page builder from Claude, Cursor, Codex, Gemini and 5 other MCP-capable AI assistants. Built for YOOtheme Pro 4.0+. Independent third-party project, not affiliated with YOOtheme GmbH.",
+    "license": "MIT",
+    "author": "WootsUp <hello@wootsup.com>",
+    "homepage": "https://github.com/wootsup/yt-builder-mcp",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/wootsup/yt-builder-mcp.git",
+        "directory": "packages/mcp"
+    },
+    "bugs": "https://github.com/wootsup/yt-builder-mcp/issues",
+    "keywords": [
+        "mcp",
+        "model-context-protocol",
+        "yootheme",
+        "yootheme-pro",
+        "wordpress",
+        "claude",
+        "claude-code",
+        "cursor",
+        "codex-cli",
+        "gemini-cli",
+        "page-builder",
+        "ai-assistant",
+        "wootsup"
+    ],
+    "bin": {
+        "yt-builder-mcp": "bin/yt-builder-mcp.js"
+    },
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "files": [
+        "dist",
+        "bin",
+        "skills",
+        "manifest.json",
+        "icon.png",
+        "README.md",
+        "LICENSE"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "engines": {
+        "node": ">=18.17.0"
+    },
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsc --watch",
+        "test": "vitest run",
+        "test:watch": "vitest",
+        "test:coverage": "vitest run --coverage",
+        "test:grep-gate": "vitest run tests/auth/secrets-grep-gate.test.ts",
+        "typecheck": "tsc --noEmit",
+        "lint": "eslint src --max-warnings=0",
+        "setup": "node ./bin/yt-builder-mcp.js setup",
+        "install-skill": "node ./bin/yt-builder-mcp.js install-skill",
+        "build:dxt": "node ./scripts/build-dxt.js",
+        "extract-tools": "node ./scripts/extract-tools.mjs"
+    },
+    "dependencies": {
+        "@getimo/mcp-toolkit": "^1.1.1",
+        "@modelcontextprotocol/sdk": "^1.27.0",
+        "@clack/prompts": "^0.7.0",
+        "pino": "^10.3.1",
+        "zod": "^4.3.6"
+    },
+    "devDependencies": {
+        "@types/node": "^20.11.0",
+        "@typescript-eslint/eslint-plugin": "^8.0.0",
+        "@typescript-eslint/parser": "^8.0.0",
+        "@vitest/coverage-v8": "^1.4.0",
+        "eslint": "^9.0.0",
+        "typescript": "^5.4.0",
+        "typescript-eslint": "^8.0.0",
+        "vitest": "^1.4.0"
+    }
+}