rpgmaker-mz-mcp 1.0.0

package/dist/tools/battleTools.d.ts

@@ -0,0 +1,72 @@
+import { Enemy, Troop, TroopMember, TroopPage } from '../utils/types.js';
+import { ToolDefinition } from '../registry.js';
+import { ValidationWarning } from '../validation/eventCommands.js';
+import { PreCommit } from '../validation/gate.js';
+/**
+ * Blank enemy mirroring what the RPG Maker MZ editor writes for a freshly-created
+ * enemy: 100 HP, one "Attack" action, three empty drop slots, no traits. Pure so
+ * the template shape can be unit-tested. `params` order is
+ * [mhp, mmp, atk, def, mat, mdf, agi, luk].
+ */
+export declare function defaultEnemy(): Omit<Enemy, 'id'>;
+/**
+ * A blank troop battle-event page matching the editor's default: a "span whole
+ * battle" page with an empty (just the code-0 end marker) command list and the
+ * editor's default condition values (all toggles off).
+ */
+export declare function blankTroopPage(): TroopPage;
+/**
+ * Warn (never throw) when an enemy's `battlerName` isn't among the project's
+ * `img/enemies` assets — a wrong battler filename is a silent runtime failure (a
+ * blank/missing sprite in battle). Skips the check when the name is empty or the
+ * asset dir is empty/missing (nothing to validate against — e.g. a fixture), so it
+ * can't emit false positives. Mirrors `characterNameWarnings` (eventPageTools) and
+ * `audioNameWarnings` (eventCommandTools).
+ */
+export declare function battlerNameWarnings(projectPath: string, name: string | undefined): Promise<ValidationWarning[]>;
+/** Get all enemies from the project. */
+export declare function getEnemies(projectPath: string): Promise<(Enemy | null)[]>;
+/** Search enemies by name (case-insensitive). */
+export declare function searchEnemies(projectPath: string, searchTerm: string): Promise<Enemy[]>;
+/**
+ * Build one new enemy record against the current array — the shared per-record
+ * source of truth for both `create_enemy` and `batch_create`. Pure: template
+ * first, caller's defined fields next, computed id last so it always wins. Does
+ * not push, commit, or run the reference check (that needs cross-file reads).
+ */
+export declare function buildEnemyRecord(existing: (Enemy | null)[], input: Partial<Omit<Enemy, 'id'>>): Enemy;
+/**
+ * Reject an enemy whose actions/drops point at a non-existent db record (P2-3:
+ * throw at author time, matching create_troop's member.enemyId check). The
+ * battlerName stays a *warning* (an asset filename, not a db id). Shared by
+ * `create_enemy` and `batch_create`.
+ */
+export declare function assertEnemyRefs(projectPath: string, enemy: Enemy): Promise<void>;
+/**
+ * Create a new enemy. Only `name` is required; any omitted field falls back to
+ * the editor's new-enemy default (see {@link defaultEnemy}). Allocates the next
+ * unused id (max existing + 1) and writes through the commit choke point.
+ */
+export declare function createEnemy(projectPath: string, overrides: Partial<Omit<Enemy, 'id'>>): Promise<Enemy>;
+/** Update an existing enemy's properties (shallow merge). */
+export declare function updateEnemy(projectPath: string, enemyId: number, updates: Partial<Enemy>): Promise<Enemy>;
+/** Get all troops from the project. */
+export declare function getTroops(projectPath: string): Promise<(Troop | null)[]>;
+/** Search troops by name (case-insensitive). */
+export declare function searchTroops(projectPath: string, searchTerm: string): Promise<Troop[]>;
+/**
+ * Create a new troop. `name` is required; `members` defaults to empty and `pages`
+ * to a single blank battle-event page. Validates that each member references an
+ * existing enemy, allocates the next unused id, and writes through the commit
+ * choke point. The `precommit` hook (see `validation/gate.ts`) runs on the built
+ * troop just before the write, so a structurally invalid page can refuse it.
+ */
+export declare function createTroop(projectPath: string, options: {
+    name: string;
+    members?: TroopMember[];
+    pages?: TroopPage[];
+}, precommit?: PreCommit<Troop>): Promise<Troop>;
+/** Update an existing troop's properties (shallow merge). */
+export declare function updateTroop(projectPath: string, troopId: number, updates: Partial<Troop>, precommit?: PreCommit<Troop>): Promise<Troop>;
+export declare const battleToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=battleTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"battleTools.d.ts","sourceRoot":"","sources":["../../src/tools/battleTools.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAuB,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxF,OAAO,EAAE,SAAS,EAAa,MAAM,uBAAuB,CAAC;AAI7D;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAiBhD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,SAAS,CAmB1C;AAoBD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAM9B;AAaD,wCAAwC;AACxC,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAE/E;AAED,iDAAiD;AACjD,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAI7F;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,EAC1B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,GAChC,KAAK,CAOP;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAWtF;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,GACpC,OAAO,CAAC,KAAK,CAAC,CAShB;AAED,6DAA6D;AAC7D,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,GACtB,OAAO,CAAC,KAAK,CAAC,CAUhB;AAID,uCAAuC;AACvC,wBAAsB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAE9E;AAED,gDAAgD;AAChD,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAI5F;AAoBD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAA;CAAE,EACvE,SAAS,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,GAC3B,OAAO,CAAC,KAAK,CAAC,CAoBhB;AAED,6DAA6D;AAC7D,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EACvB,SAAS,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,GAC3B,OAAO,CAAC,KAAK,CAAC,CAkBhB;AASD,eAAO,MAAM,qBAAqB,EAAE,cAAc,EAsGjD,CAAC"}

