rpgmaker-mz-mcp 1.0.0

package/dist/tools/actorTools.js

@@ -0,0 +1,154 @@
+import { z } from 'zod';
+import { readJsonFile, getDataPath } from '../utils/fileHandler.js';
+import { commitChange } from '../utils/commit.js';
+import { definedOnly } from '../utils/records.js';
+/**
+ * A blank actor mirroring what the RPG Maker MZ editor writes for a freshly-created
+ * actor (the "New Actor" shape from newdata/data/Actors.json): class 1, level 1-99,
+ * five empty equip slots, no traits, empty graphic/name fields. Pure so the template
+ * shape can be unit-tested.
+ *
+ * Every field is present — `create_actor` previously wrote only the fields a caller
+ * passed, so an actor made with just `name` was missing `equips`/`traits`/etc.
+ * entirely, which crashes the engine on load (Game_Actor reads `equips.length` and
+ * concats `traits` unconditionally). Field order mirrors the editor's on-disk shape.
+ */
+export function defaultActor() {
+    return {
+        name: '',
+        nickname: '',
+        classId: 1,
+        initialLevel: 1,
+        maxLevel: 99,
+        characterName: '',
+        characterIndex: 0,
+        faceName: '',
+        faceIndex: 0,
+        battlerName: '',
+        equips: [0, 0, 0, 0, 0],
+        traits: [],
+        note: '',
+        profile: '',
+    };
+}
+/**
+ * Get all actors from the project
+ */
+export async function getActors(projectPath) {
+    const actorsPath = getDataPath(projectPath, 'Actors.json');
+    return await readJsonFile(actorsPath);
+}
+/**
+ * Update an actor's data
+ */
+export async function updateActor(projectPath, actorId, updates) {
+    const actors = await getActors(projectPath);
+    const actorIndex = actors.findIndex((actor) => actor && actor.id === actorId);
+    if (actorIndex === -1) {
+        throw new Error(`Actor with ID ${actorId} not found`);
+    }
+    actors[actorIndex] = { ...actors[actorIndex], ...updates, id: actorId };
+    const actorsPath = getDataPath(projectPath, 'Actors.json');
+    await commitChange(actorsPath, actors);
+    return actors[actorIndex];
+}
+/**
+ * Build one new actor record against the current array — the shared per-record
+ * source of truth for both `create_actor` and `batch_create`. Pure: allocates the
+ * next unused id (max existing + 1), then merges the caller's defined fields over
+ * the {@link defaultActor} template with the computed id last so it always wins.
+ * Does not push or commit — the caller owns persistence (batch pushes N records
+ * onto the same array, then writes once).
+ */
+export function buildActorRecord(existing, input) {
+    const maxId = existing.reduce((max, actor) => (actor && actor.id > max ? actor.id : max), 0);
+    return {
+        ...defaultActor(),
+        ...definedOnly(input),
+        id: maxId + 1,
+    };
+}
+/**
+ * Create a new actor. Only `name` is required; any omitted field falls back to the
+ * editor's new-actor default (see {@link defaultActor}) so the record is always
+ * complete. Allocates the next unused id (max existing + 1) and writes through the
+ * commit choke point.
+ */
+export async function createActor(projectPath, overrides) {
+    const actors = await getActors(projectPath);
+    const newActor = buildActorRecord(actors, overrides);
+    actors.push(newActor);
+    const actorsPath = getDataPath(projectPath, 'Actors.json');
+    await commitChange(actorsPath, actors);
+    return newActor;
+}
+/**
+ * Delete an actor
+ */
+export async function deleteActor(projectPath, actorId) {
+    const actors = await getActors(projectPath);
+    const actorIndex = actors.findIndex((actor) => actor && actor.id === actorId);
+    if (actorIndex === -1) {
+        return false;
+    }
+    actors[actorIndex] = null;
+    const actorsPath = getDataPath(projectPath, 'Actors.json');
+    await commitChange(actorsPath, actors);
+    return true;
+}
+/**
+ * Search actors by name
+ */
+export async function searchActors(projectPath, searchTerm) {
+    const actors = await getActors(projectPath);
+    const lowerSearchTerm = searchTerm.toLowerCase();
+    return actors.filter((actor) => !!actor &&
+        (actor.name.toLowerCase().includes(lowerSearchTerm) ||
+            actor.nickname.toLowerCase().includes(lowerSearchTerm)));
+}
+export const actorToolDefinitions = [
+    {
+        name: 'update_actor',
+        mutates: true,
+        description: "Update an actor's properties",
+        inputSchema: {
+            actorId: z.number().int().positive().describe('The ID of the actor to update'),
+            updates: z
+                .record(z.string(), z.unknown())
+                .describe('Object containing actor properties to update'),
+        },
+        handler: (ctx, args) => updateActor(ctx.projectPath, args.actorId, args.updates),
+    },
+    {
+        name: 'create_actor',
+        mutates: true,
+        description: "Create a new actor in data/Actors.json. Only `name` is required; omitted fields use the editor's new-actor defaults (class 1, level 1-99, five empty equip slots, no traits). Allocates and returns the next unused actor id. NOTE: an actor's physical accuracy comes from its class + own traits — a class/actor with no Hit Rate trait (xparam id 0: trait { code: 22, dataId: 0, value: 0.95 }) always misses physical actions. The built-in class 1 has one; a custom class needs it added.",
+        inputSchema: {
+            name: z.string(),
+            nickname: z.string().optional(),
+            profile: z.string().optional(),
+            classId: z.number().int().positive().optional(),
+            initialLevel: z.number().optional(),
+            maxLevel: z.number().optional(),
+            characterName: z.string().optional(),
+            characterIndex: z.number().int().min(0).optional(),
+            faceName: z.string().optional(),
+            faceIndex: z.number().int().min(0).optional(),
+            battlerName: z.string().optional(),
+            traits: z.array(z.unknown()).optional(),
+            equips: z.array(z.number()).optional(),
+            note: z.string().optional(),
+        },
+        handler: (ctx, args) => {
+            const { dryRun: _dryRun, ...overrides } = args;
+            return createActor(ctx.projectPath, overrides);
+        },
+    },
+    {
+        name: 'search_actors',
+        description: 'Search actors by name or nickname',
+        inputSchema: { searchTerm: z.string().describe('The search term to find actors') },
+        handler: (ctx, args) => searchActors(ctx.projectPath, args.searchTerm),
+    },
+];
+//# sourceMappingURL=actorTools.js.map

