@wootsup/yt-builder-mcp 1.2.0 → 1.4.0

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

@@ -21,6 +21,52 @@ function stringify(value) {
         return String(value);
     }
 }
+/**
+ * F80 (2026-06-10): the size at/above which a JSON-document text body is
+ * split off into its own content block instead of carrying the in-band
+ * `[label @ host] ` site-prefix.
+ *
+ * Why a threshold rather than "all JSON": a tool host (Claude Code, …)
+ * spills only OVERSIZED tool results to a temp file. That file is read
+ * back with `jq`, so the bytes must be pure JSON — an in-band prefix
+ * corrupts the first line and breaks the parse (the observed F80
+ * friction on `page_get_layout`, a multi-kB layout dump). Small JSON
+ * envelopes (error results, single-element confirms, short lists) are
+ * NEVER dumped, so they keep the in-band prefix — which preserves the
+ * long-standing contract that `content[0].text` is the directly-parseable
+ * JSON for those results (141 error-matrix / handler tests depend on it).
+ *
+ * 8 kB is comfortably below any host's spill threshold yet above every
+ * small structured envelope this surface emits.
+ */
+export const SITE_PREFIX_JSON_SPLIT_THRESHOLD = 8 * 1024;
+/**
+ * Detect whether a text body is a PURE JSON DOCUMENT (object or array)
+ * LARGE enough that a host might spill it to a `jq`-read temp file.
+ * Tools like `page_get_layout` emit `jsonResult(data)` whose
+ * `content[0].text` IS the JSON payload; for a large layout that text
+ * lands in the dump verbatim, so an in-band `[label @ host] ` prefix
+ * would corrupt the first bytes.
+ *
+ * Only OBJECT / ARRAY documents qualify (a bare scalar like `"hello"`
+ * stays in-band). The cheap length + first-glyph pre-checks avoid a
+ * JSON.parse on every human-readable table on the hot path.
+ */
+function isLargeJsonDocumentText(text) {
+    if (text.length < SITE_PREFIX_JSON_SPLIT_THRESHOLD)
+        return false;
+    const trimmed = text.trimStart();
+    const first = trimmed.charAt(0);
+    if (first !== '{' && first !== '[')
+        return false;
+    try {
+        const parsed = JSON.parse(trimmed);
+        return parsed !== null && typeof parsed === 'object';
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * Convert any JSON-serializable value into the MCP content envelope
  * (2-space JSON). Wave G.6.4b: every payload is deep-walked through
@@ -66,15 +112,29 @@ export function errorResult(opts) {
  * Confirm-guard preview helper for destructive tools. Returns the
  * preview `ToolResult` when `confirm` is false; callers `return` it
  * before executing the destructive REST call.
+ *
+ * F131 (Wave 4a): the blocked-state result is now STRUCTURALLY distinct
+ * from a successful mutation. Previously the preview was a plain
+ * `jsonResult` with no `isError` — envelope-identical to a success — so a
+ * model that did not parse `preview:true` read "delete succeeded" and
+ * silently left the element in place (the dry-run / silent-no-op footgun
+ * class). Three redundant signals now make the block unmistakable:
+ *   1. result-level `isError: true` (hosts that only read the error flag),
+ *   2. body `applied: false` + `requires_confirmation: true` (structured
+ *      consumers),
+ *   3. a leading "NOT EXECUTED" line in the human-readable warning text
+ *      (models that skim prose).
  */
 export function confirmGuard(opts) {
     return jsonResult({
         preview: true,
-        warning: 'DESTRUCTIVE — Confirmation required',
+        applied: false,
+        requires_confirmation: true,
+        warning: `NOT EXECUTED — DESTRUCTIVE operation requires confirmation. The "${opts.operation}" call was BLOCKED and nothing was changed.`,
         operation: opts.operation,
         details: opts.details,
         instruction: 'Ask the user to confirm, then call again with `confirm: true`.',
-    });
+    }, { isError: true });
 }
 /**
  * Sanitise a single content item from a toolkit builder. Text items
@@ -158,11 +218,28 @@ export function withSiteMeta(result, site) {
     catch {
         host = site.url;
     }
-    const prefix = `[${displayLabel} @ ${host}] `;
+    // F178 (2026-06-12): when a call was routed via the PROCESS-WIDE
+    // default/override (i.e. the caller omitted `site_id`), append a
+    // ` · default` marker INSIDE the visible prefix so the human SEES the
+    // call was not isolated from concurrent `use_site` switches. An
+    // explicit `site_id` (or a legacy fixture without `resolvedVia`) gets
+    // the plain prefix.
+    const routedViaSharedDefault = site.resolvedVia === 'registry_default'
+        || site.resolvedVia === 'active_override';
+    const marker = routedViaSharedDefault ? ' · default' : '';
+    const prefix = `[${displayLabel} @ ${host}${marker}] `;
+    // `resolved_site_id` is stamped LÜCKENLOS on every site-bound result
+    // (it mirrors `site_id` but names the concept the agent reasons about
+    // — "which site did this call actually land on"). `resolved_via` is
+    // only stamped when known, so legacy fixtures add no noise.
     const meta = {
         site_id: site.id,
         site_url: site.url,
         platform: site.platform.kind,
+        resolved_site_id: site.id,
+        ...(site.resolvedVia !== undefined
+            ? { resolved_via: site.resolvedVia }
+            : {}),
     };
     // W12-R1.2 (A4-F2): site-awareness is the LOAD-BEARING surface for
     // Claude-Desktop users. When the wrapped result has no text content
@@ -172,10 +249,24 @@ export function withSiteMeta(result, site) {
     // text block so the prefix is ALWAYS the first visible glyph.
     // Trim the trailing space — a standalone prefix block reads better
     // without it.
+    //
+    // F80 (2026-06-10): the SAME synthetic-block path is taken when the
+    // first text body is a PURE JSON DOCUMENT (page_get_layout etc.).
+    // Concatenating the prefix in-band there yields `[label @ host] {...}`
+    // — not valid JSON — which corrupts the harness's file-dump of an
+    // oversized result and breaks `jq`. Routing JSON documents through the
+    // synthetic block keeps the JSON byte-pure while the human still sees
+    // the marker first. Human-readable text (tables / details / prose)
+    // keeps the in-band prefix unchanged.
     const firstItem = result.content[0];
+    const firstIsLargeJsonDoc = firstItem !== undefined
+        && firstItem.type === 'text'
+        && typeof firstItem.text === 'string'
+        && isLargeJsonDocumentText(firstItem.text);
     const needsSynthetic = result.content.length === 0
         || firstItem === undefined
-        || firstItem.type !== 'text';
+        || firstItem.type !== 'text'
+        || firstIsLargeJsonDoc;
     const newContent = needsSynthetic
         ? [
             { type: 'text', text: prefix.trimEnd() },

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

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

package/dist/update/update-check.d.ts

@@ -0,0 +1,56 @@
+/** Persisted throttle record: the latest version + when we last looked. */
+export interface UpdateCacheEntry {
+    readonly checkedAt: number;
+    readonly latest: string;
+}
+/** Injection seam — production uses a JSON file under ~/.yt-builder-mcp/. */
+export interface UpdateCacheStore {
+    read(): UpdateCacheEntry | null;
+    write(entry: UpdateCacheEntry): void;
+}
+export interface UpdateStatus {
+    readonly updateAvailable: boolean;
+    readonly current: string;
+    /** The latest version on the registry, or null when it could not be resolved. */
+    readonly latest: string | null;
+    /** True when the answer came from the throttle cache (no network this call). */
+    readonly fromCache: boolean;
+    /** Set (fail-silent) when a registry fetch was attempted and failed. */
+    readonly error?: string;
+}
+export interface CheckForUpdateOptions {
+    readonly currentVersion: string;
+    readonly packageName: string;
+    /** Defaults to {@link fetchLatestFromNpm}. Returns null on any failure. */
+    readonly fetchLatest?: (packageName: string) => Promise<string | null>;
+    /** Defaults to {@link fileUpdateCache}. */
+    readonly cache?: UpdateCacheStore;
+    /** Defaults to `Date.now()`. */
+    readonly now?: number;
+    /** Cache TTL in ms. Default 24h. */
+    readonly ttlMs?: number;
+    /** Registry fetch timeout in ms. Default 3000. */
+    readonly timeoutMs?: number;
+}
+/** Is `latest` strictly newer than `current`? Fail-closed on unparseable input. */
+export declare function isVersionNewer(latest: string, current: string): boolean;
+/**
+ * Default registry fetch: the abbreviated packument's `dist-tags.latest`.
+ * (The `/latest` single-version endpoint behaves inconsistently under the
+ * abbreviated accept header for scoped packages; the packument + dist-tags is
+ * the robust path and the smaller abbreviated response.)
+ */
+export declare function fetchLatestFromNpm(packageName: string, timeoutMs?: number): Promise<string | null>;
+/** Default cache: a JSON file under the user's home dir. Fail-silent on fs errors. */
+export declare const fileUpdateCache: UpdateCacheStore;
+/**
+ * Resolve whether a newer version is available, throttled by a cache TTL and
+ * fail-silent on every network/fs error. Never throws.
+ */
+export declare function checkForUpdate(options: CheckForUpdateOptions): Promise<UpdateStatus>;
+/**
+ * A one-line, actionable update notice for stderr / the diagnose tool, or null
+ * when no update is available.
+ */
+export declare function formatUpdateNotice(status: Pick<UpdateStatus, 'updateAvailable' | 'current' | 'latest'>): string | null;
+//# sourceMappingURL=update-check.d.ts.map

package/dist/update/update-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../../src/update/update-check.ts"],"names":[],"mappings":"AAKA,2EAA2E;AAC3E,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAC3B;AAED,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC7B,IAAI,IAAI,gBAAgB,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iFAAiF;IACjF,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gFAAgF;IAChF,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvE,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC,gCAAgC;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC/B;AAYD,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAcvE;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACpC,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,MAA2B,GACvC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsBxB;AAED,sFAAsF;AACtF,eAAO,MAAM,eAAe,EAAE,gBA2B7B,CAAC;AAMF;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,CA+B1F;AAsBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,iBAAiB,GAAG,SAAS,GAAG,QAAQ,CAAC,GAAG,MAAM,GAAG,IAAI,CAOtH"}

package/dist/update/update-check.js

@@ -0,0 +1,155 @@
+// packages/mcp/src/update/update-check.ts
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+const DEFAULT_TTL_MS = 24 * 60 * 60 * 1_000;
+const DEFAULT_TIMEOUT_MS = 3_000;
+/** Parse `x.y.z` (ignoring any `-prerelease`/`+build`) into a numeric triple. */
+function parseCore(version) {
+    const m = /^\s*v?(\d+)\.(\d+)\.(\d+)/.exec(version);
+    if (m === null)
+        return null;
+    return [Number(m[1]), Number(m[2]), Number(m[3])];
+}
+/** Is `latest` strictly newer than `current`? Fail-closed on unparseable input. */
+export function isVersionNewer(latest, current) {
+    const a = parseCore(latest);
+    const b = parseCore(current);
+    if (a === null || b === null)
+        return false;
+    const [a0, a1, a2] = a;
+    const [b0, b1, b2] = b;
+    if (a0 !== b0)
+        return a0 > b0;
+    if (a1 !== b1)
+        return a1 > b1;
+    if (a2 !== b2)
+        return a2 > b2;
+    // Equal core → a release (latest, no prerelease) outranks a prerelease
+    // current (e.g. latest "1.3.0" vs current "1.3.0-beta.1").
+    const latestPre = latest.includes('-');
+    const currentPre = current.includes('-');
+    return currentPre && !latestPre;
+}
+/**
+ * Default registry fetch: the abbreviated packument's `dist-tags.latest`.
+ * (The `/latest` single-version endpoint behaves inconsistently under the
+ * abbreviated accept header for scoped packages; the packument + dist-tags is
+ * the robust path and the smaller abbreviated response.)
+ */
+export async function fetchLatestFromNpm(packageName, timeoutMs = DEFAULT_TIMEOUT_MS) {
+    const url = `https://registry.npmjs.org/${packageName.replace('/', '%2F')}`;
+    try {
+        const res = await fetch(url, {
+            signal: AbortSignal.timeout(timeoutMs),
+            headers: { accept: 'application/vnd.npm.install-v1+json' },
+        });
+        if (!res.ok)
+            return null;
+        const body = await res.json();
+        if (body !== null && typeof body === 'object' && 'dist-tags' in body) {
+            const tags = body['dist-tags'];
+            if (tags !== null && typeof tags === 'object' && 'latest' in tags) {
+                const latest = tags.latest;
+                if (typeof latest === 'string' && latest !== '')
+                    return latest;
+            }
+        }
+        return null;
+    }
+    catch {
+        // Offline / proxy / TLS / timeout — fail silent. The notifier is a
+        // courtesy, never a hard dependency.
+        return null;
+    }
+}
+/** Default cache: a JSON file under the user's home dir. Fail-silent on fs errors. */
+export const fileUpdateCache = {
+    read() {
+        try {
+            const raw = readFileSync(updateCachePath(), 'utf8');
+            const parsed = JSON.parse(raw);
+            if (parsed !== null &&
+                typeof parsed === 'object' &&
+                typeof parsed.checkedAt === 'number' &&
+                typeof parsed.latest === 'string') {
+                return parsed;
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    },
+    write(entry) {
+        try {
+            const path = updateCachePath();
+            mkdirSync(dirname(path), { recursive: true });
+            writeFileSync(path, JSON.stringify(entry), 'utf8');
+        }
+        catch {
+            // A non-writable home dir must not break startup.
+        }
+    },
+};
+function updateCachePath() {
+    return join(homedir(), '.yt-builder-mcp', 'update-check.json');
+}
+/**
+ * Resolve whether a newer version is available, throttled by a cache TTL and
+ * fail-silent on every network/fs error. Never throws.
+ */
+export async function checkForUpdate(options) {
+    const { currentVersion, packageName, fetchLatest = (pkg) => fetchLatestFromNpm(pkg, options.timeoutMs), cache = fileUpdateCache, now = Date.now(), ttlMs = DEFAULT_TTL_MS, } = options;
+    const cached = safeRead(cache);
+    if (cached !== null && now - cached.checkedAt < ttlMs) {
+        return verdict(currentVersion, cached.latest, true);
+    }
+    let latest = null;
+    let error;
+    try {
+        latest = await fetchLatest(packageName);
+    }
+    catch (err) {
+        error = err instanceof Error ? err.message : String(err);
+    }
+    if (latest === null) {
+        // Fall back to a (stale) cached value if we have one, else "unknown".
+        if (cached !== null)
+            return { ...verdict(currentVersion, cached.latest, true), error };
+        return { updateAvailable: false, current: currentVersion, latest: null, fromCache: false, error };
+    }
+    safeWrite(cache, { checkedAt: now, latest });
+    return verdict(currentVersion, latest, false);
+}
+function verdict(current, latest, fromCache) {
+    return { updateAvailable: isVersionNewer(latest, current), current, latest, fromCache };
+}
+function safeRead(cache) {
+    try {
+        return cache.read();
+    }
+    catch {
+        return null;
+    }
+}
+function safeWrite(cache, entry) {
+    try {
+        cache.write(entry);
+    }
+    catch {
+        /* ignore */
+    }
+}
+/**
+ * A one-line, actionable update notice for stderr / the diagnose tool, or null
+ * when no update is available.
+ */
+export function formatUpdateNotice(status) {
+    if (!status.updateAvailable || status.latest === null)
+        return null;
+    return (`[yt-builder-mcp] update available: ${status.current} → ${status.latest}. ` +
+        `Restart your AI client to pick it up (npx pulls @latest), or update a global install: ` +
+        `npm i -g @wootsup/yt-builder-mcp@latest.`);
+}
+//# sourceMappingURL=update-check.js.map

package/dist/update/update-check.js.map

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

package/manifest.json

@@ -2,7 +2,7 @@
     "dxt_version": "0.1",
     "name": "@wootsup/yt-builder-mcp",
     "display_name": "YT Builder MCP for YOOtheme Pro (unofficial)",
-    "version": "1.2.0",
+    "version": "1.4.0",
     "description": "Drive your YOOtheme Pro Page Builder programmatically from Claude, Cursor, Codex, Gemini and 5 other MCP-capable AI assistants — read layouts, edit settings, add elements, bind dynamic sources. Works on WordPress and Joomla 5/6. 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, on either WordPress or Joomla 5/6. 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",

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@wootsup/yt-builder-mcp",
-    "version": "1.2.0",
+    "version": "1.4.0",
     "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",
@@ -61,7 +61,9 @@
         "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"
+        "extract-tools": "node ./scripts/extract-tools.mjs",
+        "export:catalog": "node ./scripts/export-catalog.mjs",
+        "sync:catalog": "node ./scripts/sync-catalog.mjs"
     },
     "dependencies": {
         "@getimo/mcp-toolkit": "^1.1.1",
@@ -69,6 +71,7 @@
         "@clack/prompts": "^0.7.0",
         "pino": "^10.3.1",
         "proper-lockfile": "^4.1.2",
+        "undici": "^6.27.0",
         "zod": "^4.3.6"
     },
     "devDependencies": {