editmamei 1.7.1 → 1.8.0

package/dist/cli/config.js

@@ -50,6 +50,13 @@ const KEYS = {
         },
         coerce: coerceBool,
     },
+    'automation.allow_execute_script': {
+        get: (s) => s.automation.allow_execute_script,
+        set: (s, v) => {
+            s.automation.allow_execute_script = v;
+        },
+        coerce: coerceBool,
+    },
     ps_path: {
         get: (s) => s.ps_path,
         set: (s, v) => {

package/dist/core/settings.js

@@ -21,6 +21,7 @@ function defaults(installId) {
     return {
         telemetry: { usage: true, diagnostics: false, install_id: installId },
         privacy: { send_previews_to_llm: true },
+        automation: { allow_execute_script: true },
         ps_path: null,
         update_check: true,
         editor: 'auto',
@@ -34,6 +35,7 @@ function coerce(raw, installId) {
     const r = raw;
     const t = (r.telemetry ?? {});
     const p = (r.privacy ?? {});
+    const a = (r.automation ?? {});
     return {
         telemetry: {
             usage: typeof t.usage === 'boolean' ? t.usage : base.telemetry.usage,
@@ -47,6 +49,11 @@ function coerce(raw, installId) {
                 ? p.send_previews_to_llm
                 : base.privacy.send_previews_to_llm,
         },
+        automation: {
+            allow_execute_script: typeof a.allow_execute_script === 'boolean'
+                ? a.allow_execute_script
+                : base.automation.allow_execute_script,
+        },
         ps_path: typeof r.ps_path === 'string' ? r.ps_path : null,
         update_check: typeof r.update_check === 'boolean' ? r.update_check : base.update_check,
         editor: typeof r.editor === 'string' && EDITOR_PINS.includes(r.editor)

package/dist/core/tool-activity.js

@@ -1,3 +1,9 @@
+export const RECIPE_TOOLS = new Set([
+    'ps_template_apply',
+    'ps_batch',
+    'ps_sequence',
+    'ps_play_action',
+]);
 export const READ_ONLY_TOOLS = new Set([
     'ps_sequence',
     'ps_batch',
@@ -29,6 +35,7 @@ export const READ_ONLY_TOOLS = new Set([
     'gimp_get_preview',
     'gimp_get_histogram',
     'gimp_compare',
+    'gimp_get_selection_preview',
 ]);
 export const KEPT_WORK_TOOLS = new Set([
     'ps_export',
@@ -109,14 +116,19 @@ export const MUTATING_TOOLS = new Set([
     'gimp_crop_document',
     'gimp_resize_image',
     'gimp_transform_canvas',
-    'gimp_create_mask',
     'gimp_checkpoint',
     'gimp_layer',
     'gimp_bake',
     'gimp_create_document',
     'gimp_place_image',
     'gimp_canvas',
+    'gimp_text',
     'gimp_convert_image_mode',
+    'gimp_select',
+    'gimp_modify_selection',
+    'gimp_layer_mask',
+    'gimp_transform_layer',
+    'gimp_match_layer',
 ]);
 export const RAW_DEVELOP_TOOL = 'ps_develop_raw';
 export const CAMERA_RAW_TOOL = 'ps_apply_camera_raw';

package/dist/core/tool-groups.js

@@ -187,14 +187,20 @@ export const TOOL_GROUPS = {
     gimp_add_adjustment: 'adjust',
     gimp_filter: 'filter',
     gimp_add_effect: 'filter',
-    gimp_create_mask: 'masks',
     gimp_checkpoint: 'document',
     gimp_layer: 'layers',
     gimp_bake: 'layers',
+    gimp_transform_layer: 'layers',
     gimp_create_document: 'document',
     gimp_place_image: 'layers',
     gimp_canvas: 'document',
+    gimp_text: 'layers',
     gimp_convert_image_mode: 'document',
+    gimp_select: 'select',
+    gimp_modify_selection: 'select',
+    gimp_layer_mask: 'masks',
+    gimp_get_selection_preview: 'verify',
+    gimp_match_layer: 'layers',
 };
 export function groupOf(toolName) {
     const group = TOOL_GROUPS[toolName];

package/dist/core/tool-tiers.js

@@ -102,17 +102,23 @@ export const TOOL_TIERS = {
     gimp_crop_document: 'community',
     gimp_resize_image: 'community',
     gimp_transform_canvas: 'community',
-    gimp_create_mask: 'community',
     gimp_get_preview: 'community',
     gimp_get_histogram: 'community',
     gimp_compare: 'community',
     gimp_checkpoint: 'community',
     gimp_layer: 'community',
     gimp_bake: 'community',
+    gimp_transform_layer: 'community',
     gimp_create_document: 'community',
     gimp_place_image: 'community',
     gimp_canvas: 'community',
+    gimp_text: 'community',
     gimp_convert_image_mode: 'community',
+    gimp_select: 'community',
+    gimp_modify_selection: 'dev',
+    gimp_layer_mask: 'community',
+    gimp_get_selection_preview: 'community',
+    gimp_match_layer: 'dev',
 };
 export function tierOf(toolName) {
     const tier = TOOL_TIERS[toolName];

package/dist/modules/gimp/index.js

@@ -8,11 +8,14 @@ import { createGimpAdjustmentTools } from '../../tools/gimp-adjustment-tools.js'
 import { createGimpEffectTools } from '../../tools/gimp-effect-tools.js';
 import { createGimpFilterTools } from '../../tools/gimp-filter-tools.js';
 import { createGimpGeometryTools } from '../../tools/gimp-geometry-tools.js';
-import { createGimpMaskTools } from '../../tools/gimp-mask-tools.js';
 import { createGimpVerifyTools } from '../../tools/gimp-verify-tools.js';
 import { createGimpCheckpointTools } from '../../tools/gimp-checkpoint-tools.js';
 import { createGimpLayerTools } from '../../tools/gimp-layer-tools.js';
+import { createGimpTransformLayerTools } from '../../tools/gimp-transform-layer-tools.js';
 import { createGimpComposeTools } from '../../tools/gimp-compose-tools.js';
+import { createGimpTextTools } from '../../tools/gimp-text-tools.js';
+import { createGimpSelectionTools } from '../../tools/gimp-selection-tools.js';
+import { createGimpMatchTools } from '../../tools/gimp-match-tools.js';
 export const gimpFactories = [
     createGimpCoreTools,
     createGimpDocumentTools,
@@ -21,11 +24,14 @@ export const gimpFactories = [
     createGimpEffectTools,
     createGimpFilterTools,
     createGimpGeometryTools,
-    createGimpMaskTools,
     createGimpVerifyTools,
     createGimpCheckpointTools,
     createGimpLayerTools,
+    createGimpTransformLayerTools,
     createGimpComposeTools,
+    createGimpTextTools,
+    createGimpSelectionTools,
+    createGimpMatchTools,
 ];
 export const gimpModule = {
     manifest: { id: 'gimp', name: 'Editmamei GIMP Tools', abi: KERNEL_ABI },

package/dist/telemetry/sanitize.js

@@ -23,8 +23,22 @@ function homedirPrefixes() {
     return [...set];
 }
 const SINGLE_SEG_POSIX = /(^|\s)\/[^\s"'/]+(?=$|\s)/;
+const WORD = String.raw `[^\s"'\\/:]+`;
+const DIR = String.raw `${WORD}(?: ${WORD})*`;
+const TILDE_WORD = String.raw `[^\s"'\\/]+`;
+const TILDE_DIR = String.raw `${TILDE_WORD}(?: ${TILDE_WORD})*`;
+const POSIX_WORD = String.raw `[^\s"'/]+`;
+const POSIX_DIR = String.raw `${POSIX_WORD}(?: ${POSIX_WORD})*`;
+const PATH_TOKEN = new RegExp([
+    String.raw `[A-Za-z]:[\\/](?:${DIR}[\\/])*[^\s"']*`,
+    String.raw `\\\\(?:${DIR}[\\/])*[^\s"']+`,
+    String.raw `file:\/\/[^\s"']*`,
+    String.raw `(?<![\w~])~(?:[\\/]${TILDE_DIR}(?=[\\/]))*[\\/]${TILDE_WORD}[\\/]?`,
+    String.raw `\/${POSIX_WORD}(?:\/${POSIX_DIR}(?=\/))*\/${POSIX_WORD}\/?`,
+    String.raw `(?:^|\s)\/[^\s"'/]+(?=$|\s)`,
+].join('|'), 'gi');
 function basenamePaths(s) {
-    return s.replace(/[A-Za-z]:[\\/][^\s"']*|\\\\[^\s"']+|file:\/\/[^\s"']*|(?:\/[^\s"'/]+){2,}\/?|(?:^|\s)\/[^\s"'/]+(?=$|\s)/gi, (m) => {
+    return s.replace(PATH_TOKEN, (m) => {
         const single = SINGLE_SEG_POSIX.exec(m);
         if (single)
             return `${single[1]}/…`;

package/dist/tools/adjustment-tools.js

@@ -1,6 +1,7 @@
 import { runScript } from '../utils/run-script.js';
 import { validateArgs } from '../utils/validate.js';
 import { toolErrorResult, runSnippetTool, applyToActiveLayerProp } from '../utils/tool-helpers.js';
+import { looksLikePath, requireLocalPath } from '../utils/local-path.js';
 import { getPendingRawDevelop } from '../core/raw-develop-state.js';
 import { CAMERA_RAW_TOOL } from '../core/tool-activity.js';
 const addAdjustmentLayerSchema = {
@@ -802,6 +803,11 @@ const FORWARDED_KEYS = new Set([
     'pos_levels',
     'thr_level',
 ]);
+function lutNameOrPath(value) {
+    return typeof value === 'string' && looksLikePath(value)
+        ? requireLocalPath('cl_lut_name', value)
+        : value;
+}
 async function addAdjustmentLayer(connection, snippetClient, rawArgs) {
     try {
         const args = validateArgs(addAdjustmentLayerSchema, rawArgs);
@@ -816,6 +822,8 @@ async function addAdjustmentLayer(connection, snippetClient, rawArgs) {
             if (args[key] !== undefined)
                 params[key] = args[key];
         }
+        if (typeof params.cl_lut_name === 'string')
+            params.cl_lut_name = lutNameOrPath(params.cl_lut_name);
         if (type === 'color_lookup' && !params.cl_lut_name) {
             return {
                 content: [
@@ -875,7 +883,7 @@ async function applyColorLookup(connection, snippetClient, rawArgs) {
         snippet: 'applyColorLookup',
         errorPrefix: 'Error applying color lookup',
         params: (args) => ({
-            lutName: args.cl_lut_name,
+            lutName: lutNameOrPath(args.cl_lut_name),
             applyToActiveLayer: args.apply_to_active_layer ?? false,
         }),
         successText: (result) => `Color Lookup applied (BAKE, experimental):\n${JSON.stringify(result, null, 2)}`,

package/dist/tools/document-tools.js

@@ -2,6 +2,7 @@ import { runScript } from '../utils/run-script.js';
 import { validateArgs } from '../utils/validate.js';
 import { OPEN_DOCUMENT_TIMEOUT_MS, OPEN_DOCUMENT_REPROBE_TIMEOUT_MS, } from '../utils/operation-timeouts.js';
 import { toolErrorResult, runSnippetTool } from '../utils/tool-helpers.js';
+import { checkOutputPath, recordOutputPath, requireLocalPath } from '../utils/local-path.js';
 import { purgeSceneChannels } from '../perception/region-precompute.js';
 import { Logger } from '../utils/logger.js';
 const logger = new Logger('document-tools');
@@ -76,7 +77,7 @@ const openDocumentSchema = {
     properties: {
         file_path: {
             type: 'string',
-            description: 'Absolute path to the file to open',
+            description: "Absolute path to the file to open, on this computer's own drives (network shares are refused).",
         },
         suppress_dialogs: {
             type: 'boolean',
@@ -96,7 +97,14 @@ const savePsdSchema = {
     properties: {
         output_path: {
             type: 'string',
-            description: 'Absolute output path including filename, e.g. E:\\Photos\\Edit\\shell_01.psd',
+            description: 'Absolute output path including filename, ending in .psd, e.g. E:\\Photos\\Edit\\shell_01.psd',
+        },
+        overwrite: {
+            type: 'boolean',
+            description: 'Replace an existing file at output_path that this session did not write. Default false: such a ' +
+                'save is refused, so an original is never replaced by accident. Set true only when the user asked ' +
+                'to replace that file. A file this session already wrote can be saved over without it.',
+            default: false,
         },
         maximize_compatibility: {
             type: 'boolean',
@@ -116,7 +124,14 @@ const exportJpegSchema = {
     properties: {
         output_path: {
             type: 'string',
-            description: 'Absolute output path including filename.',
+            description: 'Absolute output path including filename, ending in .jpg.',
+        },
+        overwrite: {
+            type: 'boolean',
+            description: 'Replace an existing file at output_path that this session did not write. Default false: such a ' +
+                'save is refused, so an original is never replaced by accident. Set true only when the user asked ' +
+                'to replace that file. A file this session already wrote can be saved over without it.',
+            default: false,
         },
         quality: {
             type: 'integer',
@@ -149,7 +164,14 @@ const exportPngSchema = {
     properties: {
         output_path: {
             type: 'string',
-            description: 'Absolute output path including filename.',
+            description: 'Absolute output path including filename, ending in .png.',
+        },
+        overwrite: {
+            type: 'boolean',
+            description: 'Replace an existing file at output_path that this session did not write. Default false: such a ' +
+                'save is refused, so an original is never replaced by accident. Set true only when the user asked ' +
+                'to replace that file. A file this session already wrote can be saved over without it.',
+            default: false,
         },
         transparent_background: {
             type: 'boolean',
@@ -531,7 +553,7 @@ async function openDocumentPipeline(connection, snippetClient, rawArgs) {
     let filePath;
     try {
         const args = validateArgs(openDocumentSchema, rawArgs);
-        filePath = args.file_path;
+        filePath = requireLocalPath('file_path', args.file_path);
         const suppressDialogs = args.suppress_dialogs;
         const bitDepth = args.bit_depth;
         const script = await snippetClient.build('openDocumentPipeline', {
@@ -581,8 +603,13 @@ async function openDocumentPipeline(connection, snippetClient, rawArgs) {
 }
 async function savePsdPipeline(connection, snippetClient, rawArgs) {
     let args;
+    let outputPath;
     try {
         args = validateArgs(savePsdSchema, rawArgs);
+        outputPath = checkOutputPath('output_path', args.output_path, {
+            extensions: ['.psd'],
+            overwrite: args.overwrite === true,
+        });
     }
     catch (error) {
         return toolErrorResult('Error saving PSD', error);
@@ -605,11 +632,13 @@ async function savePsdPipeline(connection, snippetClient, rawArgs) {
         snippet: 'savePsdAsCopy',
         errorPrefix: 'Error saving PSD',
         params: (args) => ({
-            outputPath: args.output_path,
+            outputPath,
             maximizeCompat: args.maximize_compatibility,
         }),
         successText: (result) => `PSD saved:\n${JSON.stringify(result, null, 2)}`,
     });
+    if (!res.isError)
+        recordOutputPath(outputPath);
     if (!res.isError && typeof res.structuredContent === 'object' && res.structuredContent !== null) {
         res.structuredContent.scene_channels_purged = purged;
     }
@@ -618,7 +647,10 @@ async function savePsdPipeline(connection, snippetClient, rawArgs) {
 async function exportJpegPipeline(connection, snippetClient, rawArgs) {
     try {
         const args = validateArgs(exportJpegSchema, rawArgs);
-        const outputPath = args.output_path;
+        const outputPath = checkOutputPath('output_path', args.output_path, {
+            extensions: ['.jpg'],
+            overwrite: args.overwrite === true,
+        });
         const qualityPct = args.quality;
         const quality = Math.round((qualityPct / 100) * 12);
         const longEdgePx = args.long_edge_px;
@@ -630,6 +662,7 @@ async function exportJpegPipeline(connection, snippetClient, rawArgs) {
         const script = await snippetClient.build('exportJpegPipeline', params);
         const result = (await runScript(connection, script));
         const structured = { ...result, quality: qualityPct, quality_ps_scale: quality };
+        recordOutputPath(outputPath);
         return {
             content: [
                 {
@@ -645,7 +678,8 @@ async function exportJpegPipeline(connection, snippetClient, rawArgs) {
     }
 }
 async function exportPngPipeline(connection, snippetClient, rawArgs) {
-    return runSnippetTool({
+    let outputPath;
+    const res = await runSnippetTool({
         connection,
         snippetClient,
         rawArgs,
@@ -654,8 +688,12 @@ async function exportPngPipeline(connection, snippetClient, rawArgs) {
         errorPrefix: 'Error exporting PNG',
         params: (args) => {
             const longEdgePx = args.long_edge_px;
+            outputPath = checkOutputPath('output_path', args.output_path, {
+                extensions: ['.png'],
+                overwrite: args.overwrite === true,
+            });
             const params = {
-                outputPath: args.output_path,
+                outputPath,
                 transparentBg: args.transparent_background,
                 compression: args.compression,
             };
@@ -665,4 +703,7 @@ async function exportPngPipeline(connection, snippetClient, rawArgs) {
         },
         successText: (result) => `PNG exported:\n${JSON.stringify(result, null, 2)}`,
     });
+    if (!res.isError && outputPath !== undefined)
+        recordOutputPath(outputPath);
+    return res;
 }

package/dist/tools/filter-tools.js

@@ -3,6 +3,7 @@ import { validateArgs } from '../utils/validate.js';
 import { OnnxLandmarkDetectionClient } from '../detection/landmark-detection-client.js';
 import { resolveGatedPlacement, PLACEMENT_SCHEMA } from '../perception/grounding-locate.js';
 import { toolErrorResult, runSnippetTool, applyToActiveLayerProp, asSmartFilterProp, unknownDiscriminator, } from '../utils/tool-helpers.js';
+import { requireLocalPath } from '../utils/local-path.js';
 import { LAYER_BLEND_MODES } from '../utils/blend-modes.js';
 import { runSmartFilterOp } from './smart-object-tools.js';
 const gaussianBlurSchema = {
@@ -1652,7 +1653,7 @@ async function applyDisplace(connection, snippetClient, rawArgs) {
         snippet: 'applyDisplace',
         errorPrefix: 'Error applying Displace',
         params: (args) => ({
-            mapPath: args.map_path,
+            mapPath: requireLocalPath('map_path', args.map_path),
             horizontalScale: args.horizontal_scale ?? 10,
             verticalScale: args.vertical_scale ?? 10,
             displacementMap: args.displacement_map ?? 'stretch_to_fit',

package/dist/tools/gimp-adjustment-tools.js

@@ -55,7 +55,7 @@ const adjustSchema = {
         },
         mask: {
             type: 'string',
-            description: 'Name of a mask channel from gimp_create_mask, confining a NEW filter to it. Only valid ' +
+            description: 'Name of a saved selection channel, confining a NEW filter to it. Only valid ' +
                 "when creating (no filter_id) — a filter's mask is fixed at creation. ORDER MATTERS: " +
                 'straighten / flip / resize the canvas first (gimp_transform_canvas, gimp_resize_image), ' +
                 'then crop, THEN add masked adjustments — rotate, flip, and resize all refuse outright ' +
@@ -348,11 +348,11 @@ export function createGimpAdjustmentTools(gimp) {
                     'separate filters for red and blue rather than one filter for both; points are [input, ' +
                     'output] 0-255 pairs including the endpoints. hue_saturation and color_balance likewise ' +
                     'carry ONE `range` per filter. gaussian_blur: radius in pixels at full resolution; ' +
-                    'combine with a mask from gimp_create_mask for soft-focus or background-blur effects. A ' +
+                    'combine with a saved-selection mask for soft-focus or background-blur effects. A ' +
                     "re-edit (filter_id) MERGES: any field you omit keeps the filter's existing value, so " +
                     "re-editing {contrast: 50} on a brightness_contrast filter doesn't reset brightness. Only " +
                     'filters Editmamei created can be re-edited; one added in the GIMP GUI is refused (delete ' +
-                    'and re-create it). `mask` (a channel name from gimp_create_mask) confines a NEW filter ' +
+                    'and re-create it). `mask` (a saved selection channel name) confines a NEW filter ' +
                     '— fixed at creation, cannot change on a re-edit. ORDER MATTERS: straighten / flip / ' +
                     'resize the canvas first, then crop, THEN add any masked adjustment — rotate, flip, and ' +
                     'resize all refuse outright once a masked adjustment filter exists, or any filter not ' +

package/dist/tools/gimp-core-tools.js

@@ -145,13 +145,12 @@ workflow avoids.
 
 ## Masks
 
-\`gimp_create_mask\` builds a geometric mask (rectangle / ellipse /
-gradient) into a NAMED channel. Pass that name as \`mask\` when you
-CREATE a filter with \`gimp_add_adjustment\` or \`gimp_add_effect\` to
-confine it. A filter's
-mask is fixed at creation — re-editing it by \`filter_id\` cannot
-change which mask it uses; delete and re-create it with a new mask
-instead.
+A selection can be saved into a NAMED channel. Pass the name of a
+channel saved in the image as \`mask\` when you CREATE a filter
+with \`gimp_add_adjustment\` or \`gimp_add_effect\` to confine it.
+A filter's mask is fixed at creation — re-editing it by
+\`filter_id\` cannot change which mask it uses; delete and
+re-create it with a new mask instead.
 
 ## Order matters: geometry before masked adjustments
 
@@ -169,7 +168,7 @@ every geometry op.
 ## Layers and composites
 
 A filter applies to ONE layer. \`gimp_layer\` creates, groups, reorders,
-moves and restyles layers and merges or flattens them;
+and restyles layers and merges or flattens them;
 \`gimp_place_image\` adds another file as a new layer;
 \`gimp_create_document\` starts a blank canvas. Address layers by the
 \`layer_id\` these tools and \`gimp_inspect\` report — names can repeat.

package/dist/tools/gimp-document-tools.js

@@ -40,7 +40,10 @@ async function gimpOpenDocument(gimp, rawArgs) {
                     type: 'text',
                     text: `Opened ${basename(filePath)} as image ${result.image} ` +
                         `(${result.width}x${result.height}, ${result.base_type}, ${result.precision}). ` +
-                        `${result.layers.length} layer(s): ${result.layers.join(', ') || '(none)'}.`,
+                        `${result.layers.length} layer(s): ${result.layers.join(', ') || '(none)'}.` +
+                        (result.orientation_applied !== undefined
+                            ? ` Rotated upright for EXIF orientation ${result.orientation_applied}.`
+                            : ''),
                 },
             ],
             structuredContent: result,

package/dist/tools/gimp-effect-tools.js

@@ -41,7 +41,7 @@ const effectSchema = {
         layer_id: GIMP_LAYER_ID_PROP,
         mask: {
             type: 'string',
-            description: 'Name of a mask channel from gimp_create_mask, confining a NEW filter to it. Only valid ' +
+            description: 'Name of a saved selection channel, confining a NEW filter to it. Only valid ' +
                 "when creating (no filter_id) — a filter's mask is fixed at creation. ORDER MATTERS: " +
                 'straighten / flip / resize the canvas first (gimp_transform_canvas, gimp_resize_image), ' +
                 'then crop, THEN add masked effects — rotate, flip, and resize all refuse outright once ' +
@@ -230,7 +230,7 @@ export function createGimpEffectTools(gimp) {
                     'or `layer`, else the selected or top layer), not to the flattened image. A re-edit ' +
                     "(filter_id) MERGES: any field you omit keeps the filter's existing value. Only " +
                     'filters Editmamei created can be re-edited; one added in the GIMP GUI is refused ' +
-                    '(delete and re-create it). `mask` (a channel name from gimp_create_mask) confines a ' +
+                    '(delete and re-create it). `mask` (a saved selection channel name) confines a ' +
                     'NEW filter — fixed at creation, cannot change on a re-edit. ORDER MATTERS: straighten ' +
                     '/ flip / resize the canvas first, then crop, THEN add any masked effect — rotate, ' +
                     'flip, and resize all refuse outright once a masked filter exists, or any filter not ' +

package/dist/tools/gimp-geometry-tools.js

@@ -38,7 +38,7 @@ const resizeSchema = {
     },
     required: ['image'],
 };
-const EFFECT_UPDATE_FAILURES_PROP = {
+export const EFFECT_UPDATE_FAILURES_PROP = {
     type: 'array',
     items: { type: 'string' },
     description: 'Names of effect filters (position/direction/size-dependent ones tracked through geometry ' +
@@ -75,7 +75,7 @@ const transformCanvasSchema = {
     },
     required: ['image', 'op'],
 };
-function effectUpdateFailuresNote(failures) {
+export function effectUpdateFailuresNote(failures) {
     if (!failures || failures.length === 0)
         return '';
     const plural = failures.length > 1;

package/dist/tools/gimp-inspect-tools.js

@@ -1,7 +1,7 @@
 import { validateArgs } from '../utils/validate.js';
 import { toolGimpErrorResult, unknownDiscriminator } from '../utils/tool-helpers.js';
 import { pickSchemaDeclaredKeys } from './gimp-shared.js';
-const INSPECT_WHATS = ['documents', 'document', 'layers', 'channels', 'filter'];
+const INSPECT_WHATS = ['documents', 'document', 'layers', 'channels', 'filter', 'fonts'];
 const inspectSchema = {
     type: 'object',
     properties: {
@@ -20,12 +20,19 @@ const inspectSchema = {
                 "allows duplicate layer names) and flag `is_text_layer`. 'document'/'layers' cap the tree " +
                 'at 2000 nodes total and report `truncated: true` if the cap was hit, alongside ' +
                 '`top_level_count` and `total_nodes`; if it times out the GIMP session restarts and ' +
-                'unsaved work is lost, so save (gimp_save_xcf) first.',
+                "unsaved work is lost, so save (gimp_save_xcf) first. A text layer's node also reports " +
+                "its text, font, font_size (points), color and alignment. 'fonts' lists the installed " +
+                'font names (no image needed), optionally narrowed by `filter`.',
         },
         image: {
             type: 'integer',
             description: 'Image id, as returned by gimp_open_document. Required for every `what` except ' +
-                "'documents'.",
+                "'documents' and 'fonts'.",
+        },
+        filter: {
+            type: 'string',
+            description: "what='fonts' only: case-insensitive substring to narrow the font names by. The list is " +
+                'sorted and capped at 200 names; `total` counts every match.',
         },
         filter_id: {
             type: 'integer',
@@ -75,6 +82,22 @@ async function gimpInspect(gimp, rawArgs) {
                 structuredContent: { what, documents },
             };
         }
+        if (what === 'fonts') {
+            const result = await gimp.call('fonts', pickSchemaDeclaredKeys(inspectSchema, args));
+            const shown = result.fonts.length;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `${result.total} font(s) installed` +
+                            (args.filter ? ` matching "${String(args.filter).slice(0, 100)}"` : '') +
+                            (shown < result.total ? `, showing the first ${shown}` : '') +
+                            `: ${result.fonts.join(', ') || '(none)'}.`,
+                    },
+                ],
+                structuredContent: { what, ...result },
+            };
+        }
         if (what === 'document' || what === 'layers' || what === 'channels' || what === 'filter') {
             const result = await gimp.call('describe', pickSchemaDeclaredKeys(inspectSchema, args));
             return {
@@ -100,8 +123,11 @@ export function createGimpInspectTools(gimp) {
                     "WITH coverage (selected_pixels/fraction), the cost 'document' skips, and can stop " +
                     'early on a document with many named channels (`truncated: true`, `channels_skipped`). ' +
                     "'filter' describes one filter by filter_id, in the same shape gimp_filter (op=list) " +
-                    'reports it in. Layer tree nodes are addressed by `layer_id` (canonical — GIMP allows ' +
-                    "duplicate layer names) and flag `is_text_layer`. 'document'/'layers' cap the tree at " +
+                    "reports it in. 'fonts' lists the installed font names (no image needed), sorted, " +
+                    'optionally narrowed by `filter` (substring), capped at 200 with a `total`. Layer tree ' +
+                    'nodes are addressed by `layer_id` (canonical — GIMP allows duplicate layer names) and ' +
+                    "flag `is_text_layer`; a text layer's node also reports its text, font, font_size " +
+                    "(points), color and alignment. 'document'/'layers' cap the tree at " +
                     '2000 nodes total and report `truncated: true` if the cap was hit, alongside ' +
                     '`top_level_count` and `total_nodes`; if it times out the GIMP session restarts and ' +
                     'unsaved work is lost, so save (gimp_save_xcf) first.',
@@ -110,6 +136,10 @@ export function createGimpInspectTools(gimp) {
                     type: 'object',
                     properties: {
                         what: { type: 'string' },
+                        fonts: { type: 'array', items: { type: 'string' } },
+                        total: { type: 'number' },
+                        returned: { type: 'number' },
+                        default: { type: ['string', 'null'] },
                         documents: {
                             type: 'array',
                             items: { type: 'object', properties: { image: { type: 'number' } } },