@wootsup/yt-builder-mcp 1.1.6 → 1.2.0

package/dist/tools/format/sources-format.js

@@ -0,0 +1,242 @@
+/**
+ * Sources format-sidecar — pure transforms for `sources_list` (table) and
+ * `element_get_binding` (detail). Wave G.2.7 (Design §3.2 rows 16 / 17).
+ *
+ * @license MIT
+ */
+// ─── sources_list columns (Design §3.2 row 16) ───────────────────────
+export const SOURCES_TABLE_COLUMNS = [
+    { key: 'name', label: 'NAME', width: 36, llmOnly: true },
+    { key: 'label', label: 'LABEL', width: 28 },
+    { key: 'origin', label: 'ORIGIN', width: 12 },
+    { key: 'kind', label: 'KIND', width: 10 },
+];
+// ─── Row mapper ──────────────────────────────────────────────────────
+function asString(v) {
+    return typeof v === 'string' ? v : '';
+}
+export function mapSourceRow(input) {
+    return {
+        name: asString(input.name),
+        label: asString(input.label),
+        origin: asString(input.origin),
+        // F-04 Kleinkram (Audit v2): BE returns `type` (GraphQL type name
+        // from the YT source-provider), not `kind`. Fall back so the
+        // column populates without needing a BE rename.
+        kind: asString(input.kind !== undefined && input.kind !== '' ? input.kind : input.type),
+    };
+}
+/**
+ * The REST plugin exposes sources EITHER as a grouped object
+ * `{apimapper:[…], wordpress:[…], essentials:[…], joomla:[…]}` OR
+ * (post-refactor) as a flat array of `{name, label, origin, kind}`.
+ * This helper normalises both into a flat array — flattening adds
+ * `origin` from the group key when absent.
+ *
+ * F-A5-1 (v1.1.5): `joomla` is included so Joomla's native content
+ * sources (Article, Category, Tag, etc.) flow through when the host
+ * plugin uses that group key. See also {@link remapOriginForPlatform}
+ * for the per-platform normalisation applied after flattening.
+ */
+const KNOWN_ORIGINS = ['apimapper', 'wordpress', 'essentials', 'joomla'];
+export function flattenSourcesPayload(payload) {
+    if (Array.isArray(payload)) {
+        return payload.filter((x) => x !== null && typeof x === 'object');
+    }
+    if (payload !== null && typeof payload === 'object') {
+        const out = [];
+        const obj = payload;
+        for (const origin of KNOWN_ORIGINS) {
+            const group = obj[origin];
+            if (Array.isArray(group)) {
+                for (const item of group) {
+                    if (item !== null && typeof item === 'object') {
+                        const rec = item;
+                        out.push({ origin, ...rec });
+                    }
+                }
+            }
+        }
+        return out;
+    }
+    return [];
+}
+/**
+ * F-A5-1 (v1.1.5) — Joomla content sources arrive tagged with
+ * `origin: "wordpress"` because YT Pro historically uses that group
+ * key for "host-CMS-native" sources. On Joomla that label is wrong:
+ * `Article` / `Category` / `Tag` are Joomla concepts, not WordPress.
+ *
+ * The MCP server knows the bound client's platform via
+ * {@link RestClient.getPlatform}, so we remap unconditionally:
+ *
+ *   platform === 'joomla' AND origin === 'wordpress' → 'joomla'
+ *
+ * The unconditional remap is safe in v1.x: the Joomla host plugin
+ * never serves WP-named sources (WP custom-post-type integrations
+ * don't apply on Joomla), so any row tagged `wordpress` on a Joomla
+ * site is by definition a Joomla-native source mis-labelled by the
+ * upstream group key. A server-side fix is tracked separately for
+ * v1.2; until then this keeps cross-platform agent reasoning honest.
+ */
+export function remapOriginForPlatform(rows, platformKind) {
+    if (platformKind !== 'joomla') {
+        return rows;
+    }
+    return rows.map((row) => {
+        if (row.origin === 'wordpress') {
+            return { ...row, origin: 'joomla' };
+        }
+        return row;
+    });
+}
+// ─── Detail builder (Design §3.2 row 17) ─────────────────────────────
+/** Render a primitive binding-value into a DetailEntry-safe scalar. */
+function scalarValue(v) {
+    if (v === null || typeof v === 'string' || typeof v === 'number' || typeof v === 'boolean') {
+        return v;
+    }
+    // Objects / arrays (nested filters, directive args) — JSON-flatten so
+    // the LLM still sees the structure without an [object Object].
+    try {
+        return JSON.stringify(v);
+    }
+    catch {
+        return String(v);
+    }
+}
+/**
+ * Normalise the field-mappings carried on the binding response into a
+ * `prop → source_field` dict.
+ *
+ * F-01-Mapping (Audit v4): the REST plugin surfaces field-mappings in
+ * TWO shapes — `field_mappings` (dict, back-compat) and
+ * `field_mappings_structured` (list of `{element_prop, source_field}`,
+ * the BindingSerializer SSoT output). The structured list is preferred
+ * because it preserves insertion order and field-level `filters`.
+ */
+function extractFieldMappings(binding) {
+    const structured = binding.field_mappings_structured;
+    if (Array.isArray(structured)) {
+        const out = [];
+        for (const entry of structured) {
+            if (entry !== null && typeof entry === 'object') {
+                const rec = entry;
+                const prop = rec.element_prop;
+                const field = rec.source_field;
+                if (typeof prop === 'string' && prop !== '') {
+                    out.push({
+                        prop,
+                        field: typeof field === 'string' ? field : String(field ?? ''),
+                    });
+                }
+            }
+        }
+        return out;
+    }
+    const dict = binding.field_mappings;
+    if (dict !== null && typeof dict === 'object') {
+        return Object.entries(dict).map(([prop, field]) => ({
+            prop,
+            field: typeof field === 'string' ? field : String(field ?? ''),
+        }));
+    }
+    return [];
+}
+/** Pull `query_arguments` off the binding as a flat record. */
+function extractQueryArguments(binding) {
+    const args = binding.query_arguments;
+    if (args !== null && typeof args === 'object' && !Array.isArray(args)) {
+        return args;
+    }
+    return {};
+}
+export function buildBindingDetail(payload) {
+    const b = payload.binding;
+    const sourceName = typeof b.source_name === 'string' ? b.source_name : null;
+    const queryField = typeof b.query_field === 'string' ? b.query_field : null;
+    const fieldMappings = extractFieldMappings(b);
+    const queryArgs = extractQueryArguments(b);
+    const argEntries = Object.entries(queryArgs);
+    const bindingEntries = [
+        {
+            key: 'source_name',
+            label: 'Source',
+            value: sourceName,
+            format: 'badge',
+        },
+    ];
+    if (queryField !== null) {
+        bindingEntries.push({
+            key: 'query_field',
+            label: 'Query field',
+            value: queryField,
+            format: 'code',
+        });
+    }
+    bindingEntries.push({
+        key: 'mapping_count',
+        label: 'Field mappings',
+        value: fieldMappings.length,
+        format: 'text',
+    }, {
+        key: 'arg_count',
+        label: 'Query arguments',
+        value: argEntries.length,
+        format: 'text',
+    });
+    const groups = [
+        {
+            label: 'Element',
+            entries: [
+                {
+                    key: 'template_id',
+                    label: 'Template',
+                    value: payload.template_id,
+                    format: 'badge',
+                },
+                {
+                    key: 'element_path',
+                    label: 'Path',
+                    value: payload.element_path,
+                    format: 'code',
+                    copyable: true,
+                },
+            ],
+        },
+        {
+            label: 'Binding',
+            entries: bindingEntries,
+        },
+    ];
+    // Field-mapping group — one entry per element-prop → source-field
+    // pair so the LLM sees exactly WHICH source field feeds WHICH prop.
+    if (fieldMappings.length > 0) {
+        groups.push({
+            label: 'Field mappings',
+            entries: fieldMappings.map((m, i) => ({
+                key: `mapping_${String(i)}`,
+                label: m.prop,
+                value: m.field,
+                format: 'code',
+            })),
+        });
+    }
+    // Query-arguments group — the GraphQL `query.field.arguments`.
+    if (argEntries.length > 0) {
+        groups.push({
+            label: 'Query arguments',
+            entries: argEntries.map(([key, value], i) => ({
+                key: `arg_${String(i)}`,
+                label: key,
+                value: scalarValue(value),
+                format: 'text',
+            })),
+        });
+    }
+    return {
+        title: `Binding for ${payload.element_path}`,
+        groups,
+    };
+}
+//# sourceMappingURL=sources-format.js.map