package/dist/tools/actorTools.js.map

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

package/dist/tools/allTools.d.ts

@@ -0,0 +1,8 @@
+import { ToolDefinition } from '../registry.js';
+/**
+ * Every tool the server exposes, gathered from the per-domain tool modules.
+ * Kept in its own side-effect-free module so it can be imported by both the
+ * server entry point and the tests without booting the stdio server.
+ */
+export declare const allToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=allTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"allTools.d.ts","sourceRoot":"","sources":["../../src/tools/allTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AA0BhD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,cAAc,EAyB9C,CAAC"}

package/dist/tools/allTools.js

@@ -0,0 +1,56 @@
+import { projectToolDefinitions } from './projectTools.js';
+import { actorToolDefinitions } from './actorTools.js';
+import { itemToolDefinitions } from './itemTools.js';
+import { skillToolDefinitions } from './skillTools.js';
+import { mapToolDefinitions } from './mapTools.js';
+import { battleToolDefinitions } from './battleTools.js';
+import { classToolDefinitions } from './classTools.js';
+import { stateToolDefinitions } from './stateTools.js';
+import { commonEventToolDefinitions } from './commonEventTools.js';
+import { moveToolDefinitions } from './moveTools.js';
+import { eventCommandToolDefinitions } from './eventCommandTools.js';
+import { eventPageToolDefinitions } from './eventPageTools.js';
+import { pluginToolDefinitions } from './pluginTools.js';
+import { tileToolDefinitions } from './tileTools.js';
+import { catalogToolDefinitions } from './catalogTools.js';
+import { paintToolDefinitions } from './paintTools.js';
+import { objectToolDefinitions } from './objectTools.js';
+import { tilesetToolDefinitions } from './tilesetTools.js';
+import { systemToolDefinitions } from './systemTools.js';
+import { assetToolDefinitions } from './assetTools.js';
+import { listToolDefinitions } from './listTools.js';
+import { validationToolDefinitions } from './validationTools.js';
+import { pluginScanToolDefinitions } from './pluginScanTools.js';
+import { batchToolDefinitions } from './batchTools.js';
+/**
+ * Every tool the server exposes, gathered from the per-domain tool modules.
+ * Kept in its own side-effect-free module so it can be imported by both the
+ * server entry point and the tests without booting the stdio server.
+ */
+export const allToolDefinitions = [
+    ...projectToolDefinitions,
+    ...actorToolDefinitions,
+    ...itemToolDefinitions,
+    ...skillToolDefinitions,
+    ...mapToolDefinitions,
+    ...battleToolDefinitions,
+    ...classToolDefinitions,
+    ...stateToolDefinitions,
+    ...commonEventToolDefinitions,
+    ...moveToolDefinitions,
+    ...eventCommandToolDefinitions,
+    ...eventPageToolDefinitions,
+    ...pluginToolDefinitions,
+    ...tileToolDefinitions,
+    ...catalogToolDefinitions,
+    ...paintToolDefinitions,
+    ...objectToolDefinitions,
+    ...tilesetToolDefinitions,
+    ...systemToolDefinitions,
+    ...assetToolDefinitions,
+    ...listToolDefinitions,
+    ...validationToolDefinitions,
+    ...batchToolDefinitions,
+    ...pluginScanToolDefinitions,
+];
+//# sourceMappingURL=allTools.js.map

