rpgmaker-mz-mcp 1.0.0

package/dist/tools/objectTools.js.map

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

package/dist/tools/paintTools.d.ts

@@ -0,0 +1,3 @@
+import { ToolDefinition } from '../registry.js';
+export declare const paintToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=paintTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paintTools.d.ts","sourceRoot":"","sources":["../../src/tools/paintTools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAoGhD,eAAO,MAAM,oBAAoB,EAAE,cAAc,EAkEhD,CAAC"}

package/dist/tools/paintTools.js

@@ -0,0 +1,134 @@
+import { z } from 'zod';
+import { getMapPath } from '../utils/fileHandler.js';
+import { commitChange } from '../utils/commit.js';
+import { getMap, tileIndex } from './mapTools.js';
+import { applyAutotiling } from '../tiles/paint.js';
+import { isAutotile } from '../tiles/tileCodec.js';
+import { getTileset } from './tilesetTools.js';
+import { baseAwareTransparencyWarning } from './tileTransparency.js';
+/** The 6 z-layers: 0-1 lower tiles, 2-3 upper tiles, 4 shadow, 5 region id. */
+const MAX_LAYER = 5;
+/** Layers that hold real tiles (autotiles only make sense here). */
+const TILE_LAYERS = 4;
+/** A LayerAccess bound to one z-layer of a map's flat `data` array (mutates in place). */
+function layerAccess(map, layer) {
+    return {
+        width: map.width,
+        height: map.height,
+        get: (x, y) => map.data[tileIndex(map.width, map.height, x, y, layer)],
+        set: (x, y, tileId) => {
+            map.data[tileIndex(map.width, map.height, x, y, layer)] = tileId;
+        },
+    };
+}
+/**
+ * Paint tiles onto a map layer, then autotile: each painted cell is set to the
+ * given tile id and — for autotiles — every painted cell and its neighbours get
+ * their shape recomputed from same-kind adjacency. Out-of-bounds cells are
+ * skipped with a warning. Writes through the commit choke point (dry-run/diff).
+ */
+async function paintCells(projectPath, mapId, cells, layer) {
+    const map = await getMap(projectPath, mapId);
+    const grid = layerAccess(map, layer);
+    const warnings = [];
+    const painted = [];
+    let sawAutotile = false;
+    for (const cell of cells) {
+        if (cell.x < 0 || cell.x >= map.width || cell.y < 0 || cell.y >= map.height) {
+            warnings.push(`(${cell.x}, ${cell.y}) is out of bounds (${map.width}x${map.height}) — skipped`);
+            continue;
+        }
+        grid.set(cell.x, cell.y, cell.tileId);
+        painted.push({ x: cell.x, y: cell.y, tileId: cell.tileId });
+        if (isAutotile(cell.tileId))
+            sawAutotile = true;
+    }
+    // Autotiles only shape correctly on the tile layers (0-3); shadow/region don't
+    // hold tiles. Flag it but still paint (the caller may know what they're doing).
+    if (sawAutotile && layer >= TILE_LAYERS) {
+        warnings.push(`layer ${layer} is not a tile layer (0-3) — autotile shapes will not render as expected`);
+    }
+    applyAutotiling(grid, painted);
+    // Base-aware transparency check (tile layers only — shadow/region hold no tiles):
+    // a see-through tile with no opaque tile beneath shows the map's void. Advisory
+    // only — a missing/unreadable tileset must never break a paint, so fail soft.
+    if (layer < TILE_LAYERS && painted.length > 0) {
+        try {
+            const tileset = await getTileset(projectPath, map.tilesetId);
+            const warning = await baseAwareTransparencyWarning(projectPath, map, tileset, painted.map((c) => ({ ...c, layer })));
+            if (warning)
+                warnings.push(warning);
+        }
+        catch {
+            // No tileset / unreadable sheets → skip the advisory transparency warning.
+        }
+    }
+    await commitChange(getMapPath(projectPath, mapId), map);
+    return warnings.length > 0
+        ? { mapId, layer, painted: painted.length, warnings }
+        : { mapId, layer, painted: painted.length };
+}
+export const paintToolDefinitions = [
+    {
+        name: 'paint_tiles',
+        mutates: true,
+        description: "Paint specific tiles onto a map, with automatic autotiling. Each cell is set to its tile id; if that id is an autotile (A1-A4, e.g. a catalog 'kind' base from find_tile), its shape and its neighbours' shapes are recomputed from same-kind adjacency so borders/corners line up. Flat tiles are painted as-is. Defaults to the lower ground layer (0). Higher-level than set_map_tile, which is a single raw tile with no autotiling.",
+        inputSchema: {
+            mapId: z.number().int().describe('The ID of the map'),
+            tiles: z
+                .array(z.object({
+                x: z.number().int().describe('X tile position'),
+                y: z.number().int().describe('Y tile position'),
+                tileId: z
+                    .number()
+                    .int()
+                    .nonnegative()
+                    .describe('Tile id to paint (autotile base id from find_tile, or a raw id)'),
+            }))
+                .min(1)
+                .describe('Cells to paint'),
+            layer: z
+                .number()
+                .int()
+                .min(0)
+                .max(MAX_LAYER)
+                .optional()
+                .describe('Z-layer 0-5 (default 0 = lower ground; 0-3 tiles, 4 shadow, 5 region id)'),
+        },
+        handler: (ctx, args) => paintCells(ctx.projectPath, args.mapId, args.tiles, args.layer ?? 0),
+    },
+    {
+        name: 'fill_area',
+        mutates: true,
+        description: 'Fill a rectangular area of a map with one tile id, with automatic autotiling — a filled autotile region borders itself correctly (and re-borders any same-kind tiles it touches). Flat tiles fill uniformly. Defaults to the lower ground layer (0). For region ids, fill layer 5 with the region number as tileId.',
+        inputSchema: {
+            mapId: z.number().int().describe('The ID of the map'),
+            x: z.number().int().describe('Left tile position of the rectangle'),
+            y: z.number().int().describe('Top tile position of the rectangle'),
+            width: z.number().int().positive().describe('Rectangle width in tiles'),
+            height: z.number().int().positive().describe('Rectangle height in tiles'),
+            tileId: z
+                .number()
+                .int()
+                .nonnegative()
+                .describe('Tile id to fill with (autotile base or raw)'),
+            layer: z
+                .number()
+                .int()
+                .min(0)
+                .max(MAX_LAYER)
+                .optional()
+                .describe('Z-layer 0-5 (default 0 = lower ground; 5 = region id)'),
+        },
+        handler: (ctx, args) => {
+            const cells = [];
+            for (let dy = 0; dy < args.height; dy++) {
+                for (let dx = 0; dx < args.width; dx++) {
+                    cells.push({ x: args.x + dx, y: args.y + dy, tileId: args.tileId });
+                }
+            }
+            return paintCells(ctx.projectPath, args.mapId, cells, args.layer ?? 0);
+        },
+    },
+];
+//# sourceMappingURL=paintTools.js.map