package/dist/tools/format/sources-format.js.map

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

package/dist/tools/health.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Health & diagnostics tools.
+ *
+ *   yootheme_builder_health
+ *      → GET /health (unauthenticated). Verifies the plugin is
+ *        installed and reachable. Returns plugin/YT/WP/PHP versions
+ *        + available endpoints.
+ *
+ *   yootheme_builder_diagnose
+ *      → Aggregates health + a Bearer-auth probe so the agent can
+ *        distinguish "plugin missing" from "wrong key".
+ *
+ * Both tools emit `detailResult` (Wave G.2) so hosts that support
+ * structured content render a Detail-Card; the LLM still reads the text
+ * leg from `content[0].text`.
+ *
+ * @license MIT
+ */
+import type { ClientPool } from '../sites/client-pool.js';
+import { type AnyToolDefinition } from './tool-builder.js';
+export declare function buildHealthTools(pool: ClientPool): readonly AnyToolDefinition[];
+//# sourceMappingURL=health.d.ts.map

package/dist/tools/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/tools/health.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAS1D,OAAO,EAOH,KAAK,iBAAiB,EACzB,MAAM,mBAAmB,CAAC;AA4E3B,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,iBAAiB,EAAE,CAqI/E"}

package/dist/tools/health.js

@@ -0,0 +1,220 @@
+/**
+ * Health & diagnostics tools.
+ *
+ *   yootheme_builder_health
+ *      → GET /health (unauthenticated). Verifies the plugin is
+ *        installed and reachable. Returns plugin/YT/WP/PHP versions
+ *        + available endpoints.
+ *
+ *   yootheme_builder_diagnose
+ *      → Aggregates health + a Bearer-auth probe so the agent can
+ *        distinguish "plugin missing" from "wrong key".
+ *
+ * Both tools emit `detailResult` (Wave G.2) so hosts that support
+ * structured content render a Detail-Card; the LLM still reads the text
+ * leg from `content[0].text`.
+ *
+ * @license MIT
+ */
+import { detailResult, statsResult } from '@getimo/mcp-toolkit';
+import { z } from 'zod';
+import { RestError } from '../errors.js';
+import { buildDiagnoseDetail, buildHealthStats, } from './format/health-format.js';
+import { SITE_ID_SCHEMA } from './shared-schemas.js';
+import { resolveSiteOrError } from './pool-resolve-helper.js';
+import { defineTool, errorResult, jsonResult, readOnly, structuredResult, withSiteMeta, } from './tool-builder.js';
+// ─── outputSchemas (Wave G.2 §4) ─────────────────────────────────────
+const HEALTH_OUTPUT_SCHEMA = z.object({
+    plugin_version: z.string(),
+    // Cross-platform note (Wave 7): the anonymous health payload only carries
+    // {plugin_version, status, yootheme_loaded}; the rest is disclosed ONLY
+    // with a valid Bearer (server-side fingerprint-reduction). On Joomla the
+    // augmented payload uses `cms`/`cms_version` and emits NEITHER `wp_version`
+    // NOR `yootheme_version`. All platform-/tier-variable fields are therefore
+    // optional so the same MCP tool validates against WP and Joomla, anon and
+    // authenticated.
+    yootheme_version: z.string().nullable().optional(),
+    wp_version: z.string().nullable().optional(),
+    cms: z.string().optional(),
+    cms_version: z.string().optional(),
+    php_version: z.string().optional(),
+    storage_type: z.string().optional(),
+    storage_target: z.string().optional(),
+    yootheme_loaded: z.boolean(),
+    available_endpoints: z.array(z.string()).optional(),
+    // 1.0.1 — surface canonical WP URLs so an agent can deep-link the
+    // customer to the live site without a separate REST round-trip.
+    // Both fields are optional in the schema for back-compat with older
+    // 1.0.0 PHP servers that don't yet emit them.
+    site_url: z
+        .string()
+        .nullable()
+        .optional()
+        .describe('Canonical WordPress install URL including any subpath ' +
+        '(e.g. `https://example.com/wordpress`). Authenticated payload only.'),
+    home_url: z
+        .string()
+        .nullable()
+        .optional()
+        .describe('Front-end home URL — use this to deep-link the user to the live ' +
+        'site they edited.'),
+});
+const DIAGNOSE_OUTPUT_SCHEMA = z.object({
+    plugin_reachable: z.boolean(),
+    plugin_version: z.string().optional(),
+    yootheme_loaded: z.boolean().optional(),
+    yootheme_version: z.string().nullable().optional(),
+    endpoint_count: z.number().optional(),
+    plugin_error: z.string().optional(),
+    bearer_valid: z.boolean().optional(),
+    bearer_error: z.string().optional(),
+    summary: z.string().optional(),
+    // 1.0.1 — mirror the health fields for parity. Diagnose calls /health
+    // internally so it has the values; surfacing them avoids forcing the
+    // agent to call both tools to get URL info + bearer status.
+    site_url: z
+        .string()
+        .nullable()
+        .optional()
+        .describe('Canonical WordPress install URL including any subpath ' +
+        '(e.g. `https://example.com/wordpress`). Mirrored from /health so an ' +
+        'agent gets URL info + bearer status in one call.'),
+    home_url: z
+        .string()
+        .nullable()
+        .optional()
+        .describe('Front-end home URL — use this to deep-link the user to the live ' +
+        'site they edited.'),
+});
+export function buildHealthTools(pool) {
+    return [
+        defineTool({
+            name: 'yootheme_builder_health',
+            description: 'Check plugin installed/reachable. Returns plugin version, YT Pro version, REST ' +
+                'endpoints. Authenticated payload adds site_url + home_url for deep-linking. ' +
+                'See yootheme_builder_diagnose for Bearer-validity + connectivity summary. ' +
+                'Operates on the default site unless site_id is provided.',
+            inputSchema: {
+                site_id: SITE_ID_SCHEMA,
+            },
+            outputSchema: HEALTH_OUTPUT_SCHEMA,
+            annotations: readOnly('Health Check'),
+            handler: async ({ site_id }) => {
+                const r = await resolveSiteOrError(pool, site_id);
+                if (!r.ok)
+                    return r.error;
+                const { client: siteClient, site } = r;
+                try {
+                    const data = await siteClient.get('/health');
+                    // Round-1 audit I1 fix: spec §3.2 row 1 calls for
+                    // `statsResult` (flat metrics). Earlier shipped
+                    // `detailResult` — that's a Detail-Card variant, not
+                    // the stats-display the spec asked for. The flat
+                    // shape is built by `buildHealthStats`.
+                    const toolkitResult = statsResult(buildHealthStats(data));
+                    // Only surface fields the server actually returned — the
+                    // anonymous tier and Joomla omit different subsets, and the
+                    // output schema now marks all platform-/tier-variable fields
+                    // optional (Wave 7 cross-platform parity).
+                    return withSiteMeta(structuredResult(toolkitResult, {
+                        plugin_version: data.plugin_version,
+                        yootheme_loaded: data.yootheme_loaded,
+                        ...(data.yootheme_version !== undefined ? { yootheme_version: data.yootheme_version } : {}),
+                        ...(data.wp_version !== undefined ? { wp_version: data.wp_version } : {}),
+                        ...(data.cms !== undefined ? { cms: data.cms } : {}),
+                        ...(data.cms_version !== undefined ? { cms_version: data.cms_version } : {}),
+                        ...(data.php_version !== undefined ? { php_version: data.php_version } : {}),
+                        ...(data.storage_type !== undefined ? { storage_type: data.storage_type } : {}),
+                        ...(data.storage_target !== undefined ? { storage_target: data.storage_target } : {}),
+                        ...(data.available_endpoints !== undefined ? { available_endpoints: data.available_endpoints } : {}),
+                        ...(data.site_url !== undefined ? { site_url: data.site_url } : {}),
+                        ...(data.home_url !== undefined ? { home_url: data.home_url } : {}),
+                    }), site);
+                }
+                catch (e) {
+                    return withSiteMeta(errorResult({
+                        error: e,
+                        context: { site_id: site.id },
+                        hint: 'Verify YTB_MCP_SITE_URL points at a WordPress or Joomla site with the ' +
+                            'yt-builder-mcp plugin active. Try opening ' +
+                            '<site_url>/wp-json/yt-builder-mcp/v1/health (WP) or ' +
+                            '<site_url>/api/index.php/v1/yt-builder-mcp/health (Joomla) in a browser.',
+                    }), site);
+                }
+            },
+        }),
+        defineTool({
+            name: 'yootheme_builder_diagnose',
+            description: 'Full diagnostic: /health + authenticated /etag probe. Returns site_url, ' +
+                'home_url, plugin reachability, Bearer validity in one call. First call when ' +
+                'you need to know where the site lives. For per-template URLs see pages_list. ' +
+                'Operates on the default site unless site_id is provided.',
+            inputSchema: {
+                site_id: SITE_ID_SCHEMA,
+            },
+            outputSchema: DIAGNOSE_OUTPUT_SCHEMA,
+            annotations: readOnly('Diagnose Connection'),
+            handler: async ({ site_id }) => {
+                const r = await resolveSiteOrError(pool, site_id);
+                if (!r.ok)
+                    return r.error;
+                const { client: siteClient, site } = r;
+                const checks = { plugin_reachable: false };
+                try {
+                    const health = await siteClient.get('/health');
+                    checks.plugin_reachable = true;
+                    checks.plugin_version = health.plugin_version;
+                    checks.yootheme_loaded = health.yootheme_loaded;
+                    checks.yootheme_version = health.yootheme_version;
+                    checks.endpoint_count = (health.available_endpoints ?? []).length;
+                    // 1.0.1 — mirror health URLs into diagnose output so an
+                    // agent gets URL info AND bearer-status in one call.
+                    if (health.site_url !== undefined) {
+                        checks.site_url = health.site_url;
+                    }
+                    if (health.home_url !== undefined) {
+                        checks.home_url = health.home_url;
+                    }
+                }
+                catch (e) {
+                    checks.plugin_reachable = false;
+                    checks.plugin_error = e instanceof Error ? e.message : String(e);
+                    // Plugin-unreachable path stays on jsonResult so the LLM
+                    // sees the structured error hint inline (detailResult would
+                    // hide the actionable "verify YTB_MCP_SITE_URL" hint inside
+                    // a sub-group). isError=true preserves SDK semantics.
+                    return withSiteMeta(jsonResult({
+                        ...checks,
+                        hint: 'Plugin not reachable. Verify YTB_MCP_SITE_URL and that the ' +
+                            'yt-builder-mcp plugin is active on this site.',
+                    }, { isError: true }), site);
+                }
+                try {
+                    await siteClient.get('/etag');
+                    checks.bearer_valid = true;
+                }
+                catch (e) {
+                    checks.bearer_valid = false;
+                    if (e instanceof RestError) {
+                        checks.bearer_error = `HTTP ${String(e.status)}: ${e.message}`;
+                    }
+                    else {
+                        checks.bearer_error = e instanceof Error ? e.message : String(e);
+                    }
+                    return withSiteMeta(jsonResult({
+                        ...checks,
+                        hint: 'Bearer key rejected. Regenerate the key in wp-admin → Tools → ' +
+                            '"YT Builder MCP" → Bearer Keys (or Joomla Components → YT Builder MCP) ' +
+                            'and re-run `yt-builder-mcp setup`.',
+                    }, { isError: true }), site);
+                }
+                const toolkitResult = detailResult(buildDiagnoseDetail(checks));
+                return withSiteMeta(structuredResult(toolkitResult, {
+                    ...checks,
+                    summary: 'OK — plugin reachable and Bearer key accepted.',
+                }), site);
+            },
+        }),
+    ];
+}
+//# sourceMappingURL=health.js.map

