@wootsup/yt-builder-mcp 1.11.0 → 2.0.0

package/dist/sites/tools/fetch-public-url.d.ts

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

package/dist/sites/tools/fetch-public-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-public-url.d.ts","sourceRoot":"","sources":["../../../src/sites/tools/fetch-public-url.ts"],"names":[],"mappings":"AAkDA,OAAO,EAKH,KAAK,oBAAoB,EAE5B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAuFpD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,GAAG,oBAAoB,CA2N9E"}

package/dist/sites/tools/fetch-public-url.js

@@ -0,0 +1,231 @@
+import { detailResult } from '@getimo/mcp-toolkit';
+import { z } from 'zod';
+import { DEFAULT_EXCERPT_CHARS, MAX_EXCERPT_CHARS, fetchPublicPage, } from '../../net/public-fetch.js';
+import { resolveSiteOrError } from '../../tools/pool-resolve-helper.js';
+import { SITE_ID_SCHEMA } from '../../tools/shared-schemas.js';
+import { defineTool, readOnly, structuredResult, withSiteMeta, } from '../../tools/tool-builder.js';
+const OUTPUT_SCHEMA = z.object({
+    site_id: z.string(),
+    site_origin: z.string().nullable(),
+    requested_url: z.string(),
+    fetched_as: z.literal('anonymous_visitor'),
+    delivered: z.boolean(),
+    http_status: z.number().optional(),
+    http_ok: z.boolean().optional(),
+    content_type: z.string().nullable().optional(),
+    page_title: z.string().nullable().optional(),
+    html_bytes: z.number().optional(),
+    html_complete: z.boolean().optional(),
+    excerpt: z.string().optional(),
+    excerpt_chars: z.number().optional(),
+    excerpt_from: z.enum(['match', 'start']).optional(),
+    excerpt_is_partial: z.boolean().optional(),
+    expect: z.string().nullable().optional(),
+    expect_found: z.boolean().nullable().optional(),
+    expect_occurrences: z.number().nullable().optional(),
+    cache_verdict: z.enum(['hit', 'miss', 'bypass', 'unknown']).optional(),
+    cache_headers: z.record(z.string(), z.string()).optional(),
+    cache_note: z.string().optional(),
+    elapsed_ms: z.number().optional(),
+    code: z.string().optional(),
+    error: z.string().optional(),
+    redirect_target: z.string().optional(),
+    verdict: z.string(),
+});
+function verdictLine(args) {
+    if (!args.ok) {
+        return `An anonymous visitor gets HTTP ${String(args.status)} — this page is NOT being served to the public.`;
+    }
+    const cacheSuffix = args.cacheVerdict === 'hit'
+        ? ' A cache served this answer, so it may predate the change — purge and re-check.'
+        : '';
+    if (args.expect === null) {
+        return `An anonymous visitor gets HTTP 200.${cacheSuffix} No expected text was given, so nothing about the CONTENT was checked.`;
+    }
+    return args.expectFound === true
+        ? `An anonymous visitor gets HTTP 200 and the expected text IS in the delivered HTML.${cacheSuffix}`
+        : `An anonymous visitor gets HTTP 200 but the expected text is NOT in the delivered HTML — the change has not reached visitors.${cacheSuffix}`;
+}
+function detailFor(title, groups) {
+    return { title, groups };
+}
+export function buildFetchPublicUrlTool(pool) {
+    return defineTool({
+        name: 'yootheme_builder_fetch_public_url',
+        description: 'The independent proof a publish reached visitors: fetches a page of the CONFIGURED ' +
+            'site over the public network as an ANONYMOUS visitor — no login/cookies/Bearer — and ' +
+            'reports http_status, page_title, an EXCERPT (never the whole document), html_bytes, ' +
+            'and whether a cache served it (cache_verdict; "unknown" means no header said, NOT ' +
+            'that nothing cached, and no re-fetch settles it — purge the cache instead). With ' +
+            '`expect` it answers expect_found true/false. Refuses any address outside the ' +
+            'configured site and never follows a redirect off it — an unrestricted fetcher is an ' +
+            'open proxy. Get the url from `frontend_url` (pages_list / page_publish). Searches the ' +
+            'WHOLE page (header, menu, footer too); a hit is no proof of THIS layout. ' +
+            'render_preview renders ONLY that layout tree, never the theme wrapper.',
+        inputSchema: {
+            site_id: SITE_ID_SCHEMA,
+            url: z
+                .string()
+                .min(1)
+                .describe('Absolute public URL to fetch (e.g. "https://example.com/about/"). MUST be on ' +
+                'the configured site — any other origin is refused. Take it verbatim from ' +
+                '`frontend_url` (pages_list, pages_create, page_publish).'),
+            expect: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Optional text the delivered HTML must contain. Matched CASE-SENSITIVELY ' +
+                'against the RAW, un-decoded markup — pass raw HTML, not escaped text ' +
+                '(search for "<h1", not "&lt;h1"). Adds expect_found + expect_occurrences, ' +
+                'and centres the excerpt on the first hit.'),
+            max_excerpt_chars: z
+                .number()
+                .int()
+                .min(100)
+                .max(MAX_EXCERPT_CHARS)
+                .optional()
+                .describe(`Excerpt size in characters (100-${String(MAX_EXCERPT_CHARS)}, default ` +
+                `${String(DEFAULT_EXCERPT_CHARS)}). The full delivered size is always ` +
+                'reported as html_bytes; a page runs well over 100 000 bytes, so the ' +
+                'document itself is never returned.'),
+        },
+        outputSchema: OUTPUT_SCHEMA,
+        annotations: { ...readOnly('Fetch the public page'), openWorldHint: true },
+        handler: async ({ site_id, url, expect, max_excerpt_chars }) => {
+            const r = await resolveSiteOrError(pool, site_id);
+            if (!r.ok)
+                return r.error;
+            const { site } = r;
+            const result = await fetchPublicPage({
+                requestedUrl: url,
+                configuredSiteUrl: site.url,
+                expect,
+                excerptChars: max_excerpt_chars,
+            });
+            if (result.outcome === 'refused') {
+                const verdict = `Refused before any request was sent: ${result.message}`;
+                return withSiteMeta({
+                    ...structuredResult(detailResult({
+                        ...detailFor('Public page — address refused', [
+                            {
+                                label: 'Refusal',
+                                entries: [
+                                    { key: 'requested_url', label: 'Requested URL', value: url, format: 'code' },
+                                    { key: 'site_origin', label: 'Allowed origin', value: result.siteOrigin ?? '(unparseable)', format: 'code' },
+                                    { key: 'code', label: 'Reason', value: result.code, format: 'badge' },
+                                    { key: 'error', label: 'Detail', value: result.message },
+                                ],
+                            },
+                        ]),
+                        includeMeta: false,
+                    }), {
+                        site_id: site.id,
+                        site_origin: result.siteOrigin,
+                        requested_url: url,
+                        fetched_as: 'anonymous_visitor',
+                        delivered: false,
+                        code: result.code,
+                        error: result.message,
+                        verdict,
+                    }),
+                    isError: true,
+                }, site);
+            }
+            if (result.outcome === 'failed') {
+                const verdict = `No answer was obtained: ${result.message}`;
+                return withSiteMeta({
+                    ...structuredResult(detailResult({
+                        ...detailFor('Public page — not fetched', [
+                            {
+                                label: 'Failure',
+                                entries: [
+                                    { key: 'requested_url', label: 'Requested URL', value: url, format: 'code' },
+                                    { key: 'code', label: 'Reason', value: result.code, format: 'badge' },
+                                    { key: 'error', label: 'Detail', value: result.message },
+                                ],
+                            },
+                        ]),
+                        includeMeta: false,
+                    }), {
+                        site_id: site.id,
+                        site_origin: result.siteOrigin,
+                        requested_url: url,
+                        fetched_as: 'anonymous_visitor',
+                        delivered: false,
+                        code: result.code,
+                        error: result.message,
+                        ...(result.redirectTarget !== undefined ? { redirect_target: result.redirectTarget } : {}),
+                        verdict,
+                    }),
+                    isError: true,
+                }, site);
+            }
+            const verdict = verdictLine({
+                status: result.httpStatus,
+                ok: result.ok,
+                expect: expect ?? null,
+                expectFound: result.expectFound,
+                cacheVerdict: result.cache.verdict,
+            });
+            const structured = {
+                site_id: site.id,
+                site_origin: result.siteOrigin,
+                requested_url: url,
+                fetched_as: 'anonymous_visitor',
+                delivered: true,
+                http_status: result.httpStatus,
+                http_ok: result.ok,
+                content_type: result.contentType,
+                page_title: result.title,
+                html_bytes: result.htmlBytes,
+                html_complete: result.bodyComplete,
+                excerpt: result.excerpt.text,
+                excerpt_chars: result.excerpt.text.length,
+                excerpt_from: result.excerpt.from,
+                excerpt_is_partial: result.excerpt.truncated,
+                expect: expect ?? null,
+                expect_found: result.expectFound,
+                expect_occurrences: result.expectOccurrences,
+                cache_verdict: result.cache.verdict,
+                cache_headers: result.cache.headers,
+                cache_note: result.cache.note,
+                elapsed_ms: result.elapsedMs,
+                verdict,
+            };
+            const entries = [
+                { key: 'verdict', label: 'Verdict', value: verdict },
+                { key: 'http_status', label: 'HTTP status', value: result.httpStatus, format: 'badge' },
+                { key: 'page_title', label: 'Page title', value: result.title ?? '(none)' },
+                { key: 'html_bytes', label: 'Delivered bytes', value: result.htmlBytes },
+                { key: 'cache_verdict', label: 'Cache', value: result.cache.verdict, format: 'badge' },
+                { key: 'cache_note', label: 'Cache note', value: result.cache.note },
+            ];
+            if (expect !== undefined) {
+                entries.push({
+                    key: 'expect_found',
+                    label: `Expected text found (${String(result.expectOccurrences ?? 0)}×)`,
+                    value: result.expectFound === true,
+                    format: 'boolean',
+                });
+            }
+            return withSiteMeta(structuredResult(detailResult({
+                ...detailFor('Public page — as an anonymous visitor', [
+                    { label: 'Answer', entries },
+                    {
+                        label: 'Excerpt',
+                        entries: [
+                            {
+                                key: 'excerpt',
+                                label: `Excerpt (${result.excerpt.from}, ${String(result.excerpt.text.length)} chars${result.excerpt.truncated ? ', partial' : ''})`,
+                                value: result.excerpt.text,
+                                format: 'code',
+                            },
+                        ],
+                    },
+                ]),
+                includeMeta: false,
+            }), structured), site);
+        },
+    });
+}
+//# sourceMappingURL=fetch-public-url.js.map