package/dist/tools/paintTools.js.map

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

package/dist/tools/pluginScanTools.d.ts

@@ -0,0 +1,22 @@
+import { ToolDefinition } from '../registry.js';
+import { PluginRegistry } from '../validation/pluginCommands.js';
+/** Reset the scan cache. Exposed for tests. */
+export declare function clearPluginScanCache(): void;
+/**
+ * Scan a project's installed plugins into a {@link PluginRegistry}.
+ *
+ * Cached by the `js/plugins` directory mtime, so repeated tool calls in a session
+ * don't re-read every plugin (mirrors the tile-sheet alpha cache). Note the mtime
+ * only changes when files are added/removed — an *edited* plugin needs a fresh
+ * session, which is fine: plugin annotations don't change mid-authoring.
+ */
+export declare function scanPlugins(projectPath: string): Promise<PluginRegistry>;
+/**
+ * The registry the plugin tools validate against: everything scanned from the
+ * project merged over the built-in allowlist. See {@link mergePluginRegistries} —
+ * the scan wins on structure, but a curated `required` flag survives, since the
+ * annotations it came from can't express one.
+ */
+export declare function projectPluginRegistry(projectPath: string): Promise<PluginRegistry>;
+export declare const pluginScanToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=pluginScanTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pluginScanTools.d.ts","sourceRoot":"","sources":["../../src/tools/pluginScanTools.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,cAAc,EAA2B,MAAM,iCAAiC,CAAC;AA6B1F,+CAA+C;AAC/C,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAMD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAsD9E;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAExF;AAED,eAAO,MAAM,yBAAyB,EAAE,cAAc,EA0CrD,CAAC"}