package/dist/tools/allTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"allTools.js","sourceRoot":"","sources":["../../src/tools/allTools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAqB;IAClD,GAAG,sBAAsB;IACzB,GAAG,oBAAoB;IACvB,GAAG,mBAAmB;IACtB,GAAG,oBAAoB;IACvB,GAAG,kBAAkB;IACrB,GAAG,qBAAqB;IACxB,GAAG,oBAAoB;IACvB,GAAG,oBAAoB;IACvB,GAAG,0BAA0B;IAC7B,GAAG,mBAAmB;IACtB,GAAG,2BAA2B;IAC9B,GAAG,wBAAwB;IAC3B,GAAG,qBAAqB;IACxB,GAAG,mBAAmB;IACtB,GAAG,sBAAsB;IACzB,GAAG,oBAAoB;IACvB,GAAG,qBAAqB;IACxB,GAAG,sBAAsB;IACzB,GAAG,qBAAqB;IACxB,GAAG,oBAAoB;IACvB,GAAG,mBAAmB;IACtB,GAAG,yBAAyB;IAC5B,GAAG,oBAAoB;IACvB,GAAG,yBAAyB;CAC7B,CAAC"}

package/dist/tools/assetTools.d.ts

@@ -0,0 +1,113 @@
+import { ToolDefinition } from '../registry.js';
+import { ValidationWarning } from '../validation/eventCommands.js';
+/**
+ * The project asset kinds a caller can enumerate, mapped to their directory
+ * (relative to the project root) and the file extensions they use. RPG Maker MZ
+ * references every asset by **basename without extension** (e.g. an event's
+ * `characterName` is `"Actor1"`, not `"Actor1.png"`), so `list_assets` strips the
+ * extension — the returned names are exactly what the data files expect.
+ *
+ * Audio ships as `.ogg` (and sometimes a parallel `.m4a` for other runtimes); we
+ * list both and dedupe by basename so each track appears once.
+ */
+declare const ASSET_DIRS: {
+    readonly characters: {
+        readonly dir: "img/characters";
+        readonly exts: readonly [".png"];
+    };
+    readonly faces: {
+        readonly dir: "img/faces";
+        readonly exts: readonly [".png"];
+    };
+    readonly tilesets: {
+        readonly dir: "img/tilesets";
+        readonly exts: readonly [".png"];
+    };
+    readonly pictures: {
+        readonly dir: "img/pictures";
+        readonly exts: readonly [".png"];
+    };
+    readonly parallaxes: {
+        readonly dir: "img/parallaxes";
+        readonly exts: readonly [".png"];
+    };
+    readonly battlebacks1: {
+        readonly dir: "img/battlebacks1";
+        readonly exts: readonly [".png"];
+    };
+    readonly battlebacks2: {
+        readonly dir: "img/battlebacks2";
+        readonly exts: readonly [".png"];
+    };
+    readonly enemies: {
+        readonly dir: "img/enemies";
+        readonly exts: readonly [".png"];
+    };
+    readonly sv_actors: {
+        readonly dir: "img/sv_actors";
+        readonly exts: readonly [".png"];
+    };
+    readonly sv_enemies: {
+        readonly dir: "img/sv_enemies";
+        readonly exts: readonly [".png"];
+    };
+    readonly titles1: {
+        readonly dir: "img/titles1";
+        readonly exts: readonly [".png"];
+    };
+    readonly titles2: {
+        readonly dir: "img/titles2";
+        readonly exts: readonly [".png"];
+    };
+    readonly system: {
+        readonly dir: "img/system";
+        readonly exts: readonly [".png"];
+    };
+    readonly bgm: {
+        readonly dir: "audio/bgm";
+        readonly exts: readonly [".ogg", ".m4a"];
+    };
+    readonly bgs: {
+        readonly dir: "audio/bgs";
+        readonly exts: readonly [".ogg", ".m4a"];
+    };
+    readonly me: {
+        readonly dir: "audio/me";
+        readonly exts: readonly [".ogg", ".m4a"];
+    };
+    readonly se: {
+        readonly dir: "audio/se";
+        readonly exts: readonly [".ogg", ".m4a"];
+    };
+};
+export type AssetType = keyof typeof ASSET_DIRS;
+export interface AssetIndex {
+    type: AssetType;
+    count: number;
+    names: string[];
+}
+/**
+ * List the available asset basenames (extension stripped) for one asset kind —
+ * the exact strings the data files reference (a sprite/face/audio name). Use it to
+ * validate a graphic/audio name before wiring it into an event, since a wrong
+ * filename is a silent runtime failure in the engine.
+ *
+ * **Fails soft:** a missing asset directory (an unused kind) yields an empty list
+ * rather than an error. Read-only — no writes.
+ */
+export declare function listAssets(projectPath: string, type: AssetType): Promise<AssetIndex>;
+/**
+ * Warn (never throw) when an asset `name` isn't among the project's assets of the
+ * given type — a wrong filename is a silent runtime failure in the engine. Skips
+ * the check when the name is empty (no asset referenced) or the asset dir is
+ * empty/missing (nothing to validate against — e.g. a fixture project), so it
+ * can't emit false positives. Shared by the audio/character/battler name checks.
+ */
+export declare function assetNameWarning(projectPath: string, type: AssetType, name: string | undefined, opts: {
+    path: string;
+    label: string;
+    consequence: string;
+}): Promise<ValidationWarning[]>;
+export declare const assetToolDefinitions: ToolDefinition[];
+export {};
+//# sourceMappingURL=assetTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assetTools.d.ts","sourceRoot":"","sources":["../../src/tools/assetTools.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE;;;;;;;;;GASG;AACH,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkBN,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,UAAU,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAsB1F;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACzD,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAa9B;AAED,eAAO,MAAM,oBAAoB,EAAE,cAAc,EAchD,CAAC"}

