@wootsup/yt-builder-mcp 1.12.0 → 2.0.0

package/dist/sites/tools/sites-list.js.map

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

package/dist/sites/tools/sites-overview.d.ts

@@ -0,0 +1,4 @@
+import { type ServedToolDefinition } from '../../tools/tool-builder.js';
+import type { ClientPool } from '../client-pool.js';
+export declare function buildSitesOverviewTool(pool: ClientPool): ServedToolDefinition;
+//# sourceMappingURL=sites-overview.d.ts.map

package/dist/sites/tools/sites-overview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sites-overview.d.ts","sourceRoot":"","sources":["../../../src/sites/tools/sites-overview.ts"],"names":[],"mappings":"AAgDA,OAAO,EAKH,KAAK,oBAAoB,EAC5B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAsIpD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,oBAAoB,CA+L7E"}

package/dist/sites/tools/sites-overview.js

@@ -0,0 +1,209 @@
+import { z } from 'zod';
+import { budgetedTableResult } from '../../tools/budgeted-table.js';
+import { RESPONSE_BUDGET } from '../../tools/response-budget.js';
+import { INCLUDE_META_SCHEMA, SITE_ID_SCHEMA } from '../../tools/shared-schemas.js';
+import { applyMaxChars, MAX_CHARS } from '../../tools/sparse-fields.js';
+import { defineTool, jsonResult, readOnly, structuredResult, } from '../../tools/tool-builder.js';
+import { probeSite } from '../probe.js';
+import { substitutedRegistryRefusal } from '../substituted-registry.js';
+import { unknownNameResult } from '../unknown-name-result.js';
+const SITE_OVERVIEW_ROW = z
+    .object({
+    site_id: z.string(),
+    url: z.string(),
+    platform: z.string(),
+    is_default: z.boolean(),
+    label: z.string().optional(),
+    reachable: z.boolean(),
+    bearer_valid: z.boolean(),
+    error: z.string().optional(),
+    pages_total: z.number().optional(),
+    pages_content: z.number().optional(),
+    pages_theme_template: z.number().optional(),
+    pages_error: z.string().optional(),
+})
+    .catchall(z.unknown());
+const SITES_OVERVIEW_OUTPUT_SCHEMA = z.object({
+    items: z.array(SITE_OVERVIEW_ROW),
+    total: z.number(),
+    reachable_total: z.number(),
+    default_site_id: z.string().nullable(),
+    config_problem: z
+        .string()
+        .optional()
+        .describe('Present only when a configured source (a sites file, or the ' +
+        'YTB_MCP_SITE_URL/YTB_MCP_BEARER_TOKEN pair) EXISTED but was rejected at ' +
+        'startup — as opposed to nothing being configured yet. Names the exact ' +
+        'rejection reason. Absent in every other case.'),
+    _meta: z.object({ tool_kind: z.string() }).passthrough().optional(),
+});
+const TABLE_COLUMNS = [
+    { key: 'site_id', label: 'SITE_ID', width: 20 },
+    { key: 'status', label: 'STATUS', width: 16 },
+    { key: 'platform', label: 'PLATFORM', width: 10 },
+    { key: 'pages', label: 'PAGES', width: 22 },
+    { key: 'url', label: 'URL', width: 34 },
+];
+const COMPACT_COLUMNS = [
+    { key: 'site_id', label: 'SITE_ID', width: 20 },
+    { key: 'status', label: 'STATUS', width: 16 },
+    { key: 'pages', label: 'PAGES', width: 22 },
+];
+function errorMessage(err) {
+    if (err instanceof Error)
+        return err.message;
+    if (typeof err === 'string')
+        return err;
+    return 'unknown error';
+}
+async function readPageCounts(client) {
+    try {
+        const data = await client.get('/pages?limit=1');
+        const out = {};
+        if (typeof data.total === 'number') {
+            out.pages_total = data.total;
+        }
+        else if (Array.isArray(data.pages)) {
+            out.pages_total = data.pages.length;
+        }
+        const totals = data.totals;
+        if (totals !== null && typeof totals === 'object') {
+            const t = totals;
+            if (typeof t.content === 'number' && typeof t.theme_template === 'number') {
+                out.pages_content = t.content;
+                out.pages_theme_template = t.theme_template;
+            }
+        }
+        return out;
+    }
+    catch (e) {
+        return { pages_error: errorMessage(e) };
+    }
+}
+export function buildSitesOverviewTool(pool) {
+    return defineTool({
+        name: 'yootheme_builder_sites_overview',
+        description: 'Every configured site in ONE call: reachability, Bearer validity and page counts ' +
+            'per site, probed in parallel. Replaces sites_list plus one sites_test and one ' +
+            'pages_list per site. A site that is down becomes a row with an `error`, never a ' +
+            'failed call. Pass `site_id` to narrow to one site; `include_pages:false` skips the ' +
+            'page read (one HTTP request per site less). The content/theme_template split is ' +
+            'absent on hosts that do not report it — never reported as zero.',
+        inputSchema: {
+            site_id: SITE_ID_SCHEMA,
+            include_pages: z
+                .boolean()
+                .default(true)
+                .describe('Read each site\'s page counts (one extra request per site, run in ' +
+                'parallel with the probe). false = connectivity only. Measured over a ' +
+                'four-site fleet on 2026-08-13: 841 ms with, 516 ms without.'),
+            max_chars: MAX_CHARS.describe('Cap (chars) on the text output; structuredContent stays complete. Whole rows '
+                + 'are dropped, never half a row, and the answer says how many. No '
+                + '`[site @ host] ` prefix is added, so delivery is at most this many chars. '
+                + 'Raising it stops helping at the limit your own client puts on a single tool '
+                + 'result, which this server cannot see. '
+                + 'Out of range, the cap that actually applied comes back as `max_chars`.'),
+            include_meta: INCLUDE_META_SCHEMA,
+        },
+        outputSchema: SITES_OVERVIEW_OUTPUT_SCHEMA,
+        annotations: readOnly('Sites — Fleet overview'),
+        handler: async ({ site_id, include_pages, max_chars, include_meta }) => {
+            const substituteProblem = pool.registry.configProblem;
+            if (site_id !== undefined
+                && pool.registry.sitesAreSubstituted
+                && substituteProblem !== null) {
+                return jsonResult(substitutedRegistryRefusal(site_id, substituteProblem), { isError: true });
+            }
+            const allRows = pool.registry.listForDisplay();
+            const rows = site_id === undefined
+                ? allRows
+                : allRows.filter((row) => row.site_id === site_id);
+            if (site_id !== undefined && rows.length === 0) {
+                return unknownNameResult({
+                    argument: 'site_id',
+                    value: site_id,
+                    available: allRows.map((row) => row.site_id),
+                    code: 'unknown_site',
+                    error: `No site is configured under site_id "${site_id}".`,
+                    hint: 'Call yootheme_builder_sites_overview with no arguments to see every '
+                        + 'configured site, or run the setup CLI to add this one.',
+                });
+            }
+            const lines = await Promise.all(rows.map(async (row) => {
+                const base = {
+                    site_id: row.site_id,
+                    url: row.url,
+                    platform: row.platform_resolved ?? row.platform_hint,
+                    is_default: row.is_default,
+                    ...(row.label !== undefined ? { label: row.label } : {}),
+                };
+                let client;
+                try {
+                    ({ client } = await pool.resolve(row.site_id));
+                }
+                catch (e) {
+                    return { ...base, reachable: false, bearer_valid: false, error: errorMessage(e) };
+                }
+                const [probe, pages] = await Promise.all([
+                    probeSite(client),
+                    include_pages ? readPageCounts(client) : Promise.resolve({}),
+                ]);
+                const failure = probe.plugin_error ?? probe.bearer_error;
+                return {
+                    ...base,
+                    reachable: probe.plugin_reachable,
+                    bearer_valid: probe.bearer_valid,
+                    ...(failure !== undefined ? { error: failure } : {}),
+                    ...pages,
+                };
+            }));
+            const reachableTotal = lines.filter((l) => l.reachable && l.bearer_valid).length;
+            const defaultSiteId = pool.registry.defaultSiteId();
+            const configProblem = pool.registry.configProblem;
+            const tableRows = lines.map((l) => ({
+                site_id: l.site_id,
+                status: l.reachable && l.bearer_valid ? 'ok' : l.reachable ? 'bearer' : 'unreachable',
+                platform: l.platform,
+                pages: describePages(l),
+                url: l.url,
+            }));
+            const columnKeys = new Set(TABLE_COLUMNS.map((c) => c.key));
+            const omittedFields = [
+                ...new Set(lines.flatMap((l) => Object.keys(l))),
+            ].filter((key) => !columnKeys.has(key));
+            const budget = max_chars ?? RESPONSE_BUDGET.BULKY;
+            const toolkitResult = budgetedTableResult(tableRows, {
+                columns: [...TABLE_COLUMNS],
+                compactColumns: [...COMPACT_COLUMNS],
+                header: (count) => `${String(count)} site${count === 1 ? '' : 's'}, ${String(reachableTotal)} fully reachable`
+                    + (defaultSiteId !== null ? ` (default: ${defaultSiteId})` : ' (no default configured)')
+                    + (configProblem !== null
+                        ? ' — a configured source was rejected at startup and is NOT in this list (see config_problem)'
+                        : ''),
+                footer: 'Diagnose one: yootheme_builder_sites_test({site_id: "<SITE_ID column>"}). '
+                    + 'List its pages: yootheme_builder_pages_list({site_id: "<SITE_ID column>"}).',
+                omittedFields,
+                includeMeta: include_meta,
+            }, budget);
+            return structuredResult(applyMaxChars(toolkitResult, max_chars), {
+                items: lines.map((l) => ({ ...l })),
+                total: lines.length,
+                reachable_total: reachableTotal,
+                default_site_id: defaultSiteId,
+                ...(configProblem !== null ? { config_problem: configProblem } : {}),
+                _meta: { tool_kind: 'registry' },
+            });
+        },
+    });
+}
+function describePages(line) {
+    if (line.pages_error !== undefined)
+        return '!';
+    if (line.pages_total === undefined)
+        return '—';
+    if (line.pages_content === undefined || line.pages_theme_template === undefined) {
+        return String(line.pages_total);
+    }
+    return `${String(line.pages_total)} (${String(line.pages_content)}+${String(line.pages_theme_template)})`;
+}
+//# sourceMappingURL=sites-overview.js.map

