@wootsup/yt-builder-mcp 1.4.1 → 1.6.0

package/dist/tools/pool-resolve-helper.js

@@ -101,10 +101,60 @@ export async function resolveSiteOrError(pool, siteId) {
  *     withSiteRetry(pool, site_id, async (client, site) =>
  *       withSiteMeta(await handleX(makeDeps(client), rest), site)),
  */
+/**
+ * U2 — the read-only-token fast error returned by the write-tool pre-flight.
+ * Mirrors the PHP `read_only_token` chokepoint message so the Node fast path
+ * and the REST floor steer the agent identically.
+ */
+function readOnlyTokenError(tool) {
+    return jsonResult({
+        error: `This bearer is read-only — regenerate a write-scoped key in `
+            + `YT Builder MCP → Keys to call "${tool}".`,
+        error_code: 'read_only_token',
+        hint: 'Run yootheme_builder_diagnose to confirm this key\'s token_scope, then '
+            + 'regenerate it with the `write` scope in the plugin admin '
+            + '(YT Builder MCP → Keys).',
+    }, { isError: true });
+}
+/**
+ * U2 — resolve a site + execute a WRITE handler-body, with a read-only-token
+ * PRE-FLIGHT in front of the 1-shot-401 retry.
+ *
+ * When the resolved site's coarse token scope is KNOWN to be `read` (learned by
+ * a prior health / diagnose call — see {@link ClientPool.tokenScope}), the write
+ * fails FAST: the read-only error is returned BEFORE the handler runs, so no
+ * ETag is fetched and no request body is built — the exact "fail-fast-before-prep"
+ * the U2 handoff asks for. An UNKNOWN scope (never probed) does NOT block; the
+ * PHP `read_only_token` chokepoint remains the authority, and the fast path is a
+ * pure latency/clarity optimisation, never a new gate.
+ *
+ * `toolName` is surfaced in the fast error so the steer names the exact tool.
+ */
+export async function withWriteSiteRetry(pool, siteId, toolName, fn) {
+    const r1 = await resolveSiteOrError(pool, siteId);
+    if (!r1.ok)
+        return r1.error;
+    // Pre-flight: a KNOWN read-only key can never satisfy a write — refuse here,
+    // before any ETag fetch / body build. `undefined` (not yet learned) passes
+    // through to the REST chokepoint, which stays authoritative.
+    if (pool.tokenScope(r1.site.id) === 'read') {
+        return readOnlyTokenError(toolName);
+    }
+    return withSiteRetryResolved(pool, siteId, fn, r1);
+}
 export async function withSiteRetry(pool, siteId, fn) {
     const r1 = await resolveSiteOrError(pool, siteId);
     if (!r1.ok)
         return r1.error;
+    return withSiteRetryResolved(pool, siteId, fn, r1);
+}
+/**
+ * Shared 1-shot-401 retry body. Split out of {@link withSiteRetry} so the U2
+ * write pre-flight ({@link withWriteSiteRetry}) can run its read-only check on
+ * the ALREADY-resolved site BEFORE entering the retry loop — without resolving
+ * the site twice.
+ */
+async function withSiteRetryResolved(pool, siteId, fn, r1) {
     try {
         return await fn(r1.client, r1.site);
     }

package/dist/tools/pool-resolve-helper.js.map

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

package/dist/tools/sources/builders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/tools/sources/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAI7D,OAAO,EAMH,KAAK,iBAAiB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGH,KAAK,kBAAkB,EAK1B,MAAM,eAAe,CAAC;AAEvB,wBAAgB,iBAAiB,CAC7B,IAAI,EAAE,UAAU,EAChB,IAAI,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,SAAS,iBAAiB,EAAE,CAwN9B"}
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/tools/sources/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAI7D,OAAO,EAMH,KAAK,iBAAiB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAIH,KAAK,kBAAkB,EAM1B,MAAM,eAAe,CAAC;AAQvB,wBAAgB,iBAAiB,CAC7B,IAAI,EAAE,UAAU,EAChB,IAAI,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,SAAS,iBAAiB,EAAE,CA0gB9B"}

package/dist/tools/sources/builders.js

@@ -7,11 +7,12 @@
  * @license MIT
  */
 import { z } from 'zod';
-import { withSiteRetry } from '../pool-resolve-helper.js';
+import { withSiteRetry, withWriteSiteRetry } from '../pool-resolve-helper.js';
 import { ELEMENT_PATH, ETAG, SITE_ID_SCHEMA, TEMPLATE_ID } from '../shared-schemas.js';
 import { FIELDS, MAX_CHARS } from '../sparse-fields.js';
 import { defineTool, destructive, mutating, readOnly, withSiteMeta, } from '../tool-builder.js';
-import { BINDING_OUTPUT_SCHEMA, SOURCES_LIST_OUTPUT_SCHEMA, handleElementBindSource, handleElementGetBinding, handleElementUnbindSource, handleSourcesList, } from './handlers.js';
+import { BINDING_OUTPUT_SCHEMA, SOURCES_LIST_OUTPUT_SCHEMA, SOURCE_SCHEMA_OUTPUT_SCHEMA, handleElementBindSource, handleElementGetBinding, handleElementUnbindSource, handleSourceGetSchema, handleSourcesList, } from './handlers.js';
+import { ELEMENT_SET_SOURCE_OUTPUT_SCHEMA, RENAME_SOURCE_OUTPUT_SCHEMA, handleElementSetSource, handleRenameSource, } from './handlers-bind.js';
 export function buildSourcesTools(pool, deps) {
     // W6.3 — handlers receive a per-call `siteClient` via the
     // resolveSiteOrError helper; the elicitation capability is the
@@ -63,6 +64,30 @@ export function buildSourcesTools(pool, deps) {
             annotations: readOnly('List Sources'),
             handler: async ({ site_id, ...rest }) => withSiteRetry(pool, site_id, async (client, site) => withSiteMeta(await handleSourcesList(makeDeps(client), rest), site)),
         }),
+        defineTool({
+            name: 'yootheme_builder_source_get_schema',
+            description: 'Introspect ONE data source: its query methods + arguments + RELATIONS ' +
+                '(e.g. Term→Posts: categoryFaqs.taxonomyCategoryFaq → field "faq") + a ' +
+                'provides_archive_context flag (id:0 = current archive term, auto-scoped). ' +
+                'CALL BEFORE binding on an archive/category template — turns a ~25-call ' +
+                'code-dive into one. Keywords: source schema, query methods, relations, ' +
+                'Term to Posts, current term, archive context, taxonomy binding. Get `name` ' +
+                'from yootheme_builder_sources_list. ' +
+                'Operates on the default site unless site_id is provided.',
+            inputSchema: {
+                site_id: SITE_ID_SCHEMA,
+                name: z
+                    .string()
+                    .min(1)
+                    .describe('Exact source name from yootheme_builder_sources_list (e.g. ' +
+                    '"categoryFaqs", "wp_posts"). The dotted <base>.<method> native ' +
+                    'shape is accepted too.'),
+                max_chars: MAX_CHARS,
+            },
+            outputSchema: SOURCE_SCHEMA_OUTPUT_SCHEMA,
+            annotations: readOnly('Get Source Schema'),
+            handler: async ({ site_id, ...rest }) => withSiteRetry(pool, site_id, async (client, site) => withSiteMeta(await handleSourceGetSchema(makeDeps(client), rest), site)),
+        }),
         defineTool({
             name: 'yootheme_builder_element_get_binding',
             description: 'Read the source binding attached to an element — the bound source name, ' +
@@ -170,10 +195,239 @@ export function buildSourcesTools(pool, deps) {
                     'container otherwise. "item": container targets resolve to their first ' +
                     '*_item child. "container": binds on the container, response carries a ' +
                     'warning because YT-Pro will clone the container N times.'),
+                // B5 (Glöckle onboarding, 2026-06-27) — relation traversal. The
+                // native archive-scoping pattern binds a Term→Posts RELATION,
+                // not a flat top-level source: e.g. categoryFaqs.taxonomyCategoryFaq
+                // → field "faq" scopes the bound list to the CURRENT category term
+                // (the resolver sets terms=[term_id] automatically). These params
+                // author the canonical `query.field` selector underneath the source
+                // name. Omit them all for the legacy flat top-level-source bind.
+                relation: z
+                    .string()
+                    .min(1)
+                    .optional()
+                    .describe('Optional relation METHOD to traverse from `source_name` (e.g. ' +
+                    '"taxonomyCategoryFaq" on the "categoryFaqs" source). When set, the ' +
+                    'persisted query name becomes "<source_name>.<relation>" so YT-Pro ' +
+                    'resolves the relation (Term→Posts current-term scope) instead of the ' +
+                    'flat source. Discover relations via yootheme_builder_source_get_schema.'),
+                field: z
+                    .string()
+                    .min(1)
+                    .optional()
+                    .describe('Optional relation FIELD to select on the traversal (e.g. "faq" or ' +
+                    '"children" on categoryFaqs.taxonomyCategoryFaq). Sets ' +
+                    '`query.field.name`. Pair with `relation` for the native ' +
+                    'Term→Posts/current-term pattern; the field name comes from the source ' +
+                    'rest_base (yootheme_builder_source_get_schema lists it).'),
+                arguments: z
+                    .record(z.string(), z.unknown())
+                    .optional()
+                    .describe('Optional GraphQL arguments for the relation `field` selector, written to ' +
+                    '`query.field.arguments` (e.g. {order:"menu_order", order_direction:"ASC"}, ' +
+                    'or {id:0} for the current archive term). Ignored unless `field` is set.'),
+                directives: z
+                    .array(z
+                    .object({
+                    name: z
+                        .string()
+                        .min(1)
+                        .describe('Directive name (e.g. "include", "skip").'),
+                    arguments: z
+                        .record(z.string(), z.unknown())
+                        .optional()
+                        .describe('Directive arguments (e.g. {if:true}).'),
+                })
+                    .strict())
+                    .optional()
+                    .describe('Optional GraphQL directives on the relation `field` selector, written to ' +
+                    '`query.field.directives` as a list of {name, arguments?}. Ignored ' +
+                    'unless `field` is set.'),
+                // N2 (Glöckle hub, 2026-06-28) — TOP-LEVEL query arguments. The
+                // hub case (a Grid bound to a source with a per-category id
+                // filter, no relation field) needs to thread `source.query.arguments`
+                // VERBATIM. This is DISTINCT from the relation-FIELD `arguments`
+                // above (`query.field.arguments`): top-level args filter the source
+                // itself; field args filter the traversed relation. Both can be set.
+                query_arguments: z
+                    .record(z.string(), z.unknown())
+                    .optional()
+                    .describe('Optional TOP-LEVEL GraphQL arguments for the bound source, written to ' +
+                    '`source.query.arguments` (e.g. {id:1328} to scope an archive Grid to ' +
+                    'ONE category term, plus {offset, limit, order, order_direction}). ' +
+                    'DISTINCT from `arguments` above, which sets the relation-field selector ' +
+                    '`query.field.arguments`; pass `query_arguments` to filter the source ' +
+                    'itself (the per-archive id filter the hub grids need).'),
                 etag: ETAG,
             },
             annotations: mutating('Bind Source'),
-            handler: async ({ site_id, ...rest }) => withSiteRetry(pool, site_id, async (client, site) => withSiteMeta(await handleElementBindSource(makeDeps(client), rest), site)),
+            handler: async ({ site_id, ...rest }) => withWriteSiteRetry(pool, site_id, 'yootheme_builder_element_bind_source', async (client, site) => withSiteMeta(await handleElementBindSource(makeDeps(client), rest), site)),
+        }),
+        defineTool({
+            name: 'yootheme_builder_element_set_source',
+            description: 
+            // F2 (Glöckle HANDOFF-4) — surgical source-edit; sets a precomposed
+            // source + the native item-level source_extended.props carrier
+            // bind_source cannot write, at a pointer, ETag-locked.
+            'Surgically SET a precomposed `source` (+ optional ' +
+                '`source_extended.props`) on ONE element at a pointer, ETag-locked, ' +
+                'leaving every OTHER node unchanged (no 14 KB page_save). Use this — ' +
+                'not element_bind_source — when you have the exact source shape OR need ' +
+                '`source_extended.props`, the native Multi-Items item-mapping carrier ' +
+                'bind_source cannot write. E.g. an FAQ accordion scoped to the term: ' +
+                'source.query.name="categoryFaqs.taxonomyCategoryFaq", field={name:' +
+                '"faq"}, source_extended.props maps title/content to #node. ETag req. ' +
+                'Operates on the default site unless site_id is provided.',
+            inputSchema: {
+                site_id: SITE_ID_SCHEMA,
+                template_id: TEMPLATE_ID,
+                element_path: ELEMENT_PATH,
+                // The precomposed `source` object → node.source. At least one of
+                // `source` / `source_extended` must be present.
+                source: z
+                    .object({
+                    query: z
+                        .object({
+                        name: z
+                            .string()
+                            .min(1)
+                            .describe('Query name — the bare source (e.g. "wp_posts") OR the ' +
+                            'dotted relation traversal "<source>.<relation>" ' +
+                            '(e.g. "categoryFaqs.taxonomyCategoryFaq" scopes to the ' +
+                            'current archive term). Discover via ' +
+                            'yootheme_builder_source_get_schema.'),
+                        field: z
+                            .object({
+                            name: z
+                                .string()
+                                .min(1)
+                                .describe('Relation field to select (e.g. "faq", "children").'),
+                            arguments: z
+                                .record(z.string(), z.unknown())
+                                .optional()
+                                .describe('GraphQL arguments on the field (e.g. ' +
+                                '{order:"menu_order", order_direction:"ASC"}).'),
+                            directives: z
+                                .array(z
+                                .object({
+                                name: z.string().min(1),
+                                arguments: z
+                                    .record(z.string(), z.unknown())
+                                    .optional(),
+                            })
+                                .strict())
+                                .optional()
+                                .describe('GraphQL directives on the field, e.g. ' +
+                                '[{name:"slice", arguments:{offset:0}}].'),
+                        })
+                            .strict()
+                            .optional()
+                            .describe('Optional relation-field selector → query.field. Omit for a ' +
+                            'flat top-level-source bind.'),
+                        arguments: z
+                            .record(z.string(), z.unknown())
+                            .optional()
+                            .describe('Optional top-level query arguments.'),
+                    })
+                        .describe('The query selector (query.name is required).'),
+                    props: z
+                        .record(z.string(), z.unknown())
+                        .optional()
+                        .describe('Optional source-level prop mappings (source.props) for a flat ' +
+                        'top-level bind. For native item-level mappings use ' +
+                        '`source_extended.props` instead.'),
+                })
+                    .optional()
+                    .describe('The precomposed `source` object written VERBATIM to node.source ' +
+                    '(`{query:{name, field?, arguments?}, props?}`). At least one of ' +
+                    '`source` / `source_extended` is required.'),
+                // The native item-level field-mapping carrier → node.source_extended.
+                source_extended: z
+                    .object({
+                    props: z
+                        .record(z.string(), z
+                        .object({
+                        query: z
+                            .object({ name: z.string().min(1) })
+                            .optional()
+                            .describe('The per-mapping query scope, e.g. {name:"#node"} ' +
+                            '(the current row).'),
+                        name: z
+                            .string()
+                            .optional()
+                            .describe('Source-field name feeding this prop (e.g. "title").'),
+                        filters: z
+                            .record(z.string(), z.unknown())
+                            .optional()
+                            .describe('Optional YT5 filters operator object.'),
+                    })
+                        .strict())
+                        .describe('Per-element-prop field-mappings, e.g. ' +
+                        '{title:{query:{name:"#node"},name:"title"}, ' +
+                        'content:{query:{name:"#node"},name:"content"}}.'),
+                })
+                    .nullable()
+                    .optional()
+                    .describe('The native item-level mapping container written VERBATIM to ' +
+                    'node.source_extended (the YT-Pro Multi-Items pattern). Pass `null` ' +
+                    'to CLEAR an existing source_extended.'),
+                etag: ETAG,
+            },
+            outputSchema: ELEMENT_SET_SOURCE_OUTPUT_SCHEMA,
+            annotations: mutating('Set Source'),
+            handler: async ({ site_id, ...rest }) => withWriteSiteRetry(pool, site_id, 'yootheme_builder_element_set_source', async (client, site) => withSiteMeta(await handleElementSetSource(makeDeps(client), rest), site)),
+        }),
+        defineTool({
+            name: 'yootheme_builder_rename_source',
+            description: 
+            // N1 (Glöckle HANDOFF-5) — template-wide source/field rename.
+            'Template-wide RENAME of a source / type / field name across EVERY ' +
+                'binding in a template, in ONE ETag-locked write (not a whole-layout ' +
+                'page_save) — preserving each binding\'s arguments, props and ' +
+                'field_mappings. Use after a taxonomy/CPT rename (faq→help) breaks ' +
+                'every bound layout. Pass `from`/`to` for one source, and/or ' +
+                '`source_map`/`field_map` to rename a relation + its field tokens ' +
+                'together; the dotted "<source>.<relation>" form is rewritten ' +
+                'segment-by-segment. Returns {replaced_count, changed_paths, new_etag}. ' +
+                'ETag req. Operates on the default site unless site_id is provided.',
+            inputSchema: {
+                site_id: SITE_ID_SCHEMA,
+                template_id: TEMPLATE_ID,
+                // The single-source shorthand — `from`+`to`. Folded into source_map
+                // by the PHP controller. At least one rename instruction (this OR a
+                // source_map/field_map) is required.
+                from: z
+                    .string()
+                    .min(1)
+                    .optional()
+                    .describe('The source/type name to rename (e.g. "categoryFaqs"). Pair ' +
+                    'with `to`. Shorthand for a 1-entry source_map.'),
+                to: z
+                    .string()
+                    .min(1)
+                    .optional()
+                    .describe('The new source/type name (e.g. "categoryHelps"). Pair with `from`.'),
+                source_map: z
+                    .record(z.string().min(1), z.string().min(1))
+                    .optional()
+                    .describe('Object of {old_token: new_token} source/type/relation-name ' +
+                    'renames, applied to `query.name` (each dot-segment of the ' +
+                    'dotted relation form independently) AND the relation ' +
+                    '`query.field.name` selector. E.g. {taxonomyCategoryFaq:' +
+                    '"taxonomyCategoryHelp", faq:"help"}.'),
+                field_map: z
+                    .record(z.string().min(1), z.string().min(1))
+                    .optional()
+                    .describe('Object of {old_field: new_field} LEAF field-name renames, ' +
+                    'applied to every `source.props.<p>.name` and ' +
+                    '`source_extended.props.<p>.name` token (e.g. {faq_title:' +
+                    '"help_title", faq_body:"help_body"}). Filters + sibling keys ' +
+                    'are preserved.'),
+                etag: ETAG,
+            },
+            outputSchema: RENAME_SOURCE_OUTPUT_SCHEMA,
+            annotations: mutating('Rename Source'),
+            handler: async ({ site_id, ...rest }) => withWriteSiteRetry(pool, site_id, 'yootheme_builder_rename_source', async (client, site) => withSiteMeta(await handleRenameSource(makeDeps(client), rest), site)),
         }),
         defineTool({
             name: 'yootheme_builder_element_unbind_source',
@@ -194,7 +448,7 @@ export function buildSourcesTools(pool, deps) {
                     'preview and the agent must retry with `confirm: true`.'),
             },
             annotations: destructive('Unbind Source'),
-            handler: async ({ site_id, ...rest }) => withSiteRetry(pool, site_id, async (client, site) => withSiteMeta(await handleElementUnbindSource(makeDeps(client), rest), site)),
+            handler: async ({ site_id, ...rest }) => withWriteSiteRetry(pool, site_id, 'yootheme_builder_element_unbind_source', async (client, site) => withSiteMeta(await handleElementUnbindSource(makeDeps(client), rest), site)),
         }),
     ];
 }

