@wootsup/yt-builder-mcp 1.12.0 → 2.0.0

package/dist/tools/modules/modules-create.js

@@ -0,0 +1,154 @@
+import { z } from 'zod';
+import { RestError } from '../../errors.js';
+import { foreignFieldMessage, foreignFieldsFor, MODULE_TYPE_FIELDS } from './module-type-fields.js';
+import { PHASE_CONFIRM, PHASE_SEND, PHASE_SERVER } from '../progress-phases.js';
+import { SITE_ID_SCHEMA } from '../shared-schemas.js';
+import { FIELD_HINTS, hintFor, PLACEMENT_HINTS } from './placement-hints.js';
+import { createProgressReporter, errorResult, jsonResult, } from '../tool-builder.js';
+export const MODULES_CREATE_INPUT = {
+    site_id: SITE_ID_SCHEMA,
+    type: z
+        .enum(['custom_html', 'text', 'block', 'mod_custom', 'mod_menu'])
+        .describe('WordPress: custom_html (title+content), text (title+text), block (content only, NO ' +
+        'title). Joomla: mod_custom (title+content COLUMN+showtitle), mod_menu (title+params — ' +
+        'see menutype/base/startLevel/… below). An unknown type is rejected with this exact list. ' +
+        'These lists are EXACT: a field belonging to another type (e.g. `content` with ' +
+        'type:"text") is refused BEFORE anything is sent, and nothing is created.'),
+    title: z
+        .string()
+        .optional()
+        .describe('WordPress custom_html/text; Joomla mod_custom/mod_menu. Stored byte-identical.'),
+    content: z
+        .string()
+        .optional()
+        .describe('WordPress custom_html (HTML) / block (block markup, e.g. "<!-- wp:paragraph -->…"). ' +
+        'Joomla mod_custom (the CONTENT COLUMN, not params). Stored byte-for-byte — never ' +
+        'sanitized; a "dangerous"-looking value is REJECTED, never rewritten.'),
+    text: z.string().optional().describe('WordPress text widget ONLY. Stored byte-identical.'),
+    position: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('The template position / widget area this module or widget goes into. Validated '
+        + 'SERVER-side against the positions this site has declared or registered, so an '
+        + 'unknown value is refused BY NAME rather than silently parking the module where '
+        + 'nothing renders it. REQUIRED, never defaulted, for placement:"position" (a real '
+        + 'theme position: top, bottom, navbar, ...) and for placement:"position_element" '
+        + '(builder-1..builder-6; a builder position renders nothing on its own, only '
+        + 'through a module_position element). '
+        + 'REQUIRED on WORDPRESS for placement:"module_element" too, where it takes '
+        + 'builder-1..builder-6. If a call of yours worked without one until now, nothing '
+        + 'was wrong with it: the tool used to fill in builder-1 for you and no longer '
+        + 'does. Those six are the only areas that placement takes, because a real theme '
+        + 'position would show the widget site wide through the position and again through '
+        + 'your element, which is refused as placement_position_conflict. On JOOMLA the '
+        + 'same placement takes no position at all, because a module with none is a native '
+        + 'state there. '
+        + 'An empty string is refused here rather than treated as a value: on create it would '
+        + 'say exactly what leaving the field out says, so leave it out. On modules_update '
+        + 'Joomla accepts it, where it means "clear the position", and WordPress refuses it '
+        + 'there too, because a widget exists only inside a registered area.'
+        + ' When the server cannot vouch for the value — the site list was not readable from '
+        + 'here AND the name is not one of builder-1..builder-6 — it is stored anyway and the '
+        + 'answer carries position_verified:false. That field is ABSENT both when the value '
+        + 'was vouched for and when no position was stored, so read would_create.position to tell '
+        + 'those two apart; it is empty only in the second case. A dry_run never carries it.'
+        + ' On the plugin\'s own MCP transport a large answer is trimmed to a response budget '
+        + 'and would_create can be dropped, this flag being far smaller than it; a dropped '
+        + 'key is always named in omitted_keys, so check there before reading an absent '
+        + 'would_create as "no position was stored".'
+        + ' The answer also carries element_refs: the layout elements that will render this '
+        + 'module the moment it exists, each as {layout_id, path, via}. via:"element" means '
+        + 'an element already names this id — WordPress reuses a deleted widget\'s number, so '
+        + 'a new widget can inherit a reference nobody meant for it. via:"position" means an '
+        + 'element already renders the position you are creating into, which needs no reuse '
+        + 'at all and is the common case. The field is ALWAYS present, and [] means no '
+        + 'LAYOUT ELEMENT references it. It does NOT mean nothing renders it: a template '
+        + 'position declared by the active theme is rendered by the CMS itself, with no '
+        + 'element involved, and that path is invisible here. A dry_run reports it too, '
+        + 'which is where it is most useful; on Joomla a dry_run can only report '
+        + 'via:"position", because the module id is assigned by the database at insert '
+        + 'time and does not exist yet.'),
+    showtitle: z
+        .boolean()
+        .optional()
+        .describe('Joomla mod_custom ONLY. Omit to take the database\'s own default.'),
+    menutype: z.string().optional().describe('Joomla mod_menu ONLY — the menu to render (params.menutype).'),
+    base: z.number().int().optional().describe('Joomla mod_menu ONLY — params.base.'),
+    startLevel: z.number().int().optional().describe('Joomla mod_menu ONLY — params.startLevel.'),
+    endLevel: z.number().int().optional().describe('Joomla mod_menu ONLY — params.endLevel.'),
+    showAllChildren: z
+        .number()
+        .int()
+        .optional()
+        .describe('Joomla mod_menu ONLY — params.showAllChildren (0 or 1).'),
+    tag_id: z.string().optional().describe('Joomla mod_menu ONLY — params.tag_id.'),
+    class_sfx: z.string().optional().describe('Joomla mod_menu ONLY — params.class_sfx.'),
+    window_open: z.string().optional().describe('Joomla mod_menu ONLY — params.window_open.'),
+    layout: z.string().optional().describe('Joomla mod_menu ONLY — params.layout.'),
+    moduleclass_sfx: z.string().optional().describe('Joomla mod_menu ONLY — params.moduleclass_sfx.'),
+    cache: z.number().int().optional().describe('Joomla mod_menu ONLY — params.cache (0 or 1).'),
+    cache_time: z.number().int().optional().describe('Joomla mod_menu ONLY — params.cache_time.'),
+    cachemode: z.string().optional().describe('Joomla mod_menu ONLY — params.cachemode.'),
+    placement: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('REQUIRED: how this module reaches a page. position = a template position/widget area '
+        + '(Joomla: shown on chosen pages via menu assignment; WordPress: needs a plugin for '
+        + 'per-page visibility). module_element = embedded by a Module/Widget element inside a '
+        + 'column of ONE page layout. position_element = placed in builder-1..6 and rendered by '
+        + 'a Position/Area element. A call without it (or an unrecognised value) creates NOTHING: '
+        + 'the SERVER refuses with `ways` (every way for this platform, each with its reach and '
+        + 'a summary) and `notes`.'),
+    dry_run: z
+        .boolean()
+        .optional()
+        .describe('DEFAULT true — a call without it creates NOTHING, returning a preview (type, position, ' +
+        'fields). Pass false to persist.'),
+};
+export async function handleModulesCreate(client, input, extra) {
+    const { dry_run, ...rest } = input;
+    const foreign = foreignFieldsFor(input.type, rest);
+    if (foreign.length > 0) {
+        return errorResult({
+            error: new RestError({
+                status: 400,
+                code: 'yootheme_builder_mcp.modules.invalid_field',
+                message: foreignFieldMessage(input.type, foreign),
+                body: null,
+            }),
+            context: { type: input.type, fields: foreign.map((f) => f.field) },
+            hint: `Send only the fields "${input.type}" carries: `
+                + `${(MODULE_TYPE_FIELDS[input.type] ?? []).join(', ')}. `
+                + 'The five supported types and their fields are listed on the `type` argument.',
+        });
+    }
+    const progress = extra ? createProgressReporter(extra) : null;
+    await progress?.report(0, 3, PHASE_SEND);
+    await progress?.report(1, 3, PHASE_SERVER);
+    const body = { dry_run: dry_run ?? true };
+    for (const [key, value] of Object.entries(rest)) {
+        if (value !== undefined) {
+            body[key] = value;
+        }
+    }
+    try {
+        const data = await client.post('/modules', { body });
+        await progress?.report(3, 3, PHASE_CONFIRM);
+        return jsonResult(data);
+    }
+    catch (e) {
+        const code = e instanceof RestError ? (e.code ?? '') : '';
+        return errorResult({
+            error: e,
+            context: { type: input.type },
+            hint: hintFor(PLACEMENT_HINTS, code) ??
+                hintFor(FIELD_HINTS, code) ??
+                'On 400 invalid_field: the type is unknown OR the field is wrong for this ' +
+                    'type/platform (e.g. menutype on custom_html) — the error names every ' +
+                    'allowed type/field. A dry_run:true call never creates anything and is always safe to retry.',
+        });
+    }
+}
+//# sourceMappingURL=modules-create.js.map