package/dist/sites/tools/sites-overview.js.map

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

package/dist/sites/tools/sites-test.d.ts

@@ -1,47 +1,4 @@
-/**
- * W7 — `yootheme_builder_sites_test` L1 tool.
- *
- * Targeted connectivity probe for ONE site_id: runs `/health` (no auth
- * required) + `/etag` (auth required) in parallel and returns a
- * structured `{plugin_reachable, bearer_valid, platform, ...}` block.
- *
- * Why `site_id` is REQUIRED here (not optional):
- *  - Every other tool in the registry treats `site_id` as an optional
- *    selector that falls back to the default. `sites_test` is the
- *    exception: its raison d'être is to verify ONE specific id, so the
- *    schema upgrades from `.optional()` to required. The W5
- *    SITE_ID_SCHEMA pin-test in `tests/tools/site-id-schema.test.ts`
- *    explicitly skips this tool from its "every tool's site_id is
- *    optional" loop — see the SITES_TEST_EXEMPT_FROM_OPTIONAL set there.
- *
- * Why the result wraps `withSiteMeta`:
- *  - Once `pool.resolve(site_id)` succeeds we DO have a resolved-site
- *    descriptor, so the text-prefix `[<label> @ <host>] ` is the same
- *    site-awareness signal a Maria-class user already sees on every
- *    other tool. The W6.2 wrapper handles both green AND red results
- *    uniformly (it just stamps; no behaviour difference).
- *
- * Failure modes mapped:
- *  - `UnknownSiteError` → structured error `code: 'unknown_site'` with
- *    `available[]` hint (via `resolveSiteOrError`).
- *  - `NoDefaultSiteError` → cannot fire here because site_id is required
- *    and validated by Zod before the handler runs; left in the helper
- *    for defense-in-depth.
- *  - `/health` rejects → `plugin_reachable: false` + error message.
- *  - `/etag` 401/403 → `plugin_reachable: true` + `bearer_valid: false`.
- *  - `/etag` other reject → `plugin_reachable: true` + `bearer_valid:
- *    false` + raw error.
- *
- * @license MIT
- */
-import { type AnyToolDefinition } from '../../tools/tool-builder.js';
+import { type ServedToolDefinition } from '../../tools/tool-builder.js';
 import type { ClientPool } from '../client-pool.js';