package/dist/sites/tools/fetch-public-url.js.map

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

package/dist/sites/tools/index.d.ts

@@ -1,28 +1,4 @@
-/**
- * W7 — sites/tools/ aggregator.
- *
- * Returns the two L1 platform-agnostic site-management tools:
- *   - `yootheme_builder_sites_list`   (registry inspection — no REST)
- *   - `yootheme_builder_sites_test`   (per-site connectivity probe)
- *
- * Wired into `buildAllTools(pool)` — the aggregator pulls the
- * read-only `SiteRegistry` off the pool internally so callers thread
- * only the pool through, never the registry separately.
- *
- * @license MIT
- */
 import type { ClientPool } from '../client-pool.js';
-import type { AnyToolDefinition } from '../../tools/tool-builder.js';
-/**
- * Build the W7 sites-management tool pair. The pool's read-only
- * `registry` accessor feeds `buildSitesListTool` (which never resolves
- * a bearer); the pool itself feeds `buildSitesTestTool` (which calls
- * `pool.resolve(site_id)` to obtain a `RestClient`).
- *
- * W12-R1.3 (A1-L-01): single-arg signature — reading the registry off
- * the pool inside this aggregator removes the only call-site that
- * needed the pool's `registry` getter, so the getter can stay
- * `@internal`.
- */
-export declare function buildSitesTools(pool: ClientPool): readonly AnyToolDefinition[];
+import type { ServedToolDefinition } from '../../tools/tool-builder.js';
+export declare function buildSitesTools(pool: ClientPool): readonly ServedToolDefinition[];
 //# sourceMappingURL=index.d.ts.map