package/dist/tools/modules/modules-create.js.map

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

package/dist/tools/modules/modules-delete.d.ts

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+import type { RestClient } from '../../client.js';
+import { type HandlerExtra, type ToolResult } from '../tool-builder.js';
+export declare const MODULES_DELETE_OUTPUT_SCHEMA: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+    deleted: z.ZodOptional<z.ZodBoolean>;
+    trashed: z.ZodOptional<z.ZodBoolean>;
+    row: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    usage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    blocking_element_refs: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    decision: z.ZodOptional<z.ZodString>;
+    notes: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    applied: z.ZodOptional<z.ZodBoolean>;
+    requires_intent: z.ZodOptional<z.ZodBoolean>;
+    given_intent: z.ZodOptional<z.ZodString>;
+    current_state: z.ZodOptional<z.ZodString>;
+    intents: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    instruction: z.ZodOptional<z.ZodString>;
+    preview: z.ZodOptional<z.ZodLiteral<true>>;
+    step_reversible: z.ZodOptional<z.ZodBoolean>;
+    host_prompt: z.ZodOptional<z.ZodEnum<{
+        preview_only_host_said_yes: "preview_only_host_said_yes";
+        preview_only_host_said_no: "preview_only_host_said_no";
+        preview_only_host_not_asked: "preview_only_host_not_asked";
+    }>>;
+    requires_confirm: z.ZodOptional<z.ZodLiteral<true>>;
+    requires_confirmation: z.ZodOptional<z.ZodLiteral<true>>;
+    operation: z.ZodOptional<z.ZodString>;
+    warning: z.ZodOptional<z.ZodString>;
+    hint: z.ZodOptional<z.ZodString>;
+    received_confirm: z.ZodOptional<z.ZodUnknown>;
+    received_confirm_type: z.ZodOptional<z.ZodString>;
+    expected_confirm: z.ZodOptional<z.ZodString>;
+}, z.core.$catchall<z.ZodUnknown>>;
+export declare const MODULES_DELETE_INPUT: {
+    site_id: z.ZodOptional<z.ZodString>;
+    id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    confirm: z.ZodOptional<z.ZodBoolean>;
+    intent: z.ZodOptional<z.ZodString>;
+    acknowledge_element_refs: z.ZodOptional<z.ZodBoolean>;
+};
+interface ModulesDeleteInput {
+    id: string | number;
+    confirm?: boolean;
+    intent?: string;
+    acknowledge_element_refs?: boolean;
+}
+export declare function handleModulesDelete(client: RestClient, input: ModulesDeleteInput, extra?: HandlerExtra): Promise<ToolResult>;
+export {};
+//# sourceMappingURL=modules-delete.d.ts.map