package/dist/tools/sources/builders.js.map

@@ -1 +1 @@
-{"version":3,"file":"builders.js","sourceRoot":"","sources":["../../../src/tools/sources/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACvF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACH,UAAU,EACV,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,YAAY,GAEf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,qBAAqB,EACrB,0BAA0B,EAE1B,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,GACpB,MAAM,eAAe,CAAC;AAEvB,MAAM,UAAU,iBAAiB,CAC7B,IAAgB,EAChB,IAAkC;IAElC,0DAA0D;IAC1D,+DAA+D;IAC/D,gCAAgC;IAChC,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,CAAC;IACtC,MAAM,QAAQ,GAAG,CAAC,UAAwC,EAAsB,EAAE,CAC9E,CAAC,WAAW,KAAK,SAAS;QACtB,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE;QACrC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IAElC,OAAO;QACH,UAAU,CAAC;YACP,IAAI,EAAE,+BAA+B;YACrC,WAAW,EACP,6EAA6E;gBAC7E,+EAA+E;gBAC/E,0FAA0F;gBAC1F,gEAAgE;gBAChE,0FAA0F;gBAC1F,mFAAmF;gBACnF,uDAAuD;gBACvD,0DAA0D;YAC9D,WAAW,EAAE;gBACT,OAAO,EAAE,cAAc;gBACvB,MAAM,EAAE,MAAM;gBACd,KAAK,EAAE,CAAC;qBACH,MAAM,EAAE;qBACR,GAAG,EAAE;qBACL,GAAG,CAAC,CAAC,CAAC;qBACN,GAAG,CAAC,GAAG,CAAC;qBACR,QAAQ,EAAE;qBACV,QAAQ,CAAC,4FAA4F,CAAC;gBAC3G,MAAM,EAAE,CAAC;qBACJ,MAAM,EAAE;qBACR,QAAQ,EAAE;qBACV,QAAQ,CAAC,gFAAgF,CAAC;gBAC/F,aAAa,EAAE,CAAC;qBACX,MAAM,EAAE;qBACR,QAAQ,EAAE;qBACV,QAAQ,CAAC,gFAAgF,CAAC;gBAC/F,KAAK,EAAE,CAAC;qBACH,MAAM,EAAE;qBACR,QAAQ,EAAE;qBACV,QAAQ,CAAC,8EAA8E,CAAC;gBAC7F,IAAI,EAAE,CAAC;qBACF,MAAM,EAAE;qBACR,QAAQ,EAAE;qBACV,QAAQ,CAAC,0FAA0F,CAAC;gBACzG,SAAS,EAAE,SAAS;aACvB;YACD,YAAY,EAAE,0BAA0B;YACxC,WAAW,EAAE,QAAQ,CAAC,cAAc,CAAC;YACrC,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CACpC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAChD,YAAY,CAAC,MAAM,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;SAC/E,CAAC;QAEF,UAAU,CAAC;YACP,IAAI,EAAE,sCAAsC;YAC5C,WAAW,EACP,0EAA0E;gBAC1E,2EAA2E;gBAC3E,oFAAoF;gBACpF,0DAA0D;YAC9D,WAAW,EAAE;gBACT,OAAO,EAAE,cAAc;gBACvB,WAAW,EAAE,WAAW;gBACxB,YAAY,EAAE,YAAY;aAC7B;YACD,YAAY,EAAE,qBAAqB;YACnC,WAAW,EAAE,QAAQ,CAAC,oBAAoB,CAAC;YAC3C,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CACpC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAChD,YAAY,CAAC,MAAM,uBAAuB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;SACrF,CAAC;QAEF,UAAU,CAAC;YACP,IAAI,EAAE,sCAAsC;YAC5C,WAAW,EACP,8EAA8E;gBAC9E,sEAAsE;gBACtE,mCAAmC;gBACnC,gEAAgE;gBAChE,kEAAkE;gBAClE,kEAAkE;gBAClE,8DAA8D;gBAC9D,kEAAkE;gBAClE,mEAAmE;gBACnE,oEAAoE;gBACpE,+EAA+E;gBAC/E,wEAAwE;gBACxE,wCAAwC;gBACxC,gDAAgD;gBAChD,2EAA2E;gBAC3E,gCAAgC;gBAChC,0DAA0D;YAC9D,WAAW,EAAE;gBACT,OAAO,EAAE,cAAc;gBACvB,WAAW,EAAE,WAAW;gBACxB,YAAY,EAAE,YAAY;gBAC1B,WAAW,EAAE,CAAC;qBACT,MAAM,EAAE;qBACR,GAAG,CAAC,CAAC,CAAC;qBACN,QAAQ,CACL,yDAAyD;oBACrD,yCAAyC,CAChD;gBACL,SAAS,EAAE,CAAC;qBACP,MAAM,EAAE;qBACR,QAAQ,EAAE;qBACV,QAAQ,CACL,0DAA0D;oBACtD,iDAAiD,CACxD;gBACL,cAAc,EAAE,CAAC;qBACZ,MAAM,CACH,CAAC,CAAC,MAAM,EAAE;gBACV,sDAAsD;gBACtD,kDAAkD;gBAClD,iDAAiD;gBACjD,uDAAuD;gBACvD,sCAAsC;gBACtC,wCAAwC;gBACxC,wDAAwD;gBACxD,CAAC,CAAC,KAAK,CAAC;oBACJ,CAAC,CAAC,MAAM,EAAE;oBACV,CAAC;yBACI,MAAM,CAAC;wBACJ,IAAI,EAAE,CAAC;6BACF,MAAM,EAAE;6BACR,GAAG,CAAC,CAAC,CAAC;6BACN,QAAQ,CAAC,wCAAwC,CAAC;wBACvD,OAAO,EAAE,CAAC;6BACL,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;6BAC/B,QAAQ,EAAE;6BACV,QAAQ,CACL,yCAAyC;4BACrC,kDAAkD;4BAClD,4CAA4C;4BAC5C,qCAAqC;4BACrC,yCAAyC,CAChD;qBACR,CAAC;yBACD,MAAM,EAAE;iBAChB,CAAC,CACL;qBACA,QAAQ,EAAE;qBACV,QAAQ,CACL,wEAAwE;oBACpE,2DAA2D;oBAC3D,6DAA6D;oBAC7D,oEAAoE;oBACpE,qEAAqE;oBACrE,mEAAmE;oBACnE,mEAAmE;oBACnE,uEAAuE;oBACvE,wEAAwE;oBACxE,sEAAsE;oBACtE,kEAAkE;oBAClE,+CAA+C;oBAC/C,+DAA+D;oBAC/D,8DAA8D;oBAC9D,+DAA+D;oBAC/D,gEAAgE;oBAChE,qEAAqE;oBACrE,oEAAoE;oBACpE,oEAAoE;oBACpE,wCAAwC;oBACxC,oEAAoE;oBACpE,oEAAoE;oBACpE,kCAAkC,CACzC;gBACL,YAAY,EAAE,CAAC;qBACV,IAAI,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;qBACnC,QAAQ,EAAE;qBACV,QAAQ,CACL,2EAA2E;oBACvE,wEAAwE;oBACxE,wEAAwE;oBACxE,0DAA0D,CACjE;gBACL,IAAI,EAAE,IAAI;aACb;YACD,WAAW,EAAE,QAAQ,CAAC,aAAa,CAAC;YACpC,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CACpC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAChD,YAAY,CAAC,MAAM,uBAAuB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;SACrF,CAAC;QAEF,UAAU,CAAC;YACP,IAAI,EAAE,wCAAwC;YAC9C,WAAW,EACP,gFAAgF;gBAChF,4EAA4E;gBAC5E,kCAAkC;gBAClC,0DAA0D;YAC9D,WAAW,EAAE;gBACT,OAAO,EAAE,cAAc;gBACvB,WAAW,EAAE,WAAW;gBACxB,YAAY,EAAE,YAAY;gBAC1B,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,CAAC;qBACL,OAAO,EAAE;qBACT,QAAQ,EAAE;qBACV,QAAQ,CACL,qEAAqE;oBACjE,iEAAiE;oBACjE,wDAAwD,CAC/D;aACR;YACD,WAAW,EAAE,WAAW,CAAC,eAAe,CAAC;YACzC,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CACpC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAChD,YAAY,CAAC,MAAM,yBAAyB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;SACvF,CAAC;KACL,CAAC;AACN,CAAC"}
+{"version":3,"file":"builders.js","sourceRoot":"","sources":["../../../src/tools/sources/builders.ts"],"names":[],"mappings":"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"}

package/dist/tools/sources/handlers-bind.d.ts

@@ -8,6 +8,7 @@
  *
  * @license MIT
  */
+import { z } from 'zod';
 import { type ToolResult } from '../tool-builder.js';
 import type { SourcesHandlerDeps } from './handlers.js';
 /**
@@ -22,6 +23,16 @@ export type FieldMappingValue = string | {
     name: string;
     filters?: Record<string, unknown>;
 };
+/**
+ * B5 (Glöckle onboarding, 2026-06-27) — a GraphQL directive on the relation
+ * `query.field` selector. Mirrors the `directives` zod array in `./builders.ts`;
+ * forwarded verbatim — the PHP SourcesController normalises + persists it under
+ * `query.field.directives`.
+ */
+export interface BindDirective {
+    name: string;
+    arguments?: Record<string, unknown>;
+}
 export declare function handleElementBindSource({ client, elicitation }: SourcesHandlerDeps, input: {
     template_id: string;
     element_path: string;
@@ -30,6 +41,11 @@ export declare function handleElementBindSource({ client, elicitation }: Sources
     etag: string;
     bindingLevel?: 'auto' | 'container' | 'item';
     field_mappings?: Record<string, FieldMappingValue>;
+    relation?: string;
+    field?: string;
+    arguments?: Record<string, unknown>;
+    directives?: readonly BindDirective[];
+    query_arguments?: Record<string, unknown>;
 }): Promise<ToolResult>;
 export declare function handleElementUnbindSource({ client, elicitation }: SourcesHandlerDeps, input: {
     template_id: string;
@@ -37,4 +53,95 @@ export declare function handleElementUnbindSource({ client, elicitation }: Sourc
     etag: string;
     confirm?: boolean;
 }): Promise<ToolResult>;
+/**
+ * F2 (Glöckle HANDOFF-4) — the `element_set_source` 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 `SourcesController::set_source` returns is
+ * `{template_id, element_path, etag, new_etag, changed_paths}` — EVERY key here
+ * must be DECLARED, else a strict MCP host -32602-rejects the success (the G2
+ * `changed_paths` lesson).
+ */
+export declare const ELEMENT_SET_SOURCE_OUTPUT_SCHEMA: z.ZodObject<{
+    template_id: z.ZodString;
+    element_path: z.ZodString;
+    etag: z.ZodString;
+    new_etag: z.ZodString;
+    changed_paths: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * One YT-Pro `source_extended.props` field-mapping (the native item-level
+ * carrier). Mirrors the `source_extended.props` value-shape in `./builders.ts`;
+ * forwarded VERBATIM — the PHP SourcesController writes it byte-identical (no
+ * normalization).
+ */
+export interface SetSourcePropMapping {
+    query?: {
+        name: string;
+    };
+    name?: string;
+    filters?: Record<string, unknown>;
+}
+/**
+ * F2 — surgically set a PRECOMPOSED `source` (+ optional `source_extended`) onto
+ * ONE element at a pointer, ETag-locked, leaving the rest of the layout
+ * byte-unchanged. The two carriers are author-composed objects forwarded
+ * VERBATIM to `PUT /pages/<id>/elements/<path>/source`; the PHP controller is the
+ * single place that persists them onto `node.source` / `node.source_extended`.
+ */
+export declare function handleElementSetSource({ client }: SourcesHandlerDeps, input: {
+    template_id: string;
+    element_path: string;
+    etag: string;
+    source?: {
+        query: {
+            name: string;
+            field?: {
+                name: string;
+                arguments?: Record<string, unknown>;
+                directives?: readonly BindDirective[];
+            };
+            arguments?: Record<string, unknown>;
+        };
+        props?: Record<string, unknown>;
+    };
+    source_extended?: {
+        props: Record<string, SetSourcePropMapping>;
+    } | null;
+}): Promise<ToolResult>;
+/**
+ * N1 (Glöckle HANDOFF-5) — the `rename_source` 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 `SourcesController::rename_source` returns is
+ * `{template_id, replaced_count, changed_paths, etag, new_etag}` — EVERY key here
+ * must be DECLARED, else a strict MCP host -32602-rejects the success (the G2
+ * `changed_paths` lesson).
+ */
+export declare const RENAME_SOURCE_OUTPUT_SCHEMA: z.ZodObject<{
+    template_id: z.ZodString;
+    replaced_count: z.ZodNumber;
+    changed_paths: z.ZodArray<z.ZodString>;
+    etag: z.ZodString;
+    new_etag: z.ZodString;
+}, z.core.$strip>;
+/**
+ * N1 — TEMPLATE-WIDE rename every matching binding's source-name + field-name
+ * tokens in ONE ETag-locked write. The rename spec (the single-source shorthand
+ * `from`/`to` and/or the explicit `source_map`/`field_map`) is forwarded VERBATIM
+ * to `PUT /pages/<id>/rename-source`; the PHP controller is the single place that
+ * runs the SourceRenamer engine across the whole template, preserving every
+ * binding's arguments / props / field_mappings and leaving non-matching bindings
+ * byte-identical.
+ */
+export declare function handleRenameSource({ client }: SourcesHandlerDeps, input: {
+    template_id: string;
+    etag: string;
+    from?: string;
+    to?: string;
+    source_map?: Record<string, string>;
+    field_map?: Record<string, string>;
+}): Promise<ToolResult>;
 //# sourceMappingURL=handlers-bind.d.ts.map

package/dist/tools/sources/handlers-bind.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers-bind.d.ts","sourceRoot":"","sources":["../../../src/tools/sources/handlers-bind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAeH,OAAO,EAIH,KAAK,UAAU,EAClB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAyMxD;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GACvB,MAAM,GACN;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAE1D,wBAAsB,uBAAuB,CACzC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,kBAAkB,EAC3C,KAAK,EAAE;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CACtD,GACF,OAAO,CAAC,UAAU,CAAC,CAgIrB;AAID,wBAAsB,yBAAyB,CAC3C,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,kBAAkB,EAC3C,KAAK,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACtF,OAAO,CAAC,UAAU,CAAC,CAoCrB"}
+{"version":3,"file":"handlers-bind.d.ts","sourceRoot":"","sources":["../../../src/tools/sources/handlers-bind.ts"],"names":[],"mappings":"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"}