package/dist/sites/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sites/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAMrE;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC3B,IAAI,EAAE,UAAU,GACjB,SAAS,iBAAiB,EAAE,CAS9B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sites/tools/index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAmBxE,wBAAgB,eAAe,CAC3B,IAAI,EAAE,UAAU,GACjB,SAAS,oBAAoB,EAAE,CA4BjC"}

package/dist/sites/tools/index.js

@@ -1,38 +1,15 @@
-/**
- * W7 — sites/tools/ aggregator.
- *
- * Returns the two L1 platform-agnostic site-management tools:
- *   - `yootheme_builder_sites_list`   (registry inspection — no REST)
- *   - `yootheme_builder_sites_test`   (per-site connectivity probe)
- *
- * Wired into `buildAllTools(pool)` — the aggregator pulls the
- * read-only `SiteRegistry` off the pool internally so callers thread
- * only the pool through, never the registry separately.
- *
- * @license MIT
- */
+import { buildFetchPublicUrlTool } from './fetch-public-url.js';
 import { buildSitesListTool } from './sites-list.js';
+import { buildSitesOverviewTool } from './sites-overview.js';
 import { buildSitesTestTool } from './sites-test.js';
 import { buildUseSiteTool } from './use-site.js';
-/**
- * Build the W7 sites-management tool pair. The pool's read-only
- * `registry` accessor feeds `buildSitesListTool` (which never resolves
- * a bearer); the pool itself feeds `buildSitesTestTool` (which calls
- * `pool.resolve(site_id)` to obtain a `RestClient`).
- *
- * W12-R1.3 (A1-L-01): single-arg signature — reading the registry off
- * the pool inside this aggregator removes the only call-site that
- * needed the pool's `registry` getter, so the getter can stay
- * `@internal`.
- */
 export function buildSitesTools(pool) {
     return [
-        buildSitesListTool(pool.registry),
+        buildSitesListTool(pool),
         buildSitesTestTool(pool),
-        // Phase 3 — runtime active-site switch (mirrors api-mapper's
-        // `apimapper_use_profile`). Reuses the pool's in-memory active-
-        // site override; never rebuilds the multi-site engine.
         buildUseSiteTool(pool),
+        buildSitesOverviewTool(pool),
+        buildFetchPublicUrlTool(pool),
     ];
 }
 //# sourceMappingURL=index.js.map

