@wootsup/yt-builder-mcp 1.12.0 → 2.1.0

package/dist/tools/pages/handlers-write.js

@@ -1,419 +0,0 @@
-/**
- * Page-tool WRITE handlers — `page_save`, `page_publish`, `pages_create`,
- * `pages_delete`. All implement the 3-phase progress contract
- * (PHASE_SEND → PHASE_SERVER → PHASE_CONFIRM). PHASE_SERVER is emitted
- * BEFORE the await so the synthetic intermediate fires even when the
- * REST call ultimately errors — the dispatch IS the boundary, not the
- * response.
- *
- * Split out of `src/tools/pages.ts` (Round-2 R2-A2-CRIT1).
- * Extended with pages_create / pages_delete (v1.2 — C2 + C3).
- *
- * @license MIT
- */
-import { detailResult } from '@getimo/mcp-toolkit';
-import { z } from 'zod';
-import { encodeTemplateId } from '../../client.js';
-import { RestError } from '../../errors.js';
-import { PHASE_CONFIRM, PHASE_SEND, PHASE_SERVER } from '../progress-phases.js';
-import { createProgressReporter, errorResult, jsonResult, structuredResult, } from '../tool-builder.js';
-// ─── page_save ──────────────────────────────────────────────────────
-export async function handlePageSave(client, { template_id, etag, layout, dry_run, quick_check }, extra) {
-    const progress = extra ? createProgressReporter(extra) : null;
-    await progress?.report(0, 3, PHASE_SEND);
-    await progress?.report(1, 3, PHASE_SERVER);
-    try {
-        // F85: forward `layout` only when supplied so the historical save
-        // body (`{}`) is byte-unchanged for the re-run-transforms path.
-        // U3/F3: forward `dry_run` only when set (a preflight, no persist).
-        // Task 8: forward `quick_check` only when set (opt-in for save).
-        const body = {};
-        if (layout !== undefined)
-            body.layout = layout;
-        if (dry_run !== undefined)
-            body.dry_run = dry_run;
-        if (quick_check !== undefined)
-            body.quick_check = quick_check;
-        const data = await client.post(`/pages/${encodeTemplateId(template_id)}/save`, Object.keys(body).length > 0 ? { body, etag } : { etag });
-        await progress?.report(2, 3, PHASE_CONFIRM);
-        // U3/F3+F4: the REST response shape is freeform (no strict
-        // outputSchema on page_save), so the new `previous_layout` (F4
-        // rollback lever), `validation_report` (F3 dry-run), and the
-        // `render_error` carried by a 422 surface VERBATIM through jsonResult
-        // with no schema change.
-        return jsonResult(data);
-    }
-    catch (e) {
-        return errorResult({
-            error: e,
-            context: { template_id, etag, dry_run: dry_run ?? false },
-            hint: 'On 412 (precondition failed) the CURRENT ETag is already in this ' +
-                'error — retry immediately with the `current_etag` field (or the ' +
-                'value in the "current resource ETag (…)" message); only call ' +
-                'yootheme_builder_get_etag if you also need to re-read the layout. ' +
-                'On 422 the supplied `layout` failed validation: ' +
-                // U3/F1 — the double-nest reject. The single most common cause:
-                // feeding page_get_layout`s `.layout` (the FULL template node)
-                // back in verbatim.
-                '`layout_not_inner` / `layout_double_nested` mean you passed the ' +
-                'full template node (or a doubly-wrapped layout) — resend the INNER ' +
-                '{type:"layout",children:[...]} tree (its `.layout` child), NOT the ' +
-                'template node page_get_layout returns. ' +
-                // U3/F3 — the pre-write render refusal.
-                '`render_precheck_failed` means YOOtheme could not render the layout ' +
-                '(an invalid binding renders blank + saves silently); the error ' +
-                '`render_error` is the otherwise-swallowed YOOtheme message — fix the ' +
-                'bound source/field (item-level field-mappings belong in ' +
-                '`source_extended.props`, not `source.props`). ' +
-                'Other 422s (unknown element type / bad structure) carry `path` + ' +
-                '`element_type` pinpointing the node. Nothing is written on any 422. ' +
-                // U3/F3 — preflight + F4 rollback.
-                'Tip: pass `dry_run:true` to preflight the render without writing. On a ' +
-                'bad save, the prior success response`s `previous_layout` is the 1-call ' +
-                'rollback (resend it as `layout`).',
-        });
-    }
-}
-// ─── page_publish ───────────────────────────────────────────────────
-/**
- * F202 (P1): when the publish/dynamize response carries a `cms_warning` (the
- * YT-layout is published but the backing CMS object — WP post / Joomla article
- * — is NOT publicly visible: draft/future status, future publish_up, or no
- * route), append it as a SALIENT trailing text block. The JSON leg already
- * carries `cms_visibility` + `cms_warning`; the extra block makes the warning
- * survive a long, context-rotted session where the agent skips parsing the
- * payload and declares success on a page that 404s anonymously.
- *
- * No-op (returns the result unchanged) when there is no `cms_warning` — the
- * publicly-visible happy path keeps its single-leg shape.
- */
-function withCmsWarningText(result, data) {
-    if (typeof data !== 'object' || data === null) {
-        return result;
-    }
-    const warning = data.cms_warning;
-    if (typeof warning !== 'string' || warning === '') {
-        return result;
-    }
-    return {
-        ...result,
-        content: [...result.content, { type: 'text', text: warning }],
-    };
-}
-export async function handlePagePublish(client, { template_id, etag, quick_check }, extra) {
-    const progress = extra ? createProgressReporter(extra) : null;
-    await progress?.report(0, 3, PHASE_SEND);
-    await progress?.report(1, 3, PHASE_SERVER);
-    try {
-        // Task 8: the publish QuickCheck is DEFAULT ON server-side. Forward a
-        // body ONLY when the caller explicitly set `quick_check` (`false` to
-        // opt out) so the historical `{ etag }`-only shape is byte-unchanged
-        // for the common default-on path.
-        const body = {};
-        if (quick_check !== undefined)
-            body.quick_check = quick_check;
-        const data = await client.post(`/pages/${encodeTemplateId(template_id)}/publish`, Object.keys(body).length > 0 ? { body, etag } : { etag });
-        await progress?.report(2, 3, PHASE_CONFIRM);
-        return withCmsWarningText(jsonResult(data), data);
-    }
-    catch (e) {
-        return errorResult({
-            error: e,
-            context: { template_id, etag },
-            hint: 'On 412 (precondition failed) the CURRENT ETag is already in this ' +
-                'error — retry immediately with the `current_etag` field (or the ' +
-                'value in the "current resource ETag (…)" message); only call ' +
-                'yootheme_builder_get_etag if you also need to re-read the layout.',
-        });
-    }
-}
-/**
- * F12 (2026-06-09): collapse the friendly `published` boolean into the
- * canonical `status` the PHP host understands.
- *
- * Precedence: an EXPLICIT `status` always wins — `published` is the
- * ergonomic shortcut, not an override. So:
- *   - status given           → use it verbatim (published ignored).
- *   - status absent + true    → 'publish' (WP post_status=publish, Joomla state=1).
- *   - status absent + false/∅ → undefined (server applies its draft default).
- *
- * Returning `undefined` (rather than an explicit `'draft'`) for the
- * default case preserves the existing wire shape — the server's Q6
- * default-to-draft logic stays authoritative and the body byte-shape is
- * unchanged for legacy callers that never sent `published`.
- */
-export function resolveCreateStatus(status, published) {
-    if (status !== undefined)
-        return status;
-    if (published === true)
-        return 'publish';
-    return undefined;
-}
-/**
- * `pages_create` — POST `/pages` with the provided body. On
- * `dry_run:true`, the REST handler runs validation Layers 1+2+4
- * without persisting and returns a dry-run report. On non-dry-run
- * success, the REST handler returns 201 with the wire shape of
- * `PAGES_CREATE_OUTPUT_SCHEMA`.
- */
-export async function handlePagesCreate(client, input, extra) {
-    const progress = extra ? createProgressReporter(extra) : null;
-    await progress?.report(0, 3, PHASE_SEND);
-    await progress?.report(1, 3, PHASE_SERVER);
-    // F12: translate the `published` shortcut into the host-native
-    // `status` and DROP `published` from the wire body (the REST host has
-    // no such field). `status` is omitted entirely when neither an
-    // explicit status nor published:true was given, so the server's
-    // draft-default stays authoritative and the body shape is unchanged
-    // for legacy callers.
-    const { published: _published, status: _status, ...rest } = input;
-    const resolvedStatus = resolveCreateStatus(input.status, input.published);
-    const body = resolvedStatus !== undefined ? { ...rest, status: resolvedStatus } : rest;
-    try {
-        const data = await client.post('/pages', { body });
-        await progress?.report(2, 3, PHASE_CONFIRM);
-        return jsonResult(data);
-    }
-    catch (e) {
-        return errorResult({
-            error: e,
-            context: {
-                title: input.title,
-                slug: input.slug,
-                dry_run: input.dry_run ?? false,
-            },
-            hint: pagesCreateHint(e),
-        });
-    }
-}
-/**
- * SOURCES_BINDING-20 — status-aware catch hint for `pages_create`.
- *
- * A 403 is a CAPABILITY denial (the resolved CMS user lacks core.create) — the
- * SAME key keeps being denied, so the generic "re-submit without dry_run:true to
- * actually create" advice directly CONTRADICTS the failure (a wet retry is
- * denied identically). On a 403 give capability-specific guidance and NO
- * dry-run/re-submit advice; keep the create/body-parse guidance for the other
- * status classes it actually describes.
- */
-function pagesCreateHint(e) {
-    if (e instanceof RestError && e.status === 403) {
-        return ('A 403 is a CAPABILITY denial, not a retryable error — re-submitting the same ' +
-            'request (wet or dry-run) is denied identically. The resolved CMS user lacks the ' +
-            'create capability (WordPress publish_pages / edit_pages, Joomla core.create on ' +
-            'com_content). Resolve/elevate the user behind this Bearer key, or verify the ACL, ' +
-            'then retry. Run yootheme_builder_diagnose to check auth + which user this key maps to.');
-    }
-    return ('Common issues: missing title (400), unknown element type in layout ' +
-        '(422), Builder pre-check failed (422 dry-run or wet). For dry-run: re-submit ' +
-        'without dry_run:true to actually create. ' +
-        // F95 (2026-06-10): a `body_parse_failed` 400 means the AI host TRUNCATED
-        // the arguments JSON in transit (a known failure mode for large inline
-        // `layout` payloads ~10KB+). Create with a small/empty layout first.
-        'On a `body_parse_failed` 400 the tool-call arguments were truncated in ' +
-        'transit (large inline `layout`): create the page with an empty/small ' +
-        'layout, then add elements one at a time via element_add / ' +
-        'element_bind_source instead of one giant inline `layout`.');
-}
-/**
- * The recency reminder appended to every successful dynamize (research:
- * checklist echo — keeps the "verify visually" step salient even in a
- * long, context-rotted session). One line, by design (F98 rank-3:
- * attention-dilution on a longer echo).
- */
-const DYNAMIZE_SUCCESS_REMINDER = 'Verify one row visually against the original at the customer viewport before declaring success.';
-/**
- * `page_dynamize` — POST `/pages/dynamize`. THE one-call canonical path to
- * dynamize an existing designed section: the server copies the reference
- * subtree byte-identically and swaps only the mapped queries + leaf
- * field-names (the recipe of `dynamize-existing-layout.md` as CODE), then
- * creates the page through the same hardened create path. The 201 carries
- * a `summary` self-check ({queries_swapped, leaves_remapped, leaves_kept,
- * leaves_removed, unmatched_map_keys, kept_unresolvable}). A non-empty
- * `unmatched_map_keys` means the agent mapped a field the reference subtree
- * never bound; a non-zero `kept_unresolvable.count` means a sub-query panel
- * had no flow field (its leaves render empty) — extend leaf_map with the
- * qualified "<subquery>.<leaf>" keys and retry.
- */
-export async function handlePageDynamize(client, input, extra) {
-    const progress = extra ? createProgressReporter(extra) : null;
-    await progress?.report(0, 3, PHASE_SEND);
-    await progress?.report(1, 3, PHASE_SERVER);
-    try {
-        const data = await client.post('/pages/dynamize', { body: input, etag: input.etag });
-        await progress?.report(2, 3, PHASE_CONFIRM);
-        // Append the one-line recency reminder as a trailing text block so
-        // the JSON leg stays byte-pure (parsers read content[0]) while the
-        // human + model see the verify-visually nudge.
-        const base = jsonResult(data);
-        const withReminder = {
-            ...base,
-            content: [...base.content, { type: 'text', text: DYNAMIZE_SUCCESS_REMINDER }],
-        };
-        // F202: when a dynamize PUBLISHED to a draft/scheduled/unrouted CMS
-        // object, surface the cms_warning as a salient trailing block too.
-        return withCmsWarningText(withReminder, data);
-    }
-    catch (e) {
-        return errorResult({
-            error: e,
-            context: {
-                template_id: input.template_id,
-                section_name: input.section_name,
-                element_path: input.element_path,
-                list_source_name: input.list_source_name,
-            },
-            hint: 'On 404 section_not_found the error data lists `available_named_sections` — ' +
-                'pick one and retry. Provide EXACTLY ONE of section_name / element_path. ' +
-                'On 422 the dynamized layout failed validation (the `path` + `element_type` ' +
-                'pinpoint the node). On 412 refresh via yootheme_builder_get_etag and retry. ' +
-                'Check the response `summary.unmatched_map_keys` — a non-empty list means a ' +
-                'leaf_map key did not match any leaf in the reference subtree (typo, or wrong ' +
-                'reference section). Check `summary.kept_unresolvable` — a non-zero count means a ' +
-                'sub-query panel had no flow field; add the qualified "<subquery>.<leaf>" keys to ' +
-                'leaf_map and retry.',
-        });
-    }
-}
-/**
- * `pages_delete` — DELETE `/pages/{post_id}` with confirm + force in the
- * body. `force:false` (default) trashes via `wp_delete_post(false)`
- * (recoverable via wp-admin). `force:true` hard-deletes the post
- * (irrecoverable). The REST handler returns 200 with the wire shape of
- * `PAGES_DELETE_OUTPUT_SCHEMA` on success.
- */
-export async function handlePagesDelete(client, input, extra) {
-    const progress = extra ? createProgressReporter(extra) : null;
-    await progress?.report(0, 3, PHASE_SEND);
-    await progress?.report(1, 3, PHASE_SERVER);
-    try {
-        const data = await client.delete(`/pages/${encodeURIComponent(String(input.post_id))}`, {
-            body: {
-                confirm: input.confirm,
-                force: input.force ?? false,
-            },
-        });
-        await progress?.report(2, 3, PHASE_CONFIRM);
-        // Task #38 (2026-05-29): pages_delete declares
-        // `outputSchema: PAGES_DELETE_OUTPUT_SCHEMA` in builders.ts. The
-        // host therefore validates `structuredContent` and rejects with
-        // `-32602 Output validation error` when it is missing. Use
-        // `structuredResult` (mirrors handlePagesList et al.) so the
-        // text leg stays LLM-readable AND the structured leg validates.
-        const toolkitResult = jsonResult(data);
-        return structuredResult({ content: toolkitResult.content }, data);
-    }
-    catch (e) {
-        return errorResult({
-            error: e,
-            context: {
-                post_id: input.post_id,
-                force: input.force ?? false,
-            },
-            hint: 'Common issues: missing confirm:true (400), unknown post id (404), ' +
-                'post_type other than "page" (403). For permanent delete pass ' +
-                'force:true; default is trash (recoverable via wp-admin).',
-        });
-    }
-}
-// ─── template_set_type (N3 — archive/single TYPE assignment) ─────────
-/**
- * N3 (customer HANDOFF-5) — the `template_set_type` STRICT output schema.
- *
- * A default (strip) ZodObject so a strict (`additionalProperties:false`) host
- * accepts the structuredContent and the shape-pin guard's `.strict()` re-parse
- * passes. The success body the PHP `PagesController::set_type` returns is
- * `{template_id, type, previous_type, etag, new_etag}` — EVERY key here must be
- * DECLARED, else a strict MCP host -32602-rejects the success (the G2
- * `changed_paths` lesson). `previous_type` folds the read of the prior assignment
- * INTO the write response (the spec's "read of the current assignment").
- */
-export const TEMPLATE_SET_TYPE_OUTPUT_SCHEMA = z.object({
-    template_id: z.string(),
-    // The NEW archive/single TYPE assignment now stored on the template.
-    type: z.string(),
-    // The PRIOR assignment (the read of the current type, folded in).
-    previous_type: z.string(),
-    // SOURCES_BINDING-16: the POST-WRITE ETag (== new_etag) — always safe to
-    // chain into the next write (was the pre-write input etag, which 412'd).
-    // On a dry_run nothing persists, so etag == new_etag == the current ETag.
-    etag: z.string(),
-    // The bumped ETag after the write — pass as `etag` on the next write.
-    new_etag: z.string(),
-    // PAGES_LIBRARY_MEDIA-14: present + true ONLY on a dry_run preflight (the
-    // re-type was validated + previewed but NOT persisted).
-    dry_run: z.boolean().optional(),
-    // PAGES_LIBRARY_MEDIA-14: whether the (dry-run) re-type would actually
-    // change the stored assignment (`type !== previous_type`).
-    would_change: z.boolean().optional(),
-});
-/**
- * N3 — SET a theme template's archive/single TYPE assignment in ONE ETag-locked
- * write. The `type` is forwarded VERBATIM to `POST /pages/<id>/type`; the PHP
- * controller is the single place that validates the assignment + pointer-writes
- * `templates.<id>.type` (the same field pages_list reads), folding the prior
- * assignment into the response as `previous_type`. Theme-template-only — a
- * per-page/article id is refused (422) by the controller.
- */
-export async function handleTemplateSetType(client, { template_id, type, etag, dry_run }, extra) {
-    const progress = extra ? createProgressReporter(extra) : null;
-    await progress?.report(0, 3, PHASE_SEND);
-    await progress?.report(1, 3, PHASE_SERVER);
-    try {
-        const data = await client.post(`/pages/${encodeTemplateId(template_id)}/type`, 
-        // PAGES_LIBRARY_MEDIA-14: forward `dry_run` only when set so an
-        // ordinary re-type stays byte-identical; the PHP branch previews
-        // without persisting.
-        { body: { type, ...(dry_run ? { dry_run: true } : {}) }, etag });
-        await progress?.report(2, 3, PHASE_CONFIRM);
-        // Project to exactly the strict output-schema keys so structuredContent
-        // never carries an undeclared key (a strict host -32602-rejects extras).
-        // Fall back to request/sane values so the shape is always complete.
-        // SOURCES_BINDING-16: `etag` = the POST-WRITE etag (chainable), not the input.
-        const newEtag = typeof data.new_etag === 'string' ? data.new_etag : '';
-        const postWriteEtag = newEtag !== '' ? newEtag : (typeof data.etag === 'string' ? data.etag : etag);
-        const structured = {
-            template_id: typeof data.template_id === 'string' ? data.template_id : template_id,
-            type: typeof data.type === 'string' ? data.type : type,
-            previous_type: typeof data.previous_type === 'string' ? data.previous_type : '',
-            etag: postWriteEtag,
-            new_etag: newEtag,
-            // PAGES_LIBRARY_MEDIA-14: surface the dry-run preview flags when the
-            // PHP branch returned them (absent on a real persisted write).
-            ...(typeof data.dry_run === 'boolean' ? { dry_run: data.dry_run } : {}),
-            ...(typeof data.would_change === 'boolean'
-                ? { would_change: data.would_change }
-                : {}),
-        };
-        const toolkitResult = detailResult({
-            title: 'Template type reassigned',
-            includeMeta: false,
-            groups: [
-                {
-                    label: 'Archive/single TYPE assignment',
-                    entries: [
-                        { key: 'template_id', label: 'Template', value: structured.template_id, format: 'text' },
-                        { key: 'previous_type', label: 'Previous type', value: structured.previous_type, format: 'badge' },
-                        { key: 'type', label: 'New type', value: structured.type, format: 'badge' },
-                        { key: 'new_etag', label: 'New ETag', value: structured.new_etag, format: 'badge', copyable: true },
-                    ],
-                },
-            ],
-        });
-        return structuredResult(toolkitResult, structured);
-    }
-    catch (e) {
-        return errorResult({
-            error: e,
-            context: { template_id, type },
-            hint: 'On 412 refresh the ETag via yootheme_builder_get_etag and retry; on 428 ' +
-                'an ETag is REQUIRED (call get_etag first). On 422 `type_not_assignable` ' +
-                'the id is a per-page/article layout (page:/article: prefix) — those have ' +
-                'no archive/single assignment; pick a THEME template id via ' +
-                'yootheme_builder_pages_list. On 422 `invalid_type` pass a valid ' +
-                'assignment token (e.g. "taxonomy-category_help", "single-example_help", ' +
-                '"template"). On 404 verify template_id via yootheme_builder_pages_list.',
-        });
-    }
-}
-//# sourceMappingURL=handlers-write.js.map