package/dist/tools/health.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Tool aggregator — collects all domain tools into a single list.
+ * The MCP server iterates this list at startup to register handlers
+ * with `@modelcontextprotocol/sdk`.
+ *
+ * @license MIT
+ */
+import type { ClientPool } from '../sites/client-pool.js';
+import type { McpServerWithElicitation } from './elicitation.js';
+import type { AnyToolDefinition } from './tool-builder.js';
+export interface BuildAllToolsOptions {
+    /**
+     * Optional MCP elicitation capability — see
+     * `src/tools/elicitation.ts` for the adapter. When supplied,
+     * destructive + ambiguity-resolution tools prompt the user via the
+     * elicitation channel; when omitted, they fall back to the
+     * preview-then-retry / `ambiguityFallbackError` flow.
+     */
+    readonly elicitation?: McpServerWithElicitation;
+}
+/**
+ * W6 — pool-based registration entrypoint. Pre-W6 this took a bare
+ * `RestClient`; W6 introduces the {@link ClientPool} as the single
+ * source of REST clients (multi-site). Each domain builder now
+ * resolves the pool per-handler via `resolveSiteOrError` and wraps
+ * every result in `withSiteMeta` (Commit 3 of the W6 trio).
+ */
+export declare function buildAllTools(pool: ClientPool, options?: BuildAllToolsOptions): readonly AnyToolDefinition[];
+export type { AnyToolDefinition, ToolDefinition } from './tool-builder.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAMjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,wBAAwB,CAAC;CACnD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CACzB,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,oBAAyB,GACnC,SAAS,iBAAiB,EAAE,CAgB9B;AAED,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,39 @@
+/**
+ * Tool aggregator — collects all domain tools into a single list.
+ * The MCP server iterates this list at startup to register handlers
+ * with `@modelcontextprotocol/sdk`.
+ *
+ * @license MIT
+ */
+import { buildSitesTools } from '../sites/tools/index.js';
+import { buildElementsTools } from './elements/index.js';
+import { buildHealthTools } from './health.js';
+import { buildInspectionTools } from './inspection.js';
+import { buildMultiItemsTools } from './multi-items/index.js';
+import { buildPagesTools } from './pages.js';
+import { buildSourcesTools } from './sources/index.js';
+/**
+ * W6 — pool-based registration entrypoint. Pre-W6 this took a bare
+ * `RestClient`; W6 introduces the {@link ClientPool} as the single
+ * source of REST clients (multi-site). Each domain builder now
+ * resolves the pool per-handler via `resolveSiteOrError` and wraps
+ * every result in `withSiteMeta` (Commit 3 of the W6 trio).
+ */
+export function buildAllTools(pool, options = {}) {
+    const deps = options.elicitation !== undefined ? { elicitation: options.elicitation } : {};
+    return [
+        ...buildHealthTools(pool),
+        ...buildPagesTools(pool),
+        ...buildElementsTools(pool, deps),
+        ...buildSourcesTools(pool, deps),
+        ...buildMultiItemsTools(pool),
+        ...buildInspectionTools(pool),
+        // W7 — Multi-Site registry tools (L1). The aggregator pulls
+        // `pool.registry` internally (W12-R1.3); the sites_list handler
+        // reads the registry without ever resolving a bearer or hitting
+        // the network, while sites_test threads the pool through to
+        // probe one specific site.
+        ...buildSitesTools(pool),
+    ];
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAcvD;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CACzB,IAAgB,EAChB,UAAgC,EAAE;IAElC,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3F,OAAO;QACH,GAAG,gBAAgB,CAAC,IAAI,CAAC;QACzB,GAAG,eAAe,CAAC,IAAI,CAAC;QACxB,GAAG,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC;QACjC,GAAG,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC;QAChC,GAAG,oBAAoB,CAAC,IAAI,CAAC;QAC7B,GAAG,oBAAoB,CAAC,IAAI,CAAC;QAC7B,4DAA4D;QAC5D,gEAAgE;QAChE,gEAAgE;QAChE,4DAA4D;QAC5D,2BAA2B;QAC3B,GAAG,eAAe,CAAC,IAAI,CAAC;KAC3B,CAAC;AACN,CAAC"}

package/dist/tools/inspection.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Element-type inspection tools.
+ *
+ *   yootheme_builder_element_types_list
+ *      → catalogue of available element types (tableResult — Wave G.2)
+ *   yootheme_builder_element_type_get_schema
+ *      → field schema for a single element type (detailResult — Wave G.2)
+ *
+ * @license MIT
+ */
+import type { ClientPool } from '../sites/client-pool.js';
+import { type AnyToolDefinition } from './tool-builder.js';
+export declare function buildInspectionTools(pool: ClientPool): readonly AnyToolDefinition[];
+//# sourceMappingURL=inspection.d.ts.map

package/dist/tools/inspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspection.d.ts","sourceRoot":"","sources":["../../src/tools/inspection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAU1D,OAAO,EAMH,KAAK,iBAAiB,EACzB,MAAM,mBAAmB,CAAC;AA+M3B,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,iBAAiB,EAAE,CA0DnF"}