package/dist/tools/modules/modules-delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules-delete.d.ts","sourceRoot":"","sources":["../../../src/tools/modules/modules-delete.ts"],"names":[],"mappings":"AAwCA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAOlD,OAAO,EAKH,KAAK,YAAY,EACjB,KAAK,UAAU,EAClB,MAAM,oBAAoB,CAAC;AAgD5B,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCAyEf,CAAC;AAE3B,eAAO,MAAM,oBAAoB;;;;;;CA0DhC,CAAC;AAEF,UAAU,kBAAkB;IACxB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACtC;AAmJD,wBAAsB,mBAAmB,CACrC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,kBAAkB,EACzB,KAAK,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,UAAU,CAAC,CAqErB"}

package/dist/tools/modules/modules-delete.js

@@ -0,0 +1,180 @@
+import { z } from 'zod';
+import { RestError } from '../../errors.js';
+import { PHASE_CONFIRM, PHASE_SEND, PHASE_SERVER } from '../progress-phases.js';
+import { SITE_ID_SCHEMA } from '../shared-schemas.js';
+import { HOST_PROMPT_PROMISE } from '../tool-builder/confirm-preview.js';
+import { HOST_PROMPT_ANSWERS } from '../../proxy/confirm-question-contract.js';
+import { asModuleId, MODULE_ID_SCHEMA } from './module-id-schema.js';
+import { createProgressReporter, errorResult, jsonResult, structuredResult, } from '../tool-builder.js';
+export const MODULES_DELETE_OUTPUT_SCHEMA = z
+    .object({
+    id: z.string().optional(),
+    confirmed: z.boolean().optional(),
+    deleted: z.boolean().optional(),
+    trashed: z.boolean().optional(),
+    row: z.record(z.string(), z.unknown()).optional(),
+    usage: z.record(z.string(), z.unknown()).optional(),
+    blocking_element_refs: z.array(z.unknown()).optional(),
+    decision: z.string().optional(),
+    notes: z.array(z.unknown()).optional(),
+    applied: z.boolean().optional(),
+    requires_intent: z.boolean().optional(),
+    given_intent: z.string().optional(),
+    current_state: z.string().optional(),
+    intents: z.array(z.unknown()).optional(),
+    instruction: z.string().optional(),
+    preview: z.literal(true).optional(),
+    step_reversible: z.boolean().optional(),
+    host_prompt: z.enum(HOST_PROMPT_ANSWERS).optional(),
+    requires_confirm: z.literal(true).optional(),
+    requires_confirmation: z.literal(true).optional(),
+    operation: z.string().optional(),
+    warning: z.string().optional(),
+    hint: z.string().optional(),
+    received_confirm: z.unknown().optional(),
+    received_confirm_type: z.string().optional(),
+    expected_confirm: z.string().optional(),
+})
+    .catchall(z.unknown());
+export const MODULES_DELETE_INPUT = {
+    site_id: SITE_ID_SCHEMA,
+    id: MODULE_ID_SCHEMA.describe('The widget id (WordPress, e.g. "custom_html-2") or module id (Joomla, numeric, e.g. ' +
+        '"42") to remove. A bare number is accepted for the Joomla form. Letters, digits, ' +
+        '"_" and "-" only. Copy from yootheme_builder_local_content_read(kind:"modules") or ' +
+        'a page\'s modules_by_page (page_get_layout / pages_audit with include_modules:true).'),
+    confirm: z
+        .boolean()
+        .optional()
+        .describe('DEFAULT false — a call without it CHANGES NOTHING and returns a preview: the row as it ' +
+        'stands, usage.element_refs (every layout element referencing it), usage.assigned_pages, ' +
+        'and a note naming which step a confirm would perform. true executes the `intent` ' +
+        'chosen below — what that does for the CURRENT state rides in `intent`\'s own possible ' +
+        'values, not here. Read `trashed` and `deleted` in the response, both measured by ' +
+        'read-back, never echoed. Neither platform can recreate instance data afterwards ' +
+        '(modules_create makes a NEW id with default fields, not a restore). ' +
+        HOST_PROMPT_PROMISE),
+    intent: z
+        .string()
+        .optional()
+        .describe('What "remove" means here. Call without it once and the server lists the intents ' +
+        'possible for this module\'s CURRENT state, in the words of its CMS.'),
+    acknowledge_element_refs: z
+        .boolean()
+        .optional()
+        .describe('DEFAULT false. Only consulted when a confirmed call would be IRREVERSIBLE and at least ' +
+        'one DIRECT reference (usage.element_refs with via:"element" — a `module` element ' +
+        'naming this id) exists. Without it that call is REFUSED with a 409 naming every ' +
+        'stranded location, because the elements would be left pointing at nothing and no ' +
+        'other surface reports a dangling reference. With it it proceeds and the response ' +
+        'NAMES the dangling references it created — remove each with ' +
+        'yootheme_builder_element_delete. Joomla\'s TRASH step is reversible, so it is never ' +
+        'refused (a restore puts the reference back); the refusal applies to the second call, ' +
+        'the one that empties it from the trash. On WordPress the first call is already the ' +
+        'irreversible one. A via:"position" reference never blocks: it names a POSITION, not ' +
+        'this module.'),
+};
+function isRemovalIntent(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const v = value;
+    return (typeof v.intent === 'string'
+        && typeof v.effect === 'string'
+        && typeof v.reversible === 'boolean'
+        && typeof v.native_name === 'string'
+        && (v.restore_call === undefined
+            || v.restore_call === null
+            || typeof v.restore_call === 'string')
+        && (v.restore_state_note === undefined
+            || v.restore_state_note === null
+            || typeof v.restore_state_note === 'string'));
+}
+function undoFor(row) {
+    if (!row.reversible) {
+        return 'NOT reversible. Nothing restores this — neither this tool nor the CMS. '
+            + 'Copy anything you still need before choosing it.';
+    }
+    const restoreCall = typeof row.restore_call === 'string' && row.restore_call !== '' ? row.restore_call : null;
+    const stateNote = typeof row.restore_state_note === 'string' && row.restore_state_note !== ''
+        ? ` ${row.restore_state_note}`
+        : '';
+    if (restoreCall !== null) {
+        return `Reversible. The item is not gone — the CMS calls this "${row.native_name}", and `
+            + `${restoreCall} brings it back from there. The CMS can do it too, from the admin `
+            + `list for this item type.${stateNote}`;
+    }
+    return `Reversible. The item is not gone — the CMS calls this "${row.native_name}", and it is `
+        + 'restored in the CMS itself (the admin list for this item type, its restore action). '
+        + `This tool has no call that brings it back.${stateNote}`;
+}
+function intentDiscoveryFrom(e) {
+    if (!(e instanceof RestError) || e.status !== 400)
+        return null;
+    if (typeof e.code !== 'string' || !e.code.endsWith('.intent_not_chosen'))
+        return null;
+    const body = e.body;
+    if (body === null || typeof body !== 'object' || Array.isArray(body))
+        return null;
+    const root = body;
+    const nested = root.data;
+    const data = nested !== null && typeof nested === 'object' && !Array.isArray(nested)
+        ? nested
+        : root;
+    const raw = data.intents;
+    if (!Array.isArray(raw) || raw.length === 0 || !raw.every(isRemovalIntent))
+        return null;
+    const currentState = typeof data.current_state === 'string' ? data.current_state : null;
+    const notes = Array.isArray(data.notes)
+        ? data.notes.filter((n) => typeof n === 'string')
+        : [];
+    const payload = {
+        applied: false,
+        requires_intent: true,
+        ...(currentState !== null ? { current_state: currentState } : {}),
+        intents: raw.map((row) => ({ ...row, undo: undoFor(row) })),
+        ...(notes.length > 0 ? { notes } : {}),
+        instruction: 'Pick one `intent` from the list and call again with it (plus `confirm: true` to '
+            + 'execute). Read `undo` on the row you pick BEFORE choosing — it differs per row, and '
+            + 'for this object type it may differ from what another object type does.',
+    };
+    return structuredResult({ content: jsonResult(payload).content }, payload);
+}
+export async function handleModulesDelete(client, input, extra) {
+    const { id, confirm, intent, acknowledge_element_refs } = input;
+    const progress = extra ? createProgressReporter(extra) : null;
+    await progress?.report(0, 3, PHASE_SEND);
+    await progress?.report(1, 3, PHASE_SERVER);
+    const body = {
+        confirm: confirm ?? false,
+        acknowledge_element_refs: acknowledge_element_refs ?? false,
+    };
+    if (intent !== undefined) {
+        body.intent = intent;
+    }
+    try {
+        const data = await client.post(`/modules/${encodeURIComponent(asModuleId(id))}/delete`, { body });
+        await progress?.report(3, 3, PHASE_CONFIRM);
+        return structuredResult({ content: jsonResult(data).content }, data);
+    }
+    catch (e) {
+        const discovery = intentDiscoveryFrom(e);
+        if (discovery !== null)
+            return discovery;
+        return errorResult({
+            error: e,
+            context: { id },
+            hint: 'On 400 intent_not_chosen: pass `intent` — the error\'s `intents` names which values ' +
+                'are possible for this module\'s CURRENT state (`current_state`), each with its ' +
+                'effect/reversible/native_name; `notes` points at the non-removal alternative. ' +
+                'On 409 element_refs_present: layout elements still reference this module and the ' +
+                'message names each one — delete them with yootheme_builder_element_delete, or retry ' +
+                'with acknowledge_element_refs:true to accept the dangling references. On Joomla this ' +
+                'can only be the SECOND call (the one that empties the trash); the reversible trash ' +
+                'step is never refused. On 404: the id does not exist — re-check via ' +
+                'yootheme_builder_local_content_read(kind:"modules") rather than assuming it was ' +
+                'already deleted. On 503 the store could NOT BE READ, which says nothing about ' +
+                'whether the module exists — never treat it as "gone". A confirm:false call never ' +
+                'changes anything and is always safe to repeat.',
+        });
+    }
+}
+//# sourceMappingURL=modules-delete.js.map