package/dist/tools/pluginScanTools.js

@@ -0,0 +1,119 @@
+import { z } from 'zod';
+import { readdir, readFile, stat } from 'fs/promises';
+import { join } from 'path';
+import { PLUGIN_COMMAND_REGISTRY } from '../validation/pluginCommands.js';
+import { parsePluginAnnotations, parsePluginsJs, mergePluginRegistries, } from '../validation/pluginManifest.js';
+const cache = new Map();
+/** Reset the scan cache. Exposed for tests. */
+export function clearPluginScanCache() {
+    cache.clear();
+}
+function pluginsDir(projectPath) {
+    return join(projectPath, 'js', 'plugins');
+}
+/**
+ * Scan a project's installed plugins into a {@link PluginRegistry}.
+ *
+ * Cached by the `js/plugins` directory mtime, so repeated tool calls in a session
+ * don't re-read every plugin (mirrors the tile-sheet alpha cache). Note the mtime
+ * only changes when files are added/removed — an *edited* plugin needs a fresh
+ * session, which is fine: plugin annotations don't change mid-authoring.
+ */
+export async function scanPlugins(projectPath) {
+    const dir = pluginsDir(projectPath);
+    let mtimeMs;
+    try {
+        mtimeMs = (await stat(dir)).mtimeMs;
+    }
+    catch {
+        return {}; // No js/plugins dir — not every project has plugins.
+    }
+    const cached = cache.get(projectPath);
+    if (cached && cached.mtimeMs === mtimeMs)
+        return cached.registry;
+    // Which plugins the editor has installed/enabled. Absent or unparseable →
+    // enabled stays unknown rather than being reported as disabled.
+    let manifest = null;
+    try {
+        const source = await readFile(join(projectPath, 'js', 'plugins.js'), 'utf-8');
+        const entries = parsePluginsJs(source);
+        manifest = new Map(entries.map((e) => [e.name, e.status]));
+    }
+    catch {
+        manifest = null;
+    }
+    let files;
+    try {
+        files = (await readdir(dir)).filter((f) => f.endsWith('.js'));
+    }
+    catch {
+        return {};
+    }
+    const registry = {};
+    for (const file of files.sort()) {
+        const name = file.replace(/\.js$/, '');
+        let source;
+        try {
+            source = await readFile(join(dir, file), 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const spec = parsePluginAnnotations(source);
+        if (!spec)
+            continue;
+        registry[name] = {
+            ...spec,
+            // A plugin file present on disk but absent from plugins.js isn't installed
+            // in the editor, so it won't run either — same as being switched off.
+            ...(manifest ? { enabled: manifest.get(name) === true } : {}),
+        };
+    }
+    cache.set(projectPath, { mtimeMs, registry });
+    return registry;
+}
+/**
+ * The registry the plugin tools validate against: everything scanned from the
+ * project merged over the built-in allowlist. See {@link mergePluginRegistries} —
+ * the scan wins on structure, but a curated `required` flag survives, since the
+ * annotations it came from can't express one.
+ */
+export async function projectPluginRegistry(projectPath) {
+    return mergePluginRegistries(PLUGIN_COMMAND_REGISTRY, await scanPlugins(projectPath));
+}
+export const pluginScanToolDefinitions = [
+    {
+        name: 'scan_plugins',
+        description: "Discover the plugin commands this project actually has, by parsing the @command/@arg annotations in js/plugins/*.js and the enabled/disabled state in js/plugins.js. Use it to find out what create_plugin_command can call and with which args — it reports every command's key, label, description and args (name/type/default), plus whether the plugin is enabled in the editor's Plugin Manager (a disabled plugin's commands never run). create_plugin_command validates against this scan automatically, so you don't need to call this first; it's for discovery. Pass pluginName to narrow to one plugin, or enabledOnly:true to skip plugins that are installed but switched off. Read-only. NOTE: MZ has no 'required argument' annotation, so scanned args are checked for unknown names only, never for missing ones.",
+        inputSchema: {
+            pluginName: z
+                .string()
+                .optional()
+                .describe('Optional: restrict to one plugin (its filename without .js)'),
+            enabledOnly: z
+                .boolean()
+                .optional()
+                .describe('Only report plugins enabled in js/plugins.js (default false)'),
+        },
+        handler: async (ctx, args) => {
+            const scanned = await scanPlugins(ctx.projectPath);
+            let plugins = Object.entries(scanned);
+            if (args.pluginName !== undefined) {
+                plugins = plugins.filter(([name]) => name === args.pluginName);
+                if (plugins.length === 0) {
+                    throw new Error(`Plugin "${args.pluginName}" was not found in js/plugins (or declares no annotation block)`);
+                }
+            }
+            if (args.enabledOnly === true) {
+                plugins = plugins.filter(([, spec]) => spec.enabled !== false);
+            }
+            const commandCount = plugins.reduce((total, [, spec]) => total + Object.keys(spec.commands).length, 0);
+            return {
+                pluginCount: plugins.length,
+                commandCount,
+                plugins: Object.fromEntries(plugins),
+            };
+        },
+    },
+];
+//# sourceMappingURL=pluginScanTools.js.map

package/dist/tools/pluginScanTools.js.map

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

package/dist/tools/pluginTools.d.ts

@@ -0,0 +1,11 @@
+import { ToolDefinition } from '../registry.js';
+import { PluginRegistry } from '../validation/pluginCommands.js';
+/**
+ * Every plugin command known for this project — the plugins it actually ships
+ * (scanned from `js/plugins/*.js`) merged over the built-in allowlist — or a
+ * single plugin's entry when `pluginName` is given. Read-only view so a caller can
+ * discover which plugin commands `create_plugin_command` will validate.
+ */
+export declare function listPluginCommands(registry: PluginRegistry, pluginName?: string): unknown;
+export declare const pluginToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=pluginTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pluginTools.d.ts","sourceRoot":"","sources":["../../src/tools/pluginTools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EACL,cAAc,EAGf,MAAM,iCAAiC,CAAC;AAGzC;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAWzF;AAED,eAAO,MAAM,qBAAqB,EAAE,cAAc,EA0DjD,CAAC"}

package/dist/tools/pluginTools.js

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+import { buildPluginCommand, validatePluginCommand, } from '../validation/pluginCommands.js';
+import { projectPluginRegistry } from './pluginScanTools.js';
+/**
+ * Every plugin command known for this project — the plugins it actually ships
+ * (scanned from `js/plugins/*.js`) merged over the built-in allowlist — or a
+ * single plugin's entry when `pluginName` is given. Read-only view so a caller can
+ * discover which plugin commands `create_plugin_command` will validate.
+ */
+export function listPluginCommands(registry, pluginName) {
+    if (pluginName === undefined) {
+        return registry;
+    }
+    const plugin = registry[pluginName];
+    if (!plugin) {
+        throw new Error(`Plugin "${pluginName}" is not installed in this project and is not in the known-plugin allowlist`);
+    }
+    return { [pluginName]: plugin };
+}
+export const pluginToolDefinitions = [
+    {
+        name: 'list_plugin_commands',
+        description: 'List every plugin command create_plugin_command can validate (plugin filename → command key → args): the plugins this project actually ships, scanned from their js/plugins/*.js annotations, merged over a small built-in allowlist. Pass pluginName to narrow to one plugin. Read-only. Use scan_plugins for the richer per-project view (arg types/defaults, enabled state); an unlisted plugin command can still be built, it just isn’t validated.',
+        inputSchema: {
+            pluginName: z
+                .string()
+                .optional()
+                .describe('Optional: restrict to one plugin (its filename without .js)'),
+        },
+        handler: async (ctx, args) => listPluginCommands(await projectPluginRegistry(ctx.projectPath), args.pluginName),
+    },
+    {
+        name: 'create_plugin_command',
+        description: 'Build an RPG Maker MZ plugin command (event command code 357) for insertion into an event page via add_event_command. Validates against the plugins this project actually ships (scanned from their js/plugins/*.js @command/@arg annotations) merged over a small built-in allowlist — warn-by-default: an unknown plugin/command, a stray arg, or a plugin that is installed but disabled in js/plugins.js produces a warning but never blocks. Args are normalized to the editor’s string-valued shape. Read-only: returns { command, warnings? }, writes nothing.',
+        inputSchema: {
+            pluginName: z.string().describe('Plugin filename without .js (event command parameters[0])'),
+            commandName: z
+                .string()
+                .describe('The command key the plugin registered (event command parameters[1])'),
+            args: z
+                .record(z.string(), z.unknown())
+                .optional()
+                .describe('Command arguments as { name: value }; values are stored as strings on disk'),
+            label: z
+                .string()
+                .optional()
+                .describe('Editor display label (parameters[2]); defaults to the command key'),
+            indent: z
+                .number()
+                .int()
+                .optional()
+                .describe('Indentation level in the target list (default 0)'),
+        },
+        handler: async (ctx, args) => {
+            const argValues = args.args ?? {};
+            const registry = await projectPluginRegistry(ctx.projectPath);
+            const command = buildPluginCommand(args.pluginName, args.commandName, argValues, args.indent ?? 0, args.label, registry);
+            const warnings = validatePluginCommand(args.pluginName, args.commandName, argValues, undefined, registry);
+            return warnings.length > 0 ? { command, warnings } : { command };
+        },
+    },
+];
+//# sourceMappingURL=pluginTools.js.map

package/dist/tools/pluginTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginTools.js","sourceRoot":"","sources":["../../src/tools/pluginTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAEL,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAwB,EAAE,UAAmB;IAC9E,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,WAAW,UAAU,6EAA6E,CACnG,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAqB;IACrD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,ybAAyb;QAC3b,WAAW,EAAE;YACX,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,6DAA6D,CAAC;SAC3E;QACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,CAC3B,kBAAkB,CAAC,MAAM,qBAAqB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC;KACpF;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EACT,uiBAAuiB;QACziB,WAAW,EAAE;YACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;YAC5F,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,CAAC,qEAAqE,CAAC;YAClF,IAAI,EAAE,CAAC;iBACJ,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;iBAC/B,QAAQ,EAAE;iBACV,QAAQ,CAAC,4EAA4E,CAAC;YACzF,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,mEAAmE,CAAC;YAChF,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,CAAC,kDAAkD,CAAC;SAChE;QACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;YAC3B,MAAM,SAAS,GAAI,IAAI,CAAC,IAA4C,IAAI,EAAE,CAAC;YAC3E,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAC9D,MAAM,OAAO,GAAG,kBAAkB,CAChC,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,WAAW,EAChB,SAAS,EACT,IAAI,CAAC,MAAM,IAAI,CAAC,EAChB,IAAI,CAAC,KAAK,EACV,QAAQ,CACT,CAAC;YACF,MAAM,QAAQ,GAAG,qBAAqB,CACpC,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,WAAW,EAChB,SAAS,EACT,SAAS,EACT,QAAQ,CACT,CAAC;YACF,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;QACnE,CAAC;KACF;CACF,CAAC"}

package/dist/tools/projectTools.d.ts

@@ -0,0 +1,11 @@
+import { ToolDefinition } from '../registry.js';
+/**
+ * Project-targeting tools: inspect and retarget the project directory the
+ * server operates on. These are the only tools that run without a valid
+ * project path (`requiresProject: false`) — they're how a session diagnoses
+ * or fixes an unset/wrong RPGMAKER_PROJECT_PATH without a server restart.
+ */
+/** Expand a leading `~` and resolve to an absolute path. */
+export declare function normalizeProjectPath(input: string): string;
+export declare const projectToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=projectTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projectTools.d.ts","sourceRoot":"","sources":["../../src/tools/projectTools.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIhD;;;;;GAKG;AAEH,4DAA4D;AAC5D,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI1D;AA6BD,eAAO,MAAM,sBAAsB,EAAE,cAAc,EAiClD,CAAC"}

package/dist/tools/projectTools.js

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+import { homedir } from 'os';
+import { join, resolve } from 'path';
+import { validateProjectPath } from '../utils/fileHandler.js';
+import { getGameTitle } from './systemTools.js';
+/**
+ * Project-targeting tools: inspect and retarget the project directory the
+ * server operates on. These are the only tools that run without a valid
+ * project path (`requiresProject: false`) — they're how a session diagnoses
+ * or fixes an unset/wrong RPGMAKER_PROJECT_PATH without a server restart.
+ */
+/** Expand a leading `~` and resolve to an absolute path. */
+export function normalizeProjectPath(input) {
+    const expanded = input === '~' || input.startsWith('~/') ? join(homedir(), input.slice(1)) : input;
+    return resolve(expanded);
+}
+/** What both tools report: the path, whether it's usable, and the game it holds. */
+async function describeProject(projectPath) {
+    if (!projectPath) {
+        return {
+            projectPath: null,
+            valid: false,
+            hint: 'No project set. Call set_project or set RPGMAKER_PROJECT_PATH.',
+        };
+    }
+    if (!(await validateProjectPath(projectPath))) {
+        return {
+            projectPath,
+            valid: false,
+            hint: 'Not a valid RPG Maker MZ project (expected game.rmmzproject and data/System.json).',
+        };
+    }
+    // Title read fails soft: a valid project with an unreadable System.json
+    // shouldn't make the status tools themselves error.
+    let gameTitle;
+    try {
+        gameTitle = await getGameTitle(projectPath);
+    }
+    catch {
+        gameTitle = undefined;
+    }
+    return { projectPath, valid: true, ...(gameTitle === undefined ? {} : { gameTitle }) };
+}
+export const projectToolDefinitions = [
+    {
+        name: 'get_project',
+        description: 'Get the project directory the server is currently operating on: its path, whether it is a valid RPG Maker MZ project, and the game title it holds.',
+        inputSchema: {},
+        requiresProject: false,
+        handler: async (ctx) => describeProject(ctx.projectPath),
+    },
+    {
+        name: 'set_project',
+        description: 'Point the server at a different RPG Maker MZ project directory for the rest of the session (overrides RPGMAKER_PROJECT_PATH until the server restarts). The directory must contain game.rmmzproject and data/System.json.',
+        inputSchema: {
+            path: z
+                .string()
+                .describe('Path to the RPG Maker MZ project directory (a leading ~ is expanded).'),
+        },
+        requiresProject: false,
+        handler: async (ctx, args) => {
+            if (!ctx.setProjectPath) {
+                throw new Error('set_project is not supported by this server context');
+            }
+            const path = normalizeProjectPath(String(args.path));
+            if (!(await validateProjectPath(path))) {
+                throw new Error(`Not an RPG Maker MZ project: ${path} (expected game.rmmzproject and data/System.json)`);
+            }
+            ctx.setProjectPath(path);
+            return describeProject(path);
+        },
+    },
+];
+//# sourceMappingURL=projectTools.js.map

package/dist/tools/projectTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectTools.js","sourceRoot":"","sources":["../../src/tools/projectTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAGrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD;;;;;GAKG;AAEH,4DAA4D;AAC5D,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,MAAM,QAAQ,GACZ,KAAK,KAAK,GAAG,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACpF,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC3B,CAAC;AAED,oFAAoF;AACpF,KAAK,UAAU,eAAe,CAAC,WAAmB;IAChD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO;YACL,WAAW,EAAE,IAAI;YACjB,KAAK,EAAE,KAAK;YACZ,IAAI,EAAE,gEAAgE;SACvE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,mBAAmB,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QAC9C,OAAO;YACL,WAAW;YACX,KAAK,EAAE,KAAK;YACZ,IAAI,EAAE,oFAAoF;SAC3F,CAAC;IACJ,CAAC;IACD,wEAAwE;IACxE,oDAAoD;IACpD,IAAI,SAA6B,CAAC;IAClC,IAAI,CAAC;QACH,SAAS,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,SAAS,GAAG,SAAS,CAAC;IACxB,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;AACzF,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAqB;IACtD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,oJAAoJ;QACtJ,WAAW,EAAE,EAAE;QACf,eAAe,EAAE,KAAK;QACtB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC;KACzD;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,2NAA2N;QAC7N,WAAW,EAAE;YACX,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,CAAC,uEAAuE,CAAC;SACrF;QACD,eAAe,EAAE,KAAK;QACtB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;YAC3B,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;YACzE,CAAC;YACD,MAAM,IAAI,GAAG,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACrD,IAAI,CAAC,CAAC,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;gBACvC,MAAM,IAAI,KAAK,CACb,gCAAgC,IAAI,mDAAmD,CACxF,CAAC;YACJ,CAAC;YACD,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;YACzB,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;KACF;CACF,CAAC"}

package/dist/tools/skillTools.d.ts

@@ -0,0 +1,83 @@
+import { Skill } from '../utils/types.js';
+import { ToolDefinition } from '../registry.js';
+/**
+ * Get all skills from the project
+ */
+export declare function getSkills(projectPath: string): Promise<(Skill | null)[]>;
+/** The caller-supplied skill shape accepted by both `create_skill` and `batch_create`. */
+export interface SkillInput {
+    name: string;
+    description?: string;
+    iconIndex?: number;
+    mpCost?: number;
+    tpCost?: number;
+    scope?: number;
+    damage?: {
+        type: number;
+        elementId: number;
+        formula: string;
+        variance?: number;
+        critical?: boolean;
+    };
+    effects?: Array<{
+        code: number;
+        dataId: number;
+        value1: number;
+        value2: number;
+    }>;
+    animationId?: number;
+    message1?: string;
+    stypeId?: number;
+}
+/**
+ * Build one new skill record against the current array — the shared per-record
+ * source of truth for both `create_skill` and `batch_create`. Pure: allocates the
+ * next unused id (max existing + 1) and fills every unsupplied field with the
+ * new-skill default. Does not push or commit, and does not run the effect
+ * reference check (that needs cross-file reads) — the caller owns both.
+ */
+export declare function buildSkillRecord(existing: (Skill | null)[], input: SkillInput): Skill;
+/**
+ * Reject a skill/item whose effects point at a non-existent state / skill /
+ * common event (P2-3: throw at author time, like add_class_learning /
+ * create_troop). Shared by `create_skill` and `batch_create`.
+ */
+export declare function assertSkillEffectRefs(projectPath: string, skill: Skill, skills: (Skill | null)[]): Promise<void>;
+/**
+ * Create a new skill
+ */
+export declare function createSkill(projectPath: string, skillData: SkillInput): Promise<Skill>;
+/**
+ * Update a skill's data
+ */
+export declare function updateSkill(projectPath: string, skillId: number, updates: Partial<Skill>): Promise<Skill>;
+/**
+ * Delete a skill
+ */
+export declare function deleteSkill(projectPath: string, skillId: number): Promise<boolean>;
+/**
+ * Search skills by name
+ */
+export declare function searchSkills(projectPath: string, searchTerm: string): Promise<Skill[]>;
+/**
+ * Create a damage skill (attack spell or physical skill)
+ */
+export declare function createDamageSkill(projectPath: string, name: string, damageFormula: string, mpCost: number, scope: number, elementId?: number, description?: string): Promise<Skill>;
+/**
+ * Create a healing skill
+ */
+export declare function createHealingSkill(projectPath: string, name: string, healFormula: string, mpCost: number, scope: number, description?: string): Promise<Skill>;
+/**
+ * Create a buff skill
+ */
+export declare function createBuffSkill(projectPath: string, name: string, buffType: number, turns: number, mpCost: number, scope: number, description?: string): Promise<Skill>;
+/**
+ * Create a debuff skill
+ */
+export declare function createDebuffSkill(projectPath: string, name: string, debuffType: number, turns: number, mpCost: number, scope: number, description?: string): Promise<Skill>;
+/**
+ * Create a state-inflicting skill
+ */
+export declare function createStateSkill(projectPath: string, name: string, stateId: number, chance: number, mpCost: number, scope: number, description?: string): Promise<Skill>;
+export declare const skillToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=skillTools.d.ts.map

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

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