package/dist/sites/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sites/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC3B,IAAgB;IAEhB,OAAO;QACH,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC;QACjC,kBAAkB,CAAC,IAAI,CAAC;QACxB,6DAA6D;QAC7D,gEAAgE;QAChE,uDAAuD;QACvD,gBAAgB,CAAC,IAAI,CAAC;KACzB,CAAC;AACN,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sites/tools/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAajD,MAAM,UAAU,eAAe,CAC3B,IAAgB;IAEhB,OAAO;QACH,kBAAkB,CAAC,IAAI,CAAC;QACxB,kBAAkB,CAAC,IAAI,CAAC;QAIxB,gBAAgB,CAAC,IAAI,CAAC;QAKtB,sBAAsB,CAAC,IAAI,CAAC;QAc5B,uBAAuB,CAAC,IAAI,CAAC;KAChC,CAAC;AACN,CAAC"}

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

@@ -1,48 +1,4 @@
-/**
- * W7 — `yootheme_builder_sites_list` L1 tool.
- *
- * Platform-agnostic registry inspection: lists the in-process
- * {@link SiteRegistry} as a tabular result so an agent (or a Maria-class
- * Claude-Desktop user) can discover which site_ids are wired into this
- * MCP server WITHOUT a network round-trip.
- *
- * Why it does NOT call `pool.resolve()`:
- *  - The tool reads the registry verbatim and never touches bearers, the
- *    secret-resolver, or any HTTP endpoint. Resolving through the pool
- *    would force a default-site requirement that is exactly the
- *    bootstrap failure-mode the tool is meant to diagnose ("I added
- *    sites but forgot to mark a default"). For the same reason the
- *    handler intentionally skips `withSiteMeta` — there is no resolved
- *    site to stamp; instead we emit a `structuredContent._meta.tool_kind
- *    = 'registry'` marker so MCP hosts can route the result through a
- *    registry-aware UI if/when they grow one.
- *
- * Why `site_id` is exposed but unused:
- *  - The W5 SITE_ID_SCHEMA pin requires EVERY tool to expose the
- *    optional `site_id` field so legacy/scripted callers never trip a
- *    Zod parse on an extra-property. The W12-R1.3 DESCRIPTION_SUFFIX_EXEMPT
- *    list opts this tool out of the canonical description suffix
- *    because "operates on the default site" would imply per-row
- *    filtering that the handler does not perform.
- *
- * W12-R1.3 (A2-L4): `bearer_source` was previously projected into the
- *  output row + table column. Even though it carried only the literal
- *  `'plain'` / `'op'`, the `sites://current` resource already omits
- *  this field (see ADR rationale in server.ts) and the tool surface
- *  should match for cross-surface consistency. The field is dropped
- *  from both the structured row AND the table column.
- *
- * @license MIT
- */
-import type { SiteRegistry } from '../registry.js';
-import { type AnyToolDefinition } from '../../tools/tool-builder.js';
-/**
- * Build the W7 `yootheme_builder_sites_list` tool.
- *
- * Signature accepts the {@link SiteRegistry} directly — unlike other
- * tool-builders, it does NOT need the {@link ClientPool} because it
- * never resolves a site. Callers wire `buildSitesListTool(pool.registry)`
- * from the W7 aggregator (`src/sites/tools/index.ts`).
- */
-export declare function buildSitesListTool(registry: SiteRegistry): AnyToolDefinition;
+import type { ClientPool } from '../client-pool.js';
+import { type ServedToolDefinition } from '../../tools/tool-builder.js';
+export declare function buildSitesListTool(pool: ClientPool): ServedToolDefinition;
 //# sourceMappingURL=sites-list.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sites-list.d.ts","sourceRoot":"","sources":["../../../src/sites/tools/sites-list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAIH,KAAK,iBAAiB,EACzB,MAAM,6BAA6B,CAAC;AAsDrC;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,iBAAiB,CAsE5E"}