package/dist/tools/assetTools.js

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+import { basename, join } from 'path';
+import { listFiles } from '../utils/fileHandler.js';
+/**
+ * The project asset kinds a caller can enumerate, mapped to their directory
+ * (relative to the project root) and the file extensions they use. RPG Maker MZ
+ * references every asset by **basename without extension** (e.g. an event's
+ * `characterName` is `"Actor1"`, not `"Actor1.png"`), so `list_assets` strips the
+ * extension — the returned names are exactly what the data files expect.
+ *
+ * Audio ships as `.ogg` (and sometimes a parallel `.m4a` for other runtimes); we
+ * list both and dedupe by basename so each track appears once.
+ */
+const ASSET_DIRS = {
+    characters: { dir: 'img/characters', exts: ['.png'] },
+    faces: { dir: 'img/faces', exts: ['.png'] },
+    tilesets: { dir: 'img/tilesets', exts: ['.png'] },
+    pictures: { dir: 'img/pictures', exts: ['.png'] },
+    parallaxes: { dir: 'img/parallaxes', exts: ['.png'] },
+    battlebacks1: { dir: 'img/battlebacks1', exts: ['.png'] },
+    battlebacks2: { dir: 'img/battlebacks2', exts: ['.png'] },
+    enemies: { dir: 'img/enemies', exts: ['.png'] },
+    sv_actors: { dir: 'img/sv_actors', exts: ['.png'] },
+    sv_enemies: { dir: 'img/sv_enemies', exts: ['.png'] },
+    titles1: { dir: 'img/titles1', exts: ['.png'] },
+    titles2: { dir: 'img/titles2', exts: ['.png'] },
+    system: { dir: 'img/system', exts: ['.png'] },
+    bgm: { dir: 'audio/bgm', exts: ['.ogg', '.m4a'] },
+    bgs: { dir: 'audio/bgs', exts: ['.ogg', '.m4a'] },
+    me: { dir: 'audio/me', exts: ['.ogg', '.m4a'] },
+    se: { dir: 'audio/se', exts: ['.ogg', '.m4a'] },
+};
+/**
+ * List the available asset basenames (extension stripped) for one asset kind —
+ * the exact strings the data files reference (a sprite/face/audio name). Use it to
+ * validate a graphic/audio name before wiring it into an event, since a wrong
+ * filename is a silent runtime failure in the engine.
+ *
+ * **Fails soft:** a missing asset directory (an unused kind) yields an empty list
+ * rather than an error. Read-only — no writes.
+ */
+export async function listAssets(projectPath, type) {
+    const spec = ASSET_DIRS[type];
+    if (!spec) {
+        throw new Error(`Unknown asset type: ${type}. Valid types: ${Object.keys(ASSET_DIRS).join(', ')}`);
+    }
+    const dirPath = join(projectPath, ...spec.dir.split('/'));
+    const names = new Set();
+    for (const ext of spec.exts) {
+        let files;
+        try {
+            files = await listFiles(dirPath, ext);
+        }
+        catch {
+            files = []; // Missing dir (unused asset kind) → fail soft.
+        }
+        for (const file of files)
+            names.add(basename(file, ext));
+    }
+    const sorted = [...names].sort();
+    return { type, count: sorted.length, names: sorted };
+}
+/**
+ * Warn (never throw) when an asset `name` isn't among the project's assets of the
+ * given type — a wrong filename is a silent runtime failure in the engine. Skips
+ * the check when the name is empty (no asset referenced) or the asset dir is
+ * empty/missing (nothing to validate against — e.g. a fixture project), so it
+ * can't emit false positives. Shared by the audio/character/battler name checks.
+ */
+export async function assetNameWarning(projectPath, type, name, opts) {
+    if (!projectPath || !name)
+        return [];
+    const { names } = await listAssets(projectPath, type);
+    if (names.length > 0 && !names.includes(name)) {
+        return [
+            {
+                path: opts.path,
+                code: undefined,
+                message: `${opts.label} "${name}" is not a known ${type} asset (${opts.consequence})`,
+            },
+        ];
+    }
+    return [];
+}
+export const assetToolDefinitions = [
+    {
+        name: 'list_assets',
+        description: "List the available asset filenames (extension stripped) for one asset kind — the exact names RPG Maker's data references (a sprite/face/tileset/audio name). Use it to validate a graphic or audio name before wiring it into an event; a wrong filename fails silently at runtime. Fails soft: an unused asset directory returns an empty list.",
+        inputSchema: {
+            type: z
+                .enum(Object.keys(ASSET_DIRS))
+                .describe('Asset kind to list. Images: characters, faces, tilesets, pictures, parallaxes, battlebacks1, battlebacks2, enemies, sv_actors, sv_enemies, titles1, titles2, system. Audio: bgm, bgs, me, se.'),
+        },
+        handler: (ctx, args) => listAssets(ctx.projectPath, args.type),
+    },
+];
+//# sourceMappingURL=assetTools.js.map