package/dist/tools/modules/modules-delete.js.map

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

package/dist/tools/modules/modules-update.d.ts

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import type { RestClient } from '../../client.js';
+import { type HandlerExtra, type ToolResult } from '../tool-builder.js';
+export declare const MODULES_UPDATE_INPUT: {
+    site_id: z.ZodOptional<z.ZodString>;
+    id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    title: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodString>;
+    position: z.ZodOptional<z.ZodString>;
+    active: z.ZodOptional<z.ZodBoolean>;
+    showtitle: z.ZodOptional<z.ZodBoolean>;
+    ordering: z.ZodOptional<z.ZodNumber>;
+    access: z.ZodOptional<z.ZodNumber>;
+    assignment: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodEnum<{
+            none: "none";
+            selected: "selected";
+            all: "all";
+            except: "except";
+        }>;
+        menu_ids: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    }, z.core.$strip>>;
+    theme_overlay: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber]>>>;
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+};
+interface ModulesUpdateInput {
+    id: string | number;
+    title?: string;
+    position?: string;
+    active?: boolean;
+    showtitle?: boolean;
+    ordering?: number;
+    access?: number;
+    assignment?: {
+        mode: 'all' | 'none' | 'selected' | 'except';
+        menu_ids?: number[];
+    };
+    theme_overlay?: Record<string, string | boolean | number>;
+    dry_run?: boolean;
+}
+export declare function handleModulesUpdate(client: RestClient, input: ModulesUpdateInput, extra?: HandlerExtra): Promise<ToolResult>;
+export {};
+//# sourceMappingURL=modules-update.d.ts.map

package/dist/tools/modules/modules-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules-update.d.ts","sourceRoot":"","sources":["../../../src/tools/modules/modules-update.ts"],"names":[],"mappings":"AA8BA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAMlD,OAAO,EAIH,KAAK,YAAY,EACjB,KAAK,UAAU,EAClB,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;CAkPhC,CAAC;AAEF,UAAU,kBAAkB;IACxB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACnF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAsB,mBAAmB,CACrC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,kBAAkB,EACzB,KAAK,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,UAAU,CAAC,CA2ErB"}