+{"version":3,"file":"sites-list.d.ts","sourceRoot":"","sources":["../../../src/sites/tools/sites-list.ts"],"names":[],"mappings":"AAwCA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAIH,KAAK,oBAAoB,EAC5B,MAAM,6BAA6B,CAAC;AAqGrC,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,oBAAoB,CA0JzE"}

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

@@ -1,51 +1,13 @@
-/**
- * W7 — `yootheme_builder_sites_list` L1 tool.
- *
- * Platform-agnostic registry inspection: lists the in-process
- * {@link SiteRegistry} as a tabular result so an agent (or a Maria-class
- * Claude-Desktop user) can discover which site_ids are wired into this
- * MCP server WITHOUT a network round-trip.
- *
- * Why it does NOT call `pool.resolve()`:
- *  - The tool reads the registry verbatim and never touches bearers, the
- *    secret-resolver, or any HTTP endpoint. Resolving through the pool
- *    would force a default-site requirement that is exactly the
- *    bootstrap failure-mode the tool is meant to diagnose ("I added
- *    sites but forgot to mark a default"). For the same reason the
- *    handler intentionally skips `withSiteMeta` — there is no resolved
- *    site to stamp; instead we emit a `structuredContent._meta.tool_kind
- *    = 'registry'` marker so MCP hosts can route the result through a
- *    registry-aware UI if/when they grow one.
- *
- * Why `site_id` is exposed but unused:
- *  - The W5 SITE_ID_SCHEMA pin requires EVERY tool to expose the
- *    optional `site_id` field so legacy/scripted callers never trip a
- *    Zod parse on an extra-property. The W12-R1.3 DESCRIPTION_SUFFIX_EXEMPT
- *    list opts this tool out of the canonical description suffix
- *    because "operates on the default site" would imply per-row
- *    filtering that the handler does not perform.
- *
- * W12-R1.3 (A2-L4): `bearer_source` was previously projected into the
- *  output row + table column. Even though it carried only the literal
- *  `'plain'` / `'op'`, the `sites://current` resource already omits
- *  this field (see ADR rationale in server.ts) and the tool surface
- *  should match for cross-surface consistency. The field is dropped
- *  from both the structured row AND the table column.
- *
- * @license MIT
- */
 import { tableResult } from '@getimo/mcp-toolkit';
 import { z } from 'zod';
-import { SITE_ID_SCHEMA } from '../../tools/shared-schemas.js';
+import { INCLUDE_META_SCHEMA, SITE_ID_SCHEMA } from '../../tools/shared-schemas.js';
 import { defineTool, readOnly, structuredResult, } from '../../tools/tool-builder.js';