package/dist/tools/assetTools.js.map

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

package/dist/tools/batchTools.d.ts

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

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

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

package/dist/tools/batchTools.js

@@ -0,0 +1,138 @@
+import { z } from 'zod';
+import { commitChange } from '../utils/commit.js';
+import { getDataPath } from '../utils/fileHandler.js';
+import { getActors, buildActorRecord } from './actorTools.js';
+import { getItems, getWeapons, getArmors, buildItemRecord, buildWeaponRecord, buildArmorRecord, assertItemEffectRefs, } from './itemTools.js';
+import { getSkills, buildSkillRecord, assertSkillEffectRefs } from './skillTools.js';
+import { getEnemies, buildEnemyRecord, assertEnemyRefs, battlerNameWarnings, } from './battleTools.js';
+import { getStates, buildStateRecord } from './stateTools.js';
+import { getClasses, buildClassRecord, summarizeClass } from './classTools.js';
+/**
+ * Entity types `batch_create` can append to. Each maps to one 1-indexed database
+ * array (slot 0 null) that the matching single `create_*` tool already owns.
+ */
+const BATCH_TYPES = [
+    'actor',
+    'item',
+    'weapon',
+    'armor',
+    'skill',
+    'enemy',
+    'state',
+    'class',
+];
+/**
+ * Append every record in one pass, then write once.
+ *
+ * Records are pushed onto the in-memory array as they are built, so each record's
+ * id allocation (max existing + 1) sees the previous ones — ids come out
+ * sequential — and a reference check can resolve a sibling created earlier in the
+ * same batch (e.g. a skill whose Learn Skill effect points at the skill before it).
+ *
+ * A failing record throws with its index and **nothing is written**: the single
+ * `commitChange` runs only after every record is built and checked.
+ */
+async function runBatch(projectPath, type, spec, records) {
+    const existing = await spec.load(projectPath);
+    const created = [];
+    const warnings = [];
+    for (const [index, input] of records.entries()) {
+        let record;
+        try {
+            record = spec.build(existing, input);
+            if (spec.assertRefs) {
+                await spec.assertRefs(projectPath, record, existing);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`records[${index}]: ${message}`);
+        }
+        existing.push(record);
+        created.push(record);
+        if (spec.warn) {
+            // Tag each warning with the record that produced it — a batch can emit
+            // several and `path` alone ("battlerName") wouldn't say which.
+            const recordWarnings = await spec.warn(projectPath, record);
+            warnings.push(...recordWarnings.map((w) => ({ ...w, path: `records[${index}].${w.path}` })));
+        }
+    }
+    await commitChange(getDataPath(projectPath, spec.file), existing);
+    const out = created.map((record) => (spec.summarize ? spec.summarize(record) : record));
+    const result = { type, count: out.length, created: out };
+    return warnings.length > 0 ? { ...result, warnings } : result;
+}
+/** Dispatch a batch to its per-type spec. */
+async function batchCreate(projectPath, type, records) {
+    switch (type) {
+        case 'actor':
+            return runBatch(projectPath, type, {
+                file: 'Actors.json',
+                load: getActors,
+                build: (existing, input) => buildActorRecord(existing, input),
+            }, records);
+        case 'item':
+            return runBatch(projectPath, type, {
+                file: 'Items.json',
+                load: getItems,
+                build: (existing, input) => buildItemRecord(existing, input),
+                assertRefs: (path, record) => assertItemEffectRefs(path, record),
+            }, records);
+        case 'weapon':
+            return runBatch(projectPath, type, {
+                file: 'Weapons.json',
+                load: getWeapons,
+                build: (existing, input) => buildWeaponRecord(existing, input),
+            }, records);
+        case 'armor':
+            return runBatch(projectPath, type, {
+                file: 'Armors.json',
+                load: getArmors,
+                build: (existing, input) => buildArmorRecord(existing, input),
+            }, records);
+        case 'skill':
+            return runBatch(projectPath, type, {
+                file: 'Skills.json',
+                load: getSkills,
+                build: (existing, input) => buildSkillRecord(existing, input),
+                assertRefs: (path, record, existing) => assertSkillEffectRefs(path, record, existing),
+            }, records);
+        case 'enemy':
+            return runBatch(projectPath, type, {
+                file: 'Enemies.json',
+                load: getEnemies,
+                build: (existing, input) => buildEnemyRecord(existing, input),
+                assertRefs: (path, record) => assertEnemyRefs(path, record),
+                warn: (path, record) => battlerNameWarnings(path, record.battlerName),
+            }, records);
+        case 'state':
+            return runBatch(projectPath, type, {
+                file: 'States.json',
+                load: getStates,
+                build: (existing, input) => buildStateRecord(existing, input),
+            }, records);
+        case 'class':
+            return runBatch(projectPath, type, {
+                file: 'Classes.json',
+                load: getClasses,
+                build: (existing, input) => buildClassRecord(existing, input),
+                summarize: summarizeClass,
+            }, records);
+    }
+}
+export const batchToolDefinitions = [
+    {
+        name: 'batch_create',
+        mutates: true,
+        description: "Create many database records of one type in a single call and a single file write — the batch sibling of create_actor/create_item/create_weapon/create_armor/create_skill/create_enemy/create_state/create_class. Each entry in `records` takes the same fields its single create_* tool accepts (only `name` is required for most; omitted fields use the editor's defaults). Ids are allocated sequentially from the current max, so a record can reference a sibling created earlier in the same batch. Use this instead of N sequential create_* calls when authoring a cast, a loot table, or a skill list. Returns `{ type, count, created, warnings? }` (classes are summarized like create_class; enemy battlerName misses are warnings, never blocked). Throws — writing nothing at all — if any record references a database id that does not exist, naming the offending records[i].",
+        inputSchema: {
+            type: z.enum(BATCH_TYPES).describe('Which database the records are appended to'),
+            records: z
+                .array(z.record(z.string(), z.unknown()))
+                .min(1)
+                .describe('The records to create, each shaped like the matching create_* tool\'s arguments (e.g. for type "actor": { name, classId?, ... })'),
+        },
+        handler: async (ctx, args) => batchCreate(ctx.projectPath, args.type, args.records),
+    },
+];
+//# sourceMappingURL=batchTools.js.map

package/dist/tools/batchTools.js.map

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