-/**
- * Build the W7 `yootheme_builder_sites_test` tool.
- *
- * Signature accepts the {@link ClientPool} directly (no separate
- * registry param) — `pool.resolve(site_id)` is the single source of
- * truth and carries the registry inside.
- */
-export declare function buildSitesTestTool(pool: ClientPool): AnyToolDefinition;
+export declare function buildSitesTestTool(pool: ClientPool): ServedToolDefinition;
 //# sourceMappingURL=sites-test.d.ts.map

package/dist/sites/tools/sites-test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sites-test.d.ts","sourceRoot":"","sources":["../../../src/sites/tools/sites-test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAQH,OAAO,EAKH,KAAK,iBAAiB,EACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AA2BpD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,CA0DtE"}
+{"version":3,"file":"sites-test.d.ts","sourceRoot":"","sources":["../../../src/sites/tools/sites-test.ts"],"names":[],"mappings":"AA2CA,OAAO,EAKH,KAAK,oBAAoB,EAC5B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAkCpD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,oBAAoB,CA0DzE"}

package/dist/sites/tools/sites-test.js

@@ -1,39 +1,3 @@
-/**
- * W7 — `yootheme_builder_sites_test` L1 tool.
- *
- * Targeted connectivity probe for ONE site_id: runs `/health` (no auth
- * required) + `/etag` (auth required) in parallel and returns a
- * structured `{plugin_reachable, bearer_valid, platform, ...}` block.
- *
- * Why `site_id` is REQUIRED here (not optional):
- *  - Every other tool in the registry treats `site_id` as an optional
- *    selector that falls back to the default. `sites_test` is the
- *    exception: its raison d'être is to verify ONE specific id, so the
- *    schema upgrades from `.optional()` to required. The W5
- *    SITE_ID_SCHEMA pin-test in `tests/tools/site-id-schema.test.ts`
- *    explicitly skips this tool from its "every tool's site_id is
- *    optional" loop — see the SITES_TEST_EXEMPT_FROM_OPTIONAL set there.
- *
- * Why the result wraps `withSiteMeta`:
- *  - Once `pool.resolve(site_id)` succeeds we DO have a resolved-site
- *    descriptor, so the text-prefix `[<label> @ <host>] ` is the same
- *    site-awareness signal a Maria-class user already sees on every
- *    other tool. The W6.2 wrapper handles both green AND red results
- *    uniformly (it just stamps; no behaviour difference).
- *
- * Failure modes mapped:
- *  - `UnknownSiteError` → structured error `code: 'unknown_site'` with
- *    `available[]` hint (via `resolveSiteOrError`).
- *  - `NoDefaultSiteError` → cannot fire here because site_id is required
- *    and validated by Zod before the handler runs; left in the helper
- *    for defense-in-depth.
- *  - `/health` rejects → `plugin_reachable: false` + error message.
- *  - `/etag` 401/403 → `plugin_reachable: true` + `bearer_valid: false`.
- *  - `/etag` other reject → `plugin_reachable: true` + `bearer_valid:
- *    false` + raw error.
- *
- * @license MIT
- */
 import { detailResult } from '@getimo/mcp-toolkit';
 import { z } from 'zod';
 import { resolveSiteOrError, } from '../../tools/pool-resolve-helper.js';