+import { unknownNameResult } from '../unknown-name-result.js';
 const SITES_LIST_OUTPUT_SCHEMA = z.object({
     items: z.array(z.object({
         site_id: z.string(),
         url: z.string(),
         platform_hint: z.enum(['wordpress', 'joomla', 'auto']),
-        // ELEMENT_WRITE-24: platform_resolved is the platform CONFIRMED by a
-        // successful resolve — ABSENT until the site has resolved at least
-        // once (until then only platform_hint, the pre-resolve guess, exists).
         platform_resolved: z
             .enum(['wordpress', 'joomla'])
             .optional()
@@ -53,14 +15,17 @@ const SITES_LIST_OUTPUT_SCHEMA = z.object({
             'resolves at least once — "not yet probed", not "unknown". Before ' +
             'that only `platform_hint` (the pre-resolve guess) is present.'),
         is_default: z.boolean(),
+        is_active: z.boolean(),
         label: z.string().optional(),
     })),
     total: z.number(),
-    // ELEMENT_WRITE-24 + SOURCES_BINDING-30: the CONFIGURED default site — the
-    // write target when a tool call OMITS site_id. Distinct from diagnose's
-    // `process_default_site_id` (the resolved active default for the running
-    // process): THIS is the statically-configured default; that is what a call
-    // actually resolved to. null when no default is configured.
+    active_site_id: z
+        .string()
+        .nullable()
+        .describe('The site a call that omits site_id targets RIGHT NOW because ' +
+        'yootheme_builder_use_site switched this server process to it. null when ' +
+        'no switch happened, in which case default_site_id is the target. ' +
+        'PROCESS-WIDE: every client sharing this MCP server inherits it.'),
     default_site_id: z
         .string()
         .nullable()
@@ -68,6 +33,13 @@ const SITES_LIST_OUTPUT_SCHEMA = z.object({
         'omits site_id. Distinct from diagnose\'s `process_default_site_id` ' +
         '(the resolved active default): this is the configured default, that ' +
         'is what a call resolved to. null when none is configured.'),
+    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(),
@@ -80,39 +52,46 @@ const TABLE_COLUMNS = [
     { key: 'url', label: 'URL', width: 36 },
     { key: 'platform', label: 'PLATFORM', width: 11 },
     { key: 'is_default', label: 'DEFAULT', width: 9 },
+    { key: 'is_active', label: 'ACTIVE', width: 8 },
     { key: 'label', label: 'LABEL', width: 24 },
 ];
-/**
- * Build the W7 `yootheme_builder_sites_list` tool.
- *
- * Signature accepts the {@link SiteRegistry} directly — unlike other
- * tool-builders, it does NOT need the {@link ClientPool} because it
- * never resolves a site. Callers wire `buildSitesListTool(pool.registry)`
- * from the W7 aggregator (`src/sites/tools/index.ts`).
- */
-export function buildSitesListTool(registry) {
+export function buildSitesListTool(pool) {
+    const registry = pool.registry;
     return defineTool({
         name: 'yootheme_builder_sites_list',
-        description: 'List all sites configured in this multi-site MCP installation. ' +
-            'Returns site_id + URL + platform (wordpress|joomla) + default flag per row. ' +
-            'CALL THIS FIRST when working with a fresh MCP connection to discover available ' +
-            'site_ids before targeting one with any other tool. Read-only, no REST calls. ' +
-            'Keywords: list sites, list connections, list installations, discover site_id, ' +
-            'available sites, configured sites, what sites exist, multi-site index. ' +
-            'The `default_site_id` is the write target when a call omits site_id. ' +
-            '(site_id is accepted for schema-uniformity but ignored by this tool.)',
+        description: 'List all sites configured in this multi-site MCP installation — site_id, URL, ' +
+            'platform, DEFAULT + ACTIVE flag per row. Call first to discover site_ids. ' +
+            'A call omitting site_id goes to `active_site_id` (set by use_site, process-wide) ' +
+            'else to `default_site_id`. Pass `site_id` to FILTER to one site; omit it for all. ' +
+            'IDs from any tool (layout_id, element ids, …) are PER-SITE, never global: the ' +
+            'same id can exist on a different site naming something else entirely. Always keep ' +
+            'an id paired with the site_id it came from.',
         inputSchema: {
             site_id: SITE_ID_SCHEMA,
+            include_meta: INCLUDE_META_SCHEMA,
         },
         outputSchema: SITES_LIST_OUTPUT_SCHEMA,
         annotations: readOnly('Sites — List configured'),
-        handler: async () => {
-            const rows = registry.listForDisplay();
+        handler: async ({ site_id, include_meta }) => {
+            const allRows = registry.listForDisplay();
             const defaultSiteId = registry.defaultSiteId();
-            // Map the registry row to a structured-content item with
-            // safe-to-render primitives ONLY (no bearer leakage). The
-            // `platform` projection collapses hint + resolved into a
-            // single display string so the table stays readable.
+            const activeSiteId = pool.activeSiteId();
+            const configProblem = registry.configProblem;
+            const substituted = registry.sitesAreSubstituted && configProblem !== null;
+            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_list with no arguments to see every configured '
+                        + 'site_id, or run the setup CLI to add this one.',
+                });
+            }
             const items = rows.map((row) => ({
                 site_id: row.site_id,
                 url: row.url,
@@ -121,34 +100,43 @@ export function buildSitesListTool(registry) {
                     ? { platform_resolved: row.platform_resolved }
                     : {}),
                 is_default: row.is_default,
+                is_active: activeSiteId !== null && row.site_id === activeSiteId,
                 ...(row.label !== undefined ? { label: row.label } : {}),
             }));
-            // Table-side projection: humans see one `platform` column
-            // (resolved if known, hint otherwise) and a yes/no on
-            // is_default for legibility.
             const tableRows = rows.map((row) => ({
                 site_id: row.site_id,
                 url: row.url,
                 platform: row.platform_resolved ?? row.platform_hint,
                 is_default: row.is_default ? 'yes' : 'no',
+                is_active: activeSiteId !== null && row.site_id === activeSiteId ? 'yes' : 'no',
                 label: row.label ?? '',
             }));
             const toolkitResult = tableResult(tableRows, {
                 columns: TABLE_COLUMNS,
-                header: (count) => `${String(count)} configured site${count === 1 ? '' : 's'}` +
-                    (defaultSiteId !== null ? ` (default: ${defaultSiteId})` : ' (no default configured)'),
-                footer: 'Use yootheme_builder_sites_test <site_id> to verify connectivity. ' +
-                    'Pass `site_id: "<id>"` on any tool call to target a specific site.',
+                header: (count) => count === 0 && configProblem !== null
+                    ? '0 configured sites — a configured source was rejected at startup (see config_problem)'
+                    : `${String(count)} configured site${count === 1 ? '' : 's'}` +
+                        (defaultSiteId !== null ? ` (default: ${defaultSiteId})` : ' (no default configured)') +
+                        (activeSiteId !== null && activeSiteId !== defaultSiteId
+                            ? ` — ACTIVE: ${activeSiteId}, set by use_site; calls without site_id go THERE, not to the default`
+                            : '')
+                        + (configProblem !== null
+                            ? ' — a configured source was rejected at startup and is NOT in this list (see config_problem)'
+                            : ''),
+                footer: substituted
+                    ? 'These names are a SUBSTITUTE while the configured registry is rejected: '
+                        + 'a call that names one is refused. Call tools WITHOUT `site_id` — they '
+                        + 'run against the site listed above.'
+                    : 'Verify one: yootheme_builder_sites_test({site_id: "<SITE_ID column>"}). ' +
+                        'Pass `site_id: "<SITE_ID column>"` on any tool call to target a specific site.',
+                includeMeta: include_meta,
             });
-            // The W6 `withSiteMeta` wrapper is intentionally NOT used —
-            // see the file header for rationale. We emit a stable
-            // `_meta.tool_kind: "registry"` marker so MCP hosts can
-            // distinguish registry tools from site-bound tools without
-            // string-matching the tool name.
             return structuredResult(toolkitResult, {
                 items,
                 total: items.length,
                 default_site_id: defaultSiteId,
+                active_site_id: activeSiteId,
+                ...(configProblem !== null ? { config_problem: configProblem } : {}),
                 _meta: { tool_kind: 'registry' },
             });
         },