package/dist/tools/pages/handlers-write.js.map

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

package/dist/tools/pages/target.d.ts

@@ -1,162 +0,0 @@
-/**
- * `pages/target` — the shared SEMANTIC-TARGET wire helper (Task A-6 of the
- * single-page-audit plan, 2026-07-22-02).
- *
- * `pages_audit` and `pages_resolve` both accept the same `target` object —
- * exactly ONE of `template_id` | `post_id` | `url` | `special` | `title` — and
- * both must put it on the wire in the ONE encoding the PHP side parses:
- * BRACKET query params (`target[special]=home`). WordPress
- * (`WP_REST_Request['target']`) and Joomla (`Input::get`) both inflate
- * `target%5Bspecial%5D=home` into a nested array natively, and the native
- * transports receive the structured object as-is — one name, byte-identical
- * parity across all three transports.
- *
- * TWO rules are encoded here rather than in the Zod schema, deliberately:
- *
- *   1. NORMALIZATION mirrors PHP `PageQuery::normalizeTarget()` verbatim —
- *      non-scalar and blank members are DROPPED, so `{special: ''}` is "no
- *      target", not "an empty special". Without this the two sides disagree
- *      about how many targets were supplied.
- *   2. EXACTLY-ONE-OF is validated in the HANDLER, never as a zod `.refine`.
- *      This is the F205 lesson (`gateway/advanced-read-tool.ts`): an
- *      SDK-level schema rejection surfaces as a raw `-32602` and bypasses
- *      every piece of typed steering the tool provides. A typed
- *      `too_many_targets` result keeps the agent in the loop.
- *
- * @license MIT
- */
-import { type ToolResult } from '../tool-builder.js';
-import { TARGET_KEYS } from './schemas.js';
-export type TargetKey = (typeof TARGET_KEYS)[number];
-/**
- * The permissive `target` argument as the Zod input schema hands it over —
- * every member optional (the exactly-one-of contract is a HANDLER rule, see
- * the file docblock).
- */
-export interface PagesTarget {
-    readonly template_id?: string;
-    readonly post_id?: number | string;
-    readonly url?: string;
-    readonly special?: string;
-    readonly title?: string;
-}
-/** A target reduced to its non-blank, scalar members (PHP-parity shape). */
-export type NormalizedTarget = Partial<Record<TargetKey, string>>;
-/**
- * Drop non-scalar / blank members and stringify the rest — the TS mirror of
- * PHP `PageQuery::normalizeTarget()`. An absent target and an all-blank target
- * both normalize to `{}`, which every caller reads as "no target ⇒ site sweep".
- */
-export declare function normalizeTarget(target: PagesTarget | undefined): NormalizedTarget;
-/** The keys actually supplied, in canonical order (0 = no target). */
-export declare function targetKeysOf(target: NormalizedTarget): TargetKey[];
-/**
- * BUG-4 — the typed "you SENT a target, but none of it survived normalisation"
- * failure, or `null` when there is nothing to complain about. The TS half of
- * PHP `PageQuery::malformedTargetError()`, with the SAME predicate, the SAME
- * code and the SAME status, so the rule reads identically wherever it fires.
- *
- * {@see normalizeTarget} deliberately DROPS blank and non-scalar members, so
- * `{special: ''}`, `{title: '   '}` and `{post_id: null}` all normalise to
- * `{}`. Every caller reads `{}` as "no target ⇒ site sweep" — which for
- * `pages_audit` meant answering a plainly single-page request with a 200 over
- * the WHOLE SITE, carrying no scope marker and no error. The version-skew guard
- * could not catch it either: that guard is itself gated on `hasTarget`, which
- * this input makes false. An agent templating `target: { title: pageName }`
- * where `pageName` resolved to `''` got the whole site back and presented it as
- * the audit of the page it meant — the exact wrong-findings-wrong-page class
- * `serverTooOldError` exists to prevent.
- *
- * An EMPTY OBJECT is NOT malformed: `target: {}` means "no target" by
- * documented contract (PHP returns null for `$raw === []`, and a test pins it).
- * Only a bag that HAS members, none of which is a usable address, is flagged.
- *
- * Kept next to `normalizeTarget` — the two belong together, and a per-handler
- * copy is exactly the drift the shared front door exists to prevent.
- *
- * @param raw The caller's target bag, BEFORE normalisation.
- * @param normalized The {@see normalizeTarget} result for that bag.
- */
-export declare function malformedTargetError(raw: PagesTarget | undefined, normalized: NormalizedTarget, opts: {
-    context: Record<string, unknown>;
-    hint: string;
-}): ToolResult | null;
-/**
- * Append the normalized target to a querystring as BRACKET params —
- * `target[special]=home`. `URLSearchParams` percent-encodes the brackets
- * (`target%5Bspecial%5D`); PHP url-decodes a parameter NAME before splitting
- * it on `[`, so both CMSes inflate it into the nested array the controllers
- * read.
- */
-export declare function appendTargetParams(qs: URLSearchParams, target: NormalizedTarget): void;
-/**
- * Is this thrown value a TYPED target failure from the host's pages domain?
- *
- * Distinguishes a request-SHAPE answer (the address matched nothing / several
- * things / an unsupported role) from a transport or capability failure. A WP
- * `rest_no_route` 404 (the route does not exist — the plugin predates the
- * feature) is deliberately NOT one of these: it carries WordPress's own code,
- * not ours, so the "update the plugin" gate keeps firing for it.
- */
-export declare function isTypedTargetError(e: unknown): boolean;
-/**
- * BUG-3 / MM-5 — the ONE recovery hint for a typed target failure, shared by
- * `pages_resolve` and `pages_audit`.
- *
- * Hoisted here because the two tools answer the SAME error family and used to
- * disagree: `pages_resolve` branched on `hasTarget` and said this, while
- * `pages_audit` sent every typed failure into its generic catch — "Run
- * yootheme_builder_diagnose to verify auth + that the host plugin is
- * reachable". That points an agent at a connectivity problem when the fault is
- * its own request shape (the failure mode `typesConflictsWithTargetError`'s
- * docblock was written to prevent), costs a round-trip on a diagnose that comes
- * back green, and leaves no steer toward the actual fix.
- */
-export declare const TARGET_FAILURE_HINT: string;
-/**
- * The typed "you addressed more than one page" failure (F205: a handler
- * error, never a schema rejection). Shared so `pages_audit` and
- * `pages_resolve` fail with the SAME code and the same steer.
- *
- * `status: 400` is the status the PHP controllers return for the identical
- * clash, so a caller that keys on status sees one contract whether the check
- * fired locally or upstream.
- */
-export declare function tooManyTargetsError(opts: {
-    supplied: readonly string[];
-    context: Record<string, unknown>;
-}): ToolResult;
-/**
- * The typed "a single-target audit cannot also filter by `types`" failure
- * (Key decision 11 — fail-explicit, never a silent winner).
- *
- * PHP `PageAuditService::audit()` refuses the same clash, so without a local
- * pre-check the request went out, came back 400, and landed in the caller's
- * GENERIC catch — whose hint reads "Run yootheme_builder_diagnose to verify
- * auth + that the host plugin is reachable". That points an agent at a
- * connectivity problem when the fault is its own request shape, and burns a
- * round-trip to do it. Code and status mirror the PHP side exactly so a caller
- * sees ONE contract wherever the check fired.
- */
-export declare function typesConflictsWithTargetError(opts: {
-    context: Record<string, unknown>;
-}): ToolResult;
-/**
- * The typed "this host predates single-target addressing" failure.
- *
- * The 404 capability gate does NOT cover this case: a host plugin that
- * predates the feature IGNORES the unknown `target` query params and answers
- * HTTP 200 with a FULL SITE SWEEP. Handing that back would report whole-site
- * findings as "the audit of your homepage" — wrong findings attributed to the
- * wrong page. So the caller REQUIRES positive proof of scoping and routes
- * everything else here.
- *
- * `status: 426` (Upgrade Required) is SYNTHETIC — the transport call itself
- * succeeded; the status names what has to happen, mirroring how the 404 gate
- * turns a route-absent response into an update-the-plugin steer.
- */
-export declare function serverTooOldError(opts: {
-    message: string;
-    context: Record<string, unknown>;
-}): ToolResult;
-//# sourceMappingURL=target.d.ts.map

package/dist/tools/pages/target.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../../src/tools/pages/target.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,4EAA4E;AAC5E,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AAElE;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,gBAAgB,CAWjF;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,EAAE,CAElE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,oBAAoB,CAChC,GAAG,EAAE,WAAW,GAAG,SAAS,EAC5B,UAAU,EAAE,gBAAgB,EAC5B,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzD,UAAU,GAAG,IAAI,CAoBnB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAKtF;AAkBD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,QAGuC,CAAC;AAExE;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACtC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,UAAU,CAgBb;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAChD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,UAAU,CAeb;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,UAAU,CAcb"}