@@ -50,13 +14,6 @@ const SITES_TEST_OUTPUT_SCHEMA = z.object({
     bearer_error: z.string().optional(),
     summary: z.string(),
 });
-/**
- * Build the W7 `yootheme_builder_sites_test` tool.
- *
- * Signature accepts the {@link ClientPool} directly (no separate
- * registry param) — `pool.resolve(site_id)` is the single source of
- * truth and carries the registry inside.
- */
 export function buildSitesTestTool(pool) {
     return defineTool({
         name: 'yootheme_builder_sites_test',
@@ -79,11 +36,6 @@ export function buildSitesTestTool(pool) {
             if (!r.ok)
                 return r.error;
             const { client: siteClient, site } = r;
-            // W12-R1.2: the parallel /health + /etag probe lives in
-            // sites/probe.ts so MCP-tool + CLI surfaces stay byte-for-byte
-            // in sync. The handler here only maps the structured probe
-            // result into the toolkit detail-card envelope and stamps
-            // site-awareness via withSiteMeta.
             const probe = await probeSite(siteClient);
             const checks = {
                 site_id: site.id,
@@ -108,13 +60,6 @@ export function buildSitesTestTool(pool) {
         },
     });
 }
-/**
- * Render a 2-group detail-card body from the structured `checks`. Group
- * 1 = identity (site_id/url/platform), Group 2 = probe results
- * (plugin_reachable + bearer_valid + etag_received + summary). Keeps the
- * shape stable across green / partial / red so MCP-host Detail-Card
- * renderers don't need to branch.
- */
 function buildTestDetail(checks) {
     const identityEntries = [
         { key: 'site_id', label: 'Site ID', value: checks.site_id, format: 'badge' },

package/dist/sites/tools/sites-test.js.map

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

package/dist/sites/tools/use-site.d.ts

@@ -1,47 +1,4 @@
-/**
- * Phase 3 — `yootheme_builder_use_site` L1 tool.
- *
- * Runtime active-site SWITCH. The multi-site analogue of api-mapper's
- * `apimapper_use_profile`: it changes which configured site subsequent
- * tool calls target by default, then (unless `probe: false`) verifies
- * the new site is reachable.
- *
- * Why a tool (and not just the `site_id` param on every call):
- *  - Maria-the-Claude-Desktop-user works in long conversations against
- *    ONE client site at a time. Re-passing `site_id` on every call is
- *    error-prone. `sites_list` + `use_site` mirror the
- *    `list_profiles` + `use_profile` flow she already knows from
- *    api-mapper: discover, switch once, then work.
- *
- * How it reuses the existing engine (NO new multi-site machinery):
- *  - The {@link SiteRegistry} stays immutable; the switch moves the
- *    {@link ClientPool}'s in-memory active-site override
- *    (`setActiveSite`). `resolve(undefined)` consults that override
- *    before the registry default. Unknown id → `UnknownSiteError`,
- *    surfaced as a structured `code: 'unknown_site'` error via the
- *    shared `resolveSiteOrError` helper (so the wording matches every
- *    other site-bound tool). The pointer never moves on a bad switch.
- *  - The reachability check reuses {@link probeSite} (/health + /etag),
- *    the SAME probe `sites_test` and the CLI run.
- *
- * Soft-vs-hard contract (mirrors `apimapper_use_profile`):
- *  - An UNKNOWN site is a HARD error (pointer unchanged).
- *  - A reachable-but-degraded site (probe red) is a SOFT warning: the
- *    activation still succeeds and the pointer moves, because the user
- *    explicitly asked to switch — the probe is diagnostic, not a gate.
- *    `probe: false` skips the network round-trip entirely (offline
- *    activation).
- *
- * @license MIT
- */
-import { type AnyToolDefinition } from '../../tools/tool-builder.js';
+import { type ServedToolDefinition } from '../../tools/tool-builder.js';
 import type { ClientPool } from '../client-pool.js';
-/**
- * Build the Phase 3 `yootheme_builder_use_site` tool.
- *
- * Signature accepts the {@link ClientPool} directly — the switch lives
- * on the pool (`setActiveSite`), and `resolveSiteOrError(pool, site_id)`
- * validates the id + yields the `{client, site}` bundle for the probe.
- */
-export declare function buildUseSiteTool(pool: ClientPool): AnyToolDefinition;
+export declare function buildUseSiteTool(pool: ClientPool): ServedToolDefinition;
 //# sourceMappingURL=use-site.d.ts.map

package/dist/sites/tools/use-site.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-site.d.ts","sourceRoot":"","sources":["../../../src/sites/tools/use-site.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAKH,OAAO,EAKH,KAAK,iBAAiB,EACzB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAwCpD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,CAyGpE"}
+{"version":3,"file":"use-site.d.ts","sourceRoot":"","sources":["../../../src/sites/tools/use-site.ts"],"names":[],"mappings":"AAwCA,OAAO,EAKH,KAAK,oBAAoB,EAC5B,MAAM,6BAA6B,CAAC;AAIrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AA+CpD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,oBAAoB,CA2HvE"}

package/dist/sites/tools/use-site.js

@@ -1,43 +1,9 @@
-/**
- * Phase 3 — `yootheme_builder_use_site` L1 tool.
- *
- * Runtime active-site SWITCH. The multi-site analogue of api-mapper's
- * `apimapper_use_profile`: it changes which configured site subsequent
- * tool calls target by default, then (unless `probe: false`) verifies
- * the new site is reachable.
- *
- * Why a tool (and not just the `site_id` param on every call):
- *  - Maria-the-Claude-Desktop-user works in long conversations against
- *    ONE client site at a time. Re-passing `site_id` on every call is
- *    error-prone. `sites_list` + `use_site` mirror the
- *    `list_profiles` + `use_profile` flow she already knows from
- *    api-mapper: discover, switch once, then work.
- *
- * How it reuses the existing engine (NO new multi-site machinery):
- *  - The {@link SiteRegistry} stays immutable; the switch moves the
- *    {@link ClientPool}'s in-memory active-site override
- *    (`setActiveSite`). `resolve(undefined)` consults that override
- *    before the registry default. Unknown id → `UnknownSiteError`,
- *    surfaced as a structured `code: 'unknown_site'` error via the
- *    shared `resolveSiteOrError` helper (so the wording matches every
- *    other site-bound tool). The pointer never moves on a bad switch.
- *  - The reachability check reuses {@link probeSite} (/health + /etag),
- *    the SAME probe `sites_test` and the CLI run.
- *
- * Soft-vs-hard contract (mirrors `apimapper_use_profile`):
- *  - An UNKNOWN site is a HARD error (pointer unchanged).
- *  - A reachable-but-degraded site (probe red) is a SOFT warning: the
- *    activation still succeeds and the pointer moves, because the user
- *    explicitly asked to switch — the probe is diagnostic, not a gate.
- *    `probe: false` skips the network round-trip entirely (offline
- *    activation).
- *
- * @license MIT
- */
 import { detailResult } from '@getimo/mcp-toolkit';
 import { z } from 'zod';
 import { defineTool, mutating, structuredResult, withSiteMeta, } from '../../tools/tool-builder.js';
 import { resolveSiteOrError } from '../../tools/pool-resolve-helper.js';
+import { pluginFloorError, versionSkewNotice } from '../../compat-floor.js';
+import { PACKAGE_VERSION } from '../../package-version.js';
 import { probeSite } from '../probe.js';
 const USE_SITE_OUTPUT_SCHEMA = z.object({
     activated: z.boolean(),
@@ -56,42 +22,19 @@ const USE_SITE_OUTPUT_SCHEMA = z.object({
         .optional(),
     note: z.string().optional(),
     warnings: z.array(z.string()).optional(),
-    // F178: every switch echoes the process-wide-default caveat so the
-    // agent is reminded that concurrent clients of the same stdio server
-    // share this pointer.
     concurrency_warning: z.string().optional(),
 });
-/**
- * F178 — the constant caveat echoed on every `use_site` switch. The
- * active-site default lives in process memory (`ClientPool.activeOverride`)
- * and a single stdio server process is shared by every MCP client that
- * connected to it. So when client A switches, client B's NEXT call that
- * omits `site_id` silently inherits A's choice. The only isolation
- * guarantee is passing `site_id` explicitly per call.
- */
 const CONCURRENCY_WARNING = 'This sets a PROCESS-WIDE default: every concurrent client sharing this '
     + 'MCP server process inherits it on calls that omit `site_id`. For '
     + 'isolation between parallel agents, pass `site_id` explicitly on each '
     + 'tool call instead of relying on this shared switch.';
-/**
- * Build the Phase 3 `yootheme_builder_use_site` tool.
- *
- * Signature accepts the {@link ClientPool} directly — the switch lives
- * on the pool (`setActiveSite`), and `resolveSiteOrError(pool, site_id)`
- * validates the id + yields the `{client, site}` bundle for the probe.
- */
 export function buildUseSiteTool(pool) {
     return defineTool({
         name: 'yootheme_builder_use_site',
-        description: 'Switch the ACTIVE site for this multi-site session. After this call, ' +
-            'every tool that omits `site_id` targets the site you picked here. NOTE: ' +
-            'this default is PROCESS-WIDE — concurrent clients sharing this MCP server ' +
-            'inherit it; pass `site_id` per call for isolation between parallel agents. ' +
-            'Runs a /health + /etag probe by default; pass `probe: false` to switch ' +
-            'offline. A degraded site is a soft warning (the switch still happens). ' +
-            '`site_id` is REQUIRED. Keywords: switch/change/set active/target site, ' +
-            'select installation, use profile. Use yootheme_builder_sites_list first ' +
-            'to find IDs.',
+        description: 'Switch the ACTIVE site for this session — subsequent calls that omit `site_id` ' +
+            'target it. NOTE: this default is PROCESS-WIDE — concurrent clients sharing this ' +
+            'MCP server inherit it; pass `site_id` per call for isolation. Runs a /health + ' +
+            '/etag probe by default; `probe:false` switches offline. `site_id` is REQUIRED.',
         inputSchema: {
             site_id: z
                 .string()
@@ -110,20 +53,11 @@ export function buildUseSiteTool(pool) {
         outputSchema: USE_SITE_OUTPUT_SCHEMA,
         annotations: mutating('Sites — Switch active'),
         handler: async ({ site_id, probe = true }) => {
-            // 1. Validate the id through the shared resolver. Unknown /
-            //    no-default errors come back as structured ToolResults
-            //    (HARD error). The pointer has NOT moved yet, so a bad id
-            //    leaves the session on its previous active site.
             const r = await resolveSiteOrError(pool, site_id);
             if (!r.ok)
                 return r.error;
             const { client, site } = r;
-            // 2. Move the in-memory override. `setActiveSite` re-checks
-            //    the id exists (defense-in-depth) and throws
-            //    UnknownSiteError otherwise — but step 1 already
-            //    guaranteed it, so this is a no-throw in practice.
             pool.setActiveSite(site.id);
-            // 3. Offline path — skip the probe entirely.
             if (!probe) {
                 const payload = {
                     activated: true,
@@ -137,8 +71,6 @@ export function buildUseSiteTool(pool) {
                 const detail = detailResult({ ...buildUseSiteDetail(payload), includeMeta: false });
                 return withSiteMeta(structuredResult(detail, payload), site);
             }
-            // 4. Probe the newly-active site. A failing probe is a SOFT
-            //    warning — the switch already happened in step 2.
             const probeResult = await probeSite(client);
             const warnings = [];
             if (!(probeResult.plugin_reachable && probeResult.bearer_valid)) {
@@ -146,6 +78,19 @@ export function buildUseSiteTool(pool) {
                     `green: ${probeResult.summary} The active site still points here — ` +
                     'run yootheme_builder_sites_test for a detailed diagnosis.');
             }
+            if (probeResult.plugin_version !== undefined) {
+                const pairing = { plugin: probeResult.plugin_version, client: PACKAGE_VERSION };
+                const blocking = pluginFloorError(pairing);
+                if (blocking !== null) {
+                    warnings.push(`Switched to "${site.id}". ${blocking.message}`);
+                }
+                else {
+                    const skew = versionSkewNotice(pairing);
+                    if (skew !== null) {
+                        warnings.push(`Switched to "${site.id}". ${skew.message}`);
+                    }
+                }
+            }
             const payload = {
                 activated: true,
                 active_site_id: site.id,
@@ -171,10 +116,6 @@ export function buildUseSiteTool(pool) {
         },
     });
 }
-/**
- * Render a detail-card body for the switch result. Group 1 = the active
- * site, Group 2 = the probe outcome (omitted when probe was skipped).
- */
 function buildUseSiteDetail(payload) {
     const activeEntries = [
         { key: 'active_site_id', label: 'Active site', value: payload.active_site_id, format: 'badge' },
@@ -198,6 +139,16 @@ function buildUseSiteDetail(payload) {
             entries: [{ key: 'note', label: 'Note', value: payload.note }],
         });
     }
+    if (payload.warnings !== undefined && payload.warnings.length > 0) {
+        groups.push({
+            label: 'Warnings',
+            entries: payload.warnings.map((w, i) => ({
+                key: `warning_${i}`,
+                label: `Warning ${i + 1}`,
+                value: w,
+            })),
+        });
+    }
     return { title: 'YT Builder MCP — Switch Active Site', groups };
 }
 //# sourceMappingURL=use-site.js.map