package/dist/tools/battleTools.js

@@ -0,0 +1,322 @@
+import { z } from 'zod';
+import { readJsonFile, readJsonArraySoft, getDataPath } from '../utils/fileHandler.js';
+import { commitChange } from '../utils/commit.js';
+import { definedOnly } from '../utils/records.js';
+import { validateCommandList } from '../validation/eventCommands.js';
+import { writeGate } from '../validation/gate.js';
+import { firstMissingEnemyRef } from '../validation/createRefs.js';
+import { assetNameWarning } from './assetTools.js';
+/**
+ * Blank enemy mirroring what the RPG Maker MZ editor writes for a freshly-created
+ * enemy: 100 HP, one "Attack" action, three empty drop slots, no traits. Pure so
+ * the template shape can be unit-tested. `params` order is
+ * [mhp, mmp, atk, def, mat, mdf, agi, luk].
+ */
+export function defaultEnemy() {
+    return {
+        name: '',
+        battlerName: '',
+        battlerHue: 0,
+        params: [100, 0, 10, 10, 10, 10, 10, 10],
+        exp: 0,
+        gold: 0,
+        dropItems: [
+            { kind: 0, dataId: 1, denominator: 1 },
+            { kind: 0, dataId: 1, denominator: 1 },
+            { kind: 0, dataId: 1, denominator: 1 },
+        ],
+        actions: [{ conditionParam1: 0, conditionParam2: 0, conditionType: 0, rating: 5, skillId: 1 }],
+        traits: [],
+        note: '',
+    };
+}
+/**
+ * A blank troop battle-event page matching the editor's default: a "span whole
+ * battle" page with an empty (just the code-0 end marker) command list and the
+ * editor's default condition values (all toggles off).
+ */
+export function blankTroopPage() {
+    return {
+        conditions: {
+            actorHp: 50,
+            actorId: 1,
+            actorValid: false,
+            enemyHp: 50,
+            enemyIndex: 0,
+            enemyValid: false,
+            switchId: 1,
+            switchValid: false,
+            turnA: 0,
+            turnB: 0,
+            turnEnding: false,
+            turnValid: false,
+        },
+        list: [{ code: 0, indent: 0, parameters: [] }],
+        span: 0,
+    };
+}
+/**
+ * The pre-commit gate the troop-writing tools install. A troop's pages reuse the
+ * event-command `list` format, so the same command validator applies — and, as
+ * with map events, a structurally invalid page is refused before the write
+ * rather than saved and warned about.
+ */
+function troopWriteGate(force) {
+    return writeGate(force, 'troop', (troop) => {
+        const warnings = [];
+        if (Array.isArray(troop.pages)) {
+            troop.pages.forEach((page, i) => {
+                warnings.push(...validateCommandList(page?.list, `troop ${troop.id} / page ${i}`));
+            });
+        }
+        return warnings;
+    });
+}
+/**
+ * Warn (never throw) when an enemy's `battlerName` isn't among the project's
+ * `img/enemies` assets — a wrong battler filename is a silent runtime failure (a
+ * blank/missing sprite in battle). Skips the check when the name is empty or the
+ * asset dir is empty/missing (nothing to validate against — e.g. a fixture), so it
+ * can't emit false positives. Mirrors `characterNameWarnings` (eventPageTools) and
+ * `audioNameWarnings` (eventCommandTools).
+ */
+export async function battlerNameWarnings(projectPath, name) {
+    return assetNameWarning(projectPath, 'enemies', name, {
+        path: 'battlerName',
+        label: 'battler',
+        consequence: 'a wrong filename shows a blank sprite in battle',
+    });
+}
+/** Attach warn-by-default battler-asset validation to an enemy-write response. */
+async function withEnemyAssetWarnings(projectPath, enemy) {
+    const warnings = await battlerNameWarnings(projectPath, enemy.battlerName);
+    return warnings.length > 0 ? { enemy, warnings } : { enemy };
+}
+// --- Enemies ---------------------------------------------------------------
+/** Get all enemies from the project. */
+export async function getEnemies(projectPath) {
+    return await readJsonFile(getDataPath(projectPath, 'Enemies.json'));
+}
+/** Search enemies by name (case-insensitive). */
+export async function searchEnemies(projectPath, searchTerm) {
+    const enemies = await getEnemies(projectPath);
+    const lower = searchTerm.toLowerCase();
+    return enemies.filter((e) => !!e && e.name.toLowerCase().includes(lower));
+}
+/**
+ * Build one new enemy record against the current array — the shared per-record
+ * source of truth for both `create_enemy` and `batch_create`. Pure: template
+ * first, caller's defined fields next, computed id last so it always wins. Does
+ * not push, commit, or run the reference check (that needs cross-file reads).
+ */
+export function buildEnemyRecord(existing, input) {
+    const maxId = existing.reduce((max, e) => (e && e.id > max ? e.id : max), 0);
+    return {
+        ...defaultEnemy(),
+        ...definedOnly(input),
+        id: maxId + 1,
+    };
+}
+/**
+ * Reject an enemy whose actions/drops point at a non-existent db record (P2-3:
+ * throw at author time, matching create_troop's member.enemyId check). The
+ * battlerName stays a *warning* (an asset filename, not a db id). Shared by
+ * `create_enemy` and `batch_create`.
+ */
+export async function assertEnemyRefs(projectPath, enemy) {
+    const [skills, items, weapons, armors] = await Promise.all([
+        readJsonArraySoft(getDataPath(projectPath, 'Skills.json')),
+        readJsonArraySoft(getDataPath(projectPath, 'Items.json')),
+        readJsonArraySoft(getDataPath(projectPath, 'Weapons.json')),
+        readJsonArraySoft(getDataPath(projectPath, 'Armors.json')),
+    ]);
+    const missing = firstMissingEnemyRef(enemy, { skills, items, weapons, armors });
+    if (missing) {
+        throw new Error(`Cannot create enemy "${enemy.name}": ${missing}`);
+    }
+}
+/**
+ * Create a new enemy. Only `name` is required; any omitted field falls back to
+ * the editor's new-enemy default (see {@link defaultEnemy}). Allocates the next
+ * unused id (max existing + 1) and writes through the commit choke point.
+ */
+export async function createEnemy(projectPath, overrides) {
+    const enemies = await getEnemies(projectPath);
+    const enemy = buildEnemyRecord(enemies, overrides);
+    await assertEnemyRefs(projectPath, enemy);
+    enemies.push(enemy);
+    await commitChange(getDataPath(projectPath, 'Enemies.json'), enemies);
+    return enemy;
+}
+/** Update an existing enemy's properties (shallow merge). */
+export async function updateEnemy(projectPath, enemyId, updates) {
+    const enemies = await getEnemies(projectPath);
+    const index = enemies.findIndex((e) => e && e.id === enemyId);
+    if (index === -1) {
+        throw new Error(`Enemy with ID ${enemyId} not found`);
+    }
+    enemies[index] = { ...enemies[index], ...updates, id: enemyId };
+    await commitChange(getDataPath(projectPath, 'Enemies.json'), enemies);
+    return enemies[index];
+}
+// --- Troops ----------------------------------------------------------------
+/** Get all troops from the project. */
+export async function getTroops(projectPath) {
+    return await readJsonFile(getDataPath(projectPath, 'Troops.json'));
+}
+/** Search troops by name (case-insensitive). */
+export async function searchTroops(projectPath, searchTerm) {
+    const troops = await getTroops(projectPath);
+    const lower = searchTerm.toLowerCase();
+    return troops.filter((t) => !!t && t.name.toLowerCase().includes(lower));
+}
+/**
+ * Assert every troop member references an enemy that exists in Enemies.json, so a
+ * troop can't be created pointing at a non-existent enemy (mirrors create_map's
+ * parent check). Structural error → throws.
+ */
+async function assertMembersReferenceEnemies(projectPath, members) {
+    if (members.length === 0)
+        return;
+    const enemies = await getEnemies(projectPath);
+    for (const member of members) {
+        if (!enemies.some((e) => e && e.id === member.enemyId)) {
+            throw new Error(`Troop member references enemyId ${member.enemyId}, which does not exist`);
+        }
+    }
+}
+/**
+ * Create a new troop. `name` is required; `members` defaults to empty and `pages`
+ * to a single blank battle-event page. Validates that each member references an
+ * existing enemy, allocates the next unused id, and writes through the commit
+ * choke point. The `precommit` hook (see `validation/gate.ts`) runs on the built
+ * troop just before the write, so a structurally invalid page can refuse it.
+ */
+export async function createTroop(projectPath, options, precommit) {
+    const members = options.members ?? [];
+    await assertMembersReferenceEnemies(projectPath, members);
+    const troops = await getTroops(projectPath);
+    const maxId = troops.reduce((max, t) => (t && t.id > max ? t.id : max), 0);
+    const troop = {
+        id: maxId + 1,
+        name: options.name,
+        members,
+        pages: options.pages ?? [blankTroopPage()],
+    };
+    troops.push(troop);
+    await precommit?.(troop);
+    await commitChange(getDataPath(projectPath, 'Troops.json'), troops);
+    return troop;
+}
+/** Update an existing troop's properties (shallow merge). */
+export async function updateTroop(projectPath, troopId, updates, precommit) {
+    const troops = await getTroops(projectPath);
+    const index = troops.findIndex((t) => t && t.id === troopId);
+    if (index === -1) {
+        throw new Error(`Troop with ID ${troopId} not found`);
+    }
+    const merged = { ...troops[index], ...updates, id: troopId };
+    if (updates.members) {
+        await assertMembersReferenceEnemies(projectPath, merged.members);
+    }
+    troops[index] = merged;
+    await precommit?.(merged);
+    await commitChange(getDataPath(projectPath, 'Troops.json'), troops);
+    return merged;
+}
+const troopMemberSchema = z.object({
+    enemyId: z.number().int().describe('Enemy id from Enemies.json'),
+    x: z.number().int().describe('X screen position of the enemy in battle'),
+    y: z.number().int().describe('Y screen position of the enemy in battle'),
+    hidden: z.boolean().optional().default(false).describe('Whether the enemy starts hidden'),
+});
+export const battleToolDefinitions = [
+    {
+        name: 'create_enemy',
+        mutates: true,
+        description: "Create a new enemy in data/Enemies.json. Only `name` is required; omitted fields use the editor's new-enemy defaults (100 HP, one Attack action, no drops). Allocates the next unused enemy id and returns `{ enemy, warnings? }` (warn-by-default: a `battlerName` not found in img/enemies is flagged, never blocked). Throws if an `actions[].skillId` or a `dropItems[].dataId` (item/weapon/armor by `kind`) references a record that does not exist. NOTE: an enemy with no Hit Rate trait (xparam id 0: trait { code: 22, dataId: 0, value: 0.95 }) always misses physical actions — pass one in `traits` if the enemy should land basic attacks.",
+        inputSchema: {
+            name: z.string().describe('Enemy name shown in battle and the database'),
+            battlerName: z.string().optional().describe('Battler graphic filename (img/enemies)'),
+            battlerHue: z.number().int().optional().describe('Battler hue rotation 0-360'),
+            params: z
+                .array(z.number())
+                .length(8)
+                .optional()
+                .describe('8 base params: [maxHP, maxMP, atk, def, mat, mdf, agi, luk]'),
+            exp: z.number().int().optional().describe('EXP granted when defeated'),
+            gold: z.number().int().optional().describe('Gold granted when defeated'),
+            note: z.string().optional().describe('Note field'),
+            traits: z.array(z.unknown()).optional().describe('Trait objects { code, dataId, value }'),
+            dropItems: z
+                .array(z.unknown())
+                .optional()
+                .describe('Drop-item objects { kind, dataId, denominator }'),
+            actions: z
+                .array(z.unknown())
+                .optional()
+                .describe('Action patterns { skillId, conditionType, conditionParam1, conditionParam2, rating }'),
+        },
+        handler: async (ctx, args) => {
+            const { dryRun: _dryRun, ...overrides } = args;
+            const enemy = await createEnemy(ctx.projectPath, overrides);
+            return withEnemyAssetWarnings(ctx.projectPath, enemy);
+        },
+    },
+    {
+        name: 'update_enemy',
+        mutates: true,
+        description: "Update an enemy's properties (shallow merge into the existing record). Returns `{ enemy, warnings? }` — a `battlerName` not found in img/enemies is flagged warn-by-default.",
+        inputSchema: {
+            enemyId: z.number().int().positive().describe('The ID of the enemy to update'),
+            updates: z
+                .record(z.string(), z.unknown())
+                .describe('Object containing enemy properties to update'),
+        },
+        handler: async (ctx, args) => withEnemyAssetWarnings(ctx.projectPath, await updateEnemy(ctx.projectPath, args.enemyId, args.updates)),
+    },
+    {
+        name: 'create_troop',
+        mutates: true,
+        forceable: true,
+        description: 'Create a new troop (enemy battle group) in data/Troops.json. `name` is required; `members` defaults to empty and `pages` to one blank battle-event page. Every member.enemyId must reference an existing enemy. A structurally invalid battle-event page refuses the write (nothing is saved) — pass force: true to override.',
+        inputSchema: {
+            name: z.string().describe('Troop name shown in the database'),
+            members: z
+                .array(troopMemberSchema)
+                .optional()
+                .describe('Placed enemies; each references an existing enemyId'),
+            pages: z
+                .array(z.unknown())
+                .optional()
+                .describe('Battle-event pages { conditions, list, span }; defaults to one blank page'),
+        },
+        handler: async (ctx, args) => {
+            const gate = troopWriteGate(args.force);
+            const troop = await createTroop(ctx.projectPath, {
+                name: args.name,
+                members: args.members,
+                pages: args.pages,
+            }, gate.precommit);
+            return gate.respond({ troop });
+        },
+    },
+    {
+        name: 'update_troop',
+        mutates: true,
+        forceable: true,
+        description: "Update a troop's properties (shallow merge). If `members` is provided, each enemyId is validated to exist. A structurally invalid battle-event page refuses the write (nothing is saved) — pass force: true to override.",
+        inputSchema: {
+            troopId: z.number().int().positive().describe('The ID of the troop to update'),
+            updates: z
+                .record(z.string(), z.unknown())
+                .describe('Object containing troop properties to update (name, members, pages)'),
+        },
+        handler: async (ctx, args) => {
+            const gate = troopWriteGate(args.force);
+            const troop = await updateTroop(ctx.projectPath, args.troopId, args.updates, gate.precommit);
+            return gate.respond({ troop });
+        },
+    },
+];
+//# sourceMappingURL=battleTools.js.map

package/dist/tools/battleTools.js.map

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

package/dist/tools/catalogTools.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalogTools.d.ts","sourceRoot":"","sources":["../../src/tools/catalogTools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAgFhD,eAAO,MAAM,sBAAsB,EAAE,cAAc,EA8ElD,CAAC"}

package/dist/tools/catalogTools.js

@@ -0,0 +1,134 @@
+import { join } from 'path';
+import { z } from 'zod';
+import { getDataPath, readJsonFile, listFiles, fileExists } from '../utils/fileHandler.js';
+import { catalogForTileset, findTiles, hasCatalog, } from '../tiles/catalog/index.js';
+import { annotateTransparency } from './tileTransparency.js';
+/** Load one tileset from the project's data/Tilesets.json (1-indexed, slot 0 null). */
+async function getTileset(projectPath, tilesetId) {
+    const tilesets = await readJsonFile(getDataPath(projectPath, 'Tilesets.json'));
+    const tileset = tilesets[tilesetId];
+    if (!tileset) {
+        throw new Error(`Tileset ${tilesetId} not found`);
+    }
+    return tileset;
+}
+/**
+ * Load project-scoped tile catalogs from `data/tilecatalog/*.json` (written by the
+ * 3f vision-bootstrap skill) into an overlay keyed by sheet filename. Each file's
+ * `entries` (local index → { name, description?, confidence?, manual? }) becomes a
+ * tiles-by-index array, carrying through the draft metadata so the tools can
+ * surface it. A missing directory or an unreadable file yields no overlay for that
+ * sheet — the catalog gracefully falls back to built-in names. Returns `undefined`
+ * when there are no project catalogs at all (so callers pass nothing to the pure
+ * resolver).
+ */
+async function loadProjectCatalogs(projectPath) {
+    const dir = join(projectPath, 'data', 'tilecatalog');
+    if (!(await fileExists(dir)))
+        return undefined;
+    let files;
+    try {
+        files = await listFiles(dir, '.json');
+    }
+    catch {
+        return undefined;
+    }
+    const overlay = {};
+    for (const file of files) {
+        try {
+            const data = await readJsonFile(join(dir, file));
+            if (!data.sheet || !data.entries)
+                continue;
+            // Sparse array keyed by local index — forEach in the resolver skips the
+            // holes, so gaps don't need filling and index alignment is preserved.
+            const tiles = [];
+            for (const [idx, entry] of Object.entries(data.entries)) {
+                const i = Number(idx);
+                if (Number.isInteger(i) && i >= 0 && entry?.name) {
+                    tiles[i] = {
+                        name: entry.name,
+                        ...(entry.description ? { description: entry.description } : {}),
+                        ...(entry.confidence ? { confidence: entry.confidence } : {}),
+                        ...(entry.manual !== undefined ? { manual: entry.manual } : {}),
+                    };
+                }
+            }
+            overlay[data.sheet] = tiles;
+        }
+        catch {
+            // Skip a malformed catalog file rather than failing the whole lookup.
+            continue;
+        }
+    }
+    return Object.keys(overlay).length ? overlay : undefined;
+}
+export const catalogToolDefinitions = [
+    {
+        name: 'get_tile_catalog',
+        description: "Get the semantic tile catalog for a tileset: the named tiles (e.g. 'Grassland A', 'Forest', 'Sea') in each of its image sheets, each with its representative tile id and a `source` ('builtin' = RPG Maker's own labels; 'project' = a draft name from the vision-bootstrap skill). Project (custom-sheet) entries also carry the skill's `description`, `confidence` ('high'/'medium'/'low'), and `manual` (true = a human verified it) so you can gauge how trustworthy a draft name is. Autotile entries (A1–A4) return the kind's base tile id — feed it to a paint command, which recomputes the shape from neighbours. Covers the default Overworld tileset (World_A1/A2/B/C) plus any custom sheets cataloged into data/tilecatalog/ (via the tileset-catalog skill); still-uncovered sheets are omitted. **Called WITHOUT `sheet` it returns only a per-sheet index (name + entry count) to stay within the tool-output limit — a full tileset can hold thousands of named tiles. Pass `sheet` (filename 'World_A2' or slot role 'A2') to list one sheet's actual tile entries.** Sheet-filtered entries also carry `transparent` (true = the tile is see-through and needs an opaque base tile on a lower layer — painting it on layer 0 alone shows the map void; e.g. trees/objects/overlays). Read-only.",
+        inputSchema: {
+            tilesetId: z.number().int().positive().describe('Tileset id (from Tilesets.json / the map)'),
+            sheet: z
+                .string()
+                .optional()
+                .describe("Restrict to one sheet by filename ('World_A2') or role ('A2'). Omit to get a per-sheet summary (counts only) instead of every entry."),
+        },
+        handler: async (ctx, args) => {
+            const tileset = await getTileset(ctx.projectPath, args.tilesetId);
+            const overlay = await loadProjectCatalogs(ctx.projectPath);
+            const cataloged = hasCatalog(tileset.tilesetNames, overlay);
+            const entries = catalogForTileset(tileset.tilesetNames, args.sheet, overlay);
+            // Without a `sheet` filter, the full entry list can blow past the tool-output
+            // token limit (a default tileset holds thousands of named tiles). Return a
+            // per-sheet index instead, so the caller can pick a sheet to expand.
+            if (!args.sheet) {
+                const bySheet = new Map();
+                for (const e of entries) {
+                    const summary = bySheet.get(e.sheet);
+                    if (summary)
+                        summary.count++;
+                    else
+                        bySheet.set(e.sheet, { sheet: e.sheet, role: e.role, source: e.source, count: 1 });
+                }
+                return {
+                    tilesetId: args.tilesetId,
+                    tilesetName: tileset.name,
+                    cataloged,
+                    summary: true,
+                    totalEntries: entries.length,
+                    sheets: [...bySheet.values()],
+                    hint: "Per-sheet index only. Call again with `sheet` (filename or role, e.g. 'A2') to list that sheet's tile entries.",
+                };
+            }
+            // A single sheet's entries are bounded — annotate each with its
+            // transparency (needs-a-base) flag by reading the sheet PNG.
+            await annotateTransparency(ctx.projectPath, tileset, entries);
+            return {
+                tilesetId: args.tilesetId,
+                tilesetName: tileset.name,
+                cataloged,
+                sheet: args.sheet,
+                count: entries.length,
+                entries,
+            };
+        },
+    },
+    {
+        name: 'find_tile',
+        description: "Find tiles in a tileset by a case-insensitive SUBSTRING match on their catalog name — a quick bridge from a name fragment like 'grass' or 'forest' to a paintable tile id. This is a literal substring match, NOT synonym/semantic search: 'water' matches 'Endless Waterfall' but not 'Sea' or 'Pond' (their names lack the substring). To browse the actual tile names first, use get_tile_catalog with a `sheet` filter, then search a fragment you see. Returns matching catalog entries (name, sheet, tile id, autotile kind, `source`, `transparent` [true = needs an opaque base on a lower layer], plus `description`/`confidence`/`manual` for project catalog drafts). Covers the default Overworld tileset plus custom sheets cataloged into data/tilecatalog/ (via the tileset-catalog skill). Read-only.",
+        inputSchema: {
+            tilesetId: z.number().int().positive().describe('Tileset id (from Tilesets.json / the map)'),
+            query: z
+                .string()
+                .describe("Name substring to match, e.g. 'grass' or 'forest' (literal substring, no synonyms)"),
+        },
+        handler: async (ctx, args) => {
+            const tileset = await getTileset(ctx.projectPath, args.tilesetId);
+            const overlay = await loadProjectCatalogs(ctx.projectPath);
+            const matches = findTiles(tileset.tilesetNames, args.query, overlay);
+            await annotateTransparency(ctx.projectPath, tileset, matches);
+            return { tilesetId: args.tilesetId, query: args.query, count: matches.length, matches };
+        },
+    },
+];
+//# sourceMappingURL=catalogTools.js.map

package/dist/tools/catalogTools.js.map

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