rpgmaker-mz-mcp 1.0.0

package/dist/tools/itemTools.d.ts

@@ -0,0 +1,82 @@
+import { Item, Weapon, Armor, Skill } from '../utils/types.js';
+import { ToolDefinition } from '../registry.js';
+/** The editor's shape for a fresh "New Item" (all zeros / sensible defaults). */
+export declare function defaultItem(): Omit<Item, 'id'>;
+/** The editor's shape for a fresh "New Weapon". `etypeId` 1 = Weapon slot; flat param bonuses. */
+export declare function defaultWeapon(): Omit<Weapon, 'id'>;
+/** The editor's shape for a fresh "New Armor". `etypeId` 2 = Shield slot; flat param bonuses. */
+export declare function defaultArmor(): Omit<Armor, 'id'>;
+/**
+ * Get all items from the project
+ */
+export declare function getItems(projectPath: string): Promise<(Item | null)[]>;
+/**
+ * Get all weapons from the project
+ */
+export declare function getWeapons(projectPath: string): Promise<(Weapon | null)[]>;
+/**
+ * Get all armors from the project
+ */
+export declare function getArmors(projectPath: string): Promise<(Armor | null)[]>;
+/**
+ * Get all skills from the project
+ */
+export declare function getSkills(projectPath: string): Promise<(Skill | null)[]>;
+/**
+ * Get a specific item by ID
+ */
+export declare function getItem(projectPath: string, itemId: number): Promise<Item | null>;
+/**
+ * Update an item's data
+ */
+export declare function updateItem(projectPath: string, itemId: number, updates: Partial<Item>): Promise<Item>;
+/**
+ * Build one new item record against the current array — the shared per-record
+ * source of truth for both `create_item` and `batch_create`. Pure record
+ * construction only (`defaultItem()` template + caller overrides + id-last); the
+ * effect reference check stays with the caller (it needs cross-file reads).
+ */
+export declare function buildItemRecord(existing: (Item | null)[], input: Partial<Omit<Item, 'id'>>): Item;
+/** Build one new weapon record against the current array (shared by create/batch). */
+export declare function buildWeaponRecord(existing: (Weapon | null)[], input: Partial<Omit<Weapon, 'id'>>): Weapon;
+/** Build one new armor record against the current array (shared by create/batch). */
+export declare function buildArmorRecord(existing: (Armor | null)[], input: Partial<Omit<Armor, 'id'>>): Armor;
+/**
+ * Reject an item whose effects point at a non-existent state / skill / common
+ * event (P2-3: throw at author time, matching create_skill and its siblings).
+ * Shared by `create_item` and `batch_create`.
+ */
+export declare function assertItemEffectRefs(projectPath: string, item: Item): Promise<void>;
+/**
+ * Create a new item. Only the fields the caller supplies override the
+ * `defaultItem()` template; the computed id always wins (spread last).
+ */
+export declare function createItem(projectPath: string, overrides: Partial<Omit<Item, 'id'>>): Promise<Item>;
+/**
+ * Create a new weapon. Overrides merge over the `defaultWeapon()` template; the
+ * computed id always wins.
+ */
+export declare function createWeapon(projectPath: string, overrides: Partial<Omit<Weapon, 'id'>>): Promise<Weapon>;
+/**
+ * Create a new armor. Overrides merge over the `defaultArmor()` template; the
+ * computed id always wins.
+ */
+export declare function createArmor(projectPath: string, overrides: Partial<Omit<Armor, 'id'>>): Promise<Armor>;
+/**
+ * Update a weapon's data
+ */
+export declare function updateWeapon(projectPath: string, weaponId: number, updates: Partial<Weapon>): Promise<Weapon>;
+/**
+ * Update an armor's data
+ */
+export declare function updateArmor(projectPath: string, armorId: number, updates: Partial<Armor>): Promise<Armor>;
+/**
+ * Update a skill's data
+ */
+export declare function updateSkill(projectPath: string, skillId: number, updates: Partial<Skill>): Promise<Skill>;
+/**
+ * Search items by name or description
+ */
+export declare function searchItems(projectPath: string, searchTerm: string): Promise<Item[]>;
+export declare const itemToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=itemTools.d.ts.map

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

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

package/dist/tools/itemTools.js

@@ -0,0 +1,380 @@
+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 { firstMissingEffectRef } from '../validation/createRefs.js';
+/** The editor's shape for a fresh "New Item" (all zeros / sensible defaults). */
+export function defaultItem() {
+    return {
+        name: '',
+        description: '',
+        iconIndex: 0,
+        itypeId: 1, // Regular Item
+        scope: 0, // None
+        occasion: 0, // Always
+        speed: 0,
+        successRate: 100,
+        repeats: 1,
+        tpGain: 0,
+        hitType: 0,
+        animationId: 0,
+        price: 0,
+        consumable: true,
+        damage: { type: 0, elementId: 0, formula: '0', variance: 20, critical: false },
+        effects: [],
+        note: '',
+    };
+}
+/** The editor's shape for a fresh "New Weapon". `etypeId` 1 = Weapon slot; flat param bonuses. */
+export function defaultWeapon() {
+    return {
+        name: '',
+        description: '',
+        iconIndex: 0,
+        wtypeId: 1,
+        price: 0,
+        params: [0, 0, 0, 0, 0, 0, 0, 0],
+        traits: [],
+        etypeId: 1,
+        animationId: 0,
+        note: '',
+    };
+}
+/** The editor's shape for a fresh "New Armor". `etypeId` 2 = Shield slot; flat param bonuses. */
+export function defaultArmor() {
+    return {
+        name: '',
+        description: '',
+        iconIndex: 0,
+        atypeId: 1,
+        price: 0,
+        params: [0, 0, 0, 0, 0, 0, 0, 0],
+        traits: [],
+        etypeId: 2,
+        note: '',
+    };
+}
+/**
+ * Get all items from the project
+ */
+export async function getItems(projectPath) {
+    const itemsPath = getDataPath(projectPath, 'Items.json');
+    return await readJsonFile(itemsPath);
+}
+/**
+ * Get all weapons from the project
+ */
+export async function getWeapons(projectPath) {
+    const weaponsPath = getDataPath(projectPath, 'Weapons.json');
+    return await readJsonFile(weaponsPath);
+}
+/**
+ * Get all armors from the project
+ */
+export async function getArmors(projectPath) {
+    const armorsPath = getDataPath(projectPath, 'Armors.json');
+    return await readJsonFile(armorsPath);
+}
+/**
+ * Get all skills from the project
+ */
+export async function getSkills(projectPath) {
+    const skillsPath = getDataPath(projectPath, 'Skills.json');
+    return await readJsonFile(skillsPath);
+}
+/**
+ * Get a specific item by ID
+ */
+export async function getItem(projectPath, itemId) {
+    const items = await getItems(projectPath);
+    return items.find((item) => item && item.id === itemId) || null;
+}
+/**
+ * Update an item's data
+ */
+export async function updateItem(projectPath, itemId, updates) {
+    const items = await getItems(projectPath);
+    const itemIndex = items.findIndex((item) => item && item.id === itemId);
+    if (itemIndex === -1) {
+        throw new Error(`Item with ID ${itemId} not found`);
+    }
+    items[itemIndex] = { ...items[itemIndex], ...updates, id: itemId };
+    const itemsPath = getDataPath(projectPath, 'Items.json');
+    await commitChange(itemsPath, items);
+    return items[itemIndex];
+}
+/**
+ * Build one new item record against the current array — the shared per-record
+ * source of truth for both `create_item` and `batch_create`. Pure record
+ * construction only (`defaultItem()` template + caller overrides + id-last); the
+ * effect reference check stays with the caller (it needs cross-file reads).
+ */
+export function buildItemRecord(existing, input) {
+    const maxId = existing.reduce((max, item) => (item && item.id > max ? item.id : max), 0);
+    return {
+        ...defaultItem(),
+        ...definedOnly(input),
+        id: maxId + 1,
+    };
+}
+/** Build one new weapon record against the current array (shared by create/batch). */
+export function buildWeaponRecord(existing, input) {
+    const maxId = existing.reduce((max, w) => (w && w.id > max ? w.id : max), 0);
+    return {
+        ...defaultWeapon(),
+        ...definedOnly(input),
+        id: maxId + 1,
+    };
+}
+/** Build one new armor record against the current array (shared by create/batch). */
+export function buildArmorRecord(existing, input) {
+    const maxId = existing.reduce((max, a) => (a && a.id > max ? a.id : max), 0);
+    return {
+        ...defaultArmor(),
+        ...definedOnly(input),
+        id: maxId + 1,
+    };
+}
+/**
+ * Reject an item whose effects point at a non-existent state / skill / common
+ * event (P2-3: throw at author time, matching create_skill and its siblings).
+ * Shared by `create_item` and `batch_create`.
+ */
+export async function assertItemEffectRefs(projectPath, item) {
+    const [states, skills, commonEvents] = await Promise.all([
+        readJsonArraySoft(getDataPath(projectPath, 'States.json')),
+        readJsonArraySoft(getDataPath(projectPath, 'Skills.json')),
+        readJsonArraySoft(getDataPath(projectPath, 'CommonEvents.json')),
+    ]);
+    const missing = firstMissingEffectRef(item.effects, { states, skills, commonEvents });
+    if (missing) {
+        throw new Error(`Cannot create item "${item.name}": ${missing}`);
+    }
+}
+/**
+ * Create a new item. Only the fields the caller supplies override the
+ * `defaultItem()` template; the computed id always wins (spread last).
+ */
+export async function createItem(projectPath, overrides) {
+    const items = await getItems(projectPath);
+    const newItem = buildItemRecord(items, overrides);
+    await assertItemEffectRefs(projectPath, newItem);
+    items.push(newItem);
+    const itemsPath = getDataPath(projectPath, 'Items.json');
+    await commitChange(itemsPath, items);
+    return newItem;
+}
+/**
+ * Create a new weapon. Overrides merge over the `defaultWeapon()` template; the
+ * computed id always wins.
+ */
+export async function createWeapon(projectPath, overrides) {
+    const weapons = await getWeapons(projectPath);
+    const newWeapon = buildWeaponRecord(weapons, overrides);
+    weapons.push(newWeapon);
+    const weaponsPath = getDataPath(projectPath, 'Weapons.json');
+    await commitChange(weaponsPath, weapons);
+    return newWeapon;
+}
+/**
+ * Create a new armor. Overrides merge over the `defaultArmor()` template; the
+ * computed id always wins.
+ */
+export async function createArmor(projectPath, overrides) {
+    const armors = await getArmors(projectPath);
+    const newArmor = buildArmorRecord(armors, overrides);
+    armors.push(newArmor);
+    const armorsPath = getDataPath(projectPath, 'Armors.json');
+    await commitChange(armorsPath, armors);
+    return newArmor;
+}
+/**
+ * Update a weapon's data
+ */
+export async function updateWeapon(projectPath, weaponId, updates) {
+    const weapons = await getWeapons(projectPath);
+    const weaponIndex = weapons.findIndex((weapon) => weapon && weapon.id === weaponId);
+    if (weaponIndex === -1) {
+        throw new Error(`Weapon with ID ${weaponId} not found`);
+    }
+    weapons[weaponIndex] = { ...weapons[weaponIndex], ...updates, id: weaponId };
+    const weaponsPath = getDataPath(projectPath, 'Weapons.json');
+    await commitChange(weaponsPath, weapons);
+    return weapons[weaponIndex];
+}
+/**
+ * Update an armor's data
+ */
+export async function updateArmor(projectPath, armorId, updates) {
+    const armors = await getArmors(projectPath);
+    const armorIndex = armors.findIndex((armor) => armor && armor.id === armorId);
+    if (armorIndex === -1) {
+        throw new Error(`Armor with ID ${armorId} not found`);
+    }
+    armors[armorIndex] = { ...armors[armorIndex], ...updates, id: armorId };
+    const armorsPath = getDataPath(projectPath, 'Armors.json');
+    await commitChange(armorsPath, armors);
+    return armors[armorIndex];
+}
+/**
+ * Update a skill's data
+ */
+export async function updateSkill(projectPath, skillId, updates) {
+    const skills = await getSkills(projectPath);
+    const skillIndex = skills.findIndex((skill) => skill && skill.id === skillId);
+    if (skillIndex === -1) {
+        throw new Error(`Skill with ID ${skillId} not found`);
+    }
+    skills[skillIndex] = { ...skills[skillIndex], ...updates };
+    const skillsPath = getDataPath(projectPath, 'Skills.json');
+    await commitChange(skillsPath, skills);
+    return skills[skillIndex];
+}
+/**
+ * Search items by name or description
+ */
+export async function searchItems(projectPath, searchTerm) {
+    const items = await getItems(projectPath);
+    const lowerSearchTerm = searchTerm.toLowerCase();
+    return items.filter((item) => !!item &&
+        (item.name.toLowerCase().includes(lowerSearchTerm) ||
+            item.description.toLowerCase().includes(lowerSearchTerm)));
+}
+export const itemToolDefinitions = [
+    {
+        name: 'create_item',
+        mutates: true,
+        description: "Create a new item in data/Items.json. Only `name` is worth passing; omitted fields use the editor's new-item defaults (Regular Item, consumable, no effects). Allocates and returns the next unused item id. An effect referencing a missing record throws: Add/Remove State (code 21/22) → state, Learn Skill (43) → skill, Common Event (44) → common event.",
+        inputSchema: {
+            name: z.string().describe('Item name'),
+            description: z.string().optional().describe('In-game description text'),
+            iconIndex: z.number().int().optional().describe('Icon index (IconSet.png)'),
+            itypeId: z
+                .number()
+                .int()
+                .optional()
+                .describe('Item type: 1 Regular, 2 Key Item, 3 Hidden A, 4 Hidden B'),
+            scope: z
+                .number()
+                .int()
+                .optional()
+                .describe('Target scope (0 none, 1 one enemy, 7 one ally, …)'),
+            occasion: z.number().int().optional().describe('Usable: 0 always, 1 battle, 2 menu, 3 never'),
+            price: z.number().int().optional().describe('Buy price (sells for half)'),
+            consumable: z.boolean().optional().describe('Consumed on use'),
+            successRate: z.number().int().optional().describe('Success rate percent'),
+            repeats: z.number().int().optional().describe('Number of hits/repeats'),
+            tpGain: z.number().int().optional().describe('User TP gained on use'),
+            hitType: z.number().int().optional().describe('0 certain, 1 physical, 2 magical'),
+            animationId: z.number().int().optional().describe('Animation id shown on use'),
+            damage: z
+                .record(z.string(), z.unknown())
+                .optional()
+                .describe('Damage object { type, elementId, formula, variance, critical }'),
+            effects: z
+                .array(z.unknown())
+                .optional()
+                .describe('Effect objects { code, dataId, value1, value2 }'),
+            note: z.string().optional().describe('Note field'),
+        },
+        handler: (ctx, args) => {
+            const { dryRun: _dryRun, ...overrides } = args;
+            return createItem(ctx.projectPath, overrides);
+        },
+    },
+    {
+        name: 'update_item',
+        mutates: true,
+        description: "Update an item's properties (shallow merge into the existing record)",
+        inputSchema: {
+            itemId: z.number().int().positive().describe('The ID of the item to update'),
+            updates: z
+                .record(z.string(), z.unknown())
+                .describe('Object containing item properties to update'),
+        },
+        handler: (ctx, args) => updateItem(ctx.projectPath, args.itemId, args.updates),
+    },
+    {
+        name: 'search_items',
+        description: 'Search items by name or description',
+        inputSchema: { searchTerm: z.string().describe('The search term to find items') },
+        handler: (ctx, args) => searchItems(ctx.projectPath, args.searchTerm),
+    },
+    {
+        name: 'create_weapon',
+        mutates: true,
+        description: "Create a new weapon in data/Weapons.json. Only `name` is required; omitted fields use the editor's new-weapon defaults (Weapon equip slot, no stat bonuses). `params` is a flat 8-length stat bonus [maxHP, maxMP, atk, def, mat, mdf, agi, luk]. Allocates and returns the next unused weapon id.",
+        inputSchema: {
+            name: z.string().describe('Weapon name'),
+            description: z.string().optional().describe('In-game description text'),
+            iconIndex: z.number().int().optional().describe('Icon index (IconSet.png)'),
+            wtypeId: z.number().int().optional().describe('Weapon type id (System.json weaponTypes)'),
+            price: z.number().int().optional().describe('Buy price'),
+            params: z
+                .array(z.number())
+                .length(8)
+                .optional()
+                .describe('8 flat stat bonuses [maxHP, maxMP, atk, def, mat, mdf, agi, luk]'),
+            animationId: z.number().int().optional().describe('Attack animation id'),
+            traits: z.array(z.unknown()).optional().describe('Trait objects { code, dataId, value }'),
+            note: z.string().optional().describe('Note field'),
+        },
+        handler: (ctx, args) => {
+            const { dryRun: _dryRun, ...overrides } = args;
+            return createWeapon(ctx.projectPath, overrides);
+        },
+    },
+    {
+        name: 'update_weapon',
+        mutates: true,
+        description: "Update a weapon's properties (shallow merge into the existing record)",
+        inputSchema: {
+            weaponId: z.number().int().positive().describe('The ID of the weapon to update'),
+            updates: z
+                .record(z.string(), z.unknown())
+                .describe('Object containing weapon properties to update'),
+        },
+        handler: (ctx, args) => updateWeapon(ctx.projectPath, args.weaponId, args.updates),
+    },
+    {
+        name: 'create_armor',
+        mutates: true,
+        description: "Create a new armor in data/Armors.json. Only `name` is required; omitted fields use the editor's new-armor defaults (Shield equip slot, no stat bonuses). `params` is a flat 8-length stat bonus; `etypeId` is the equip slot (System.json equipTypes: 2 Shield, 3 Head, 4 Body, 5 Accessory). Allocates and returns the next unused armor id.",
+        inputSchema: {
+            name: z.string().describe('Armor name'),
+            description: z.string().optional().describe('In-game description text'),
+            iconIndex: z.number().int().optional().describe('Icon index (IconSet.png)'),
+            atypeId: z.number().int().optional().describe('Armor type id (System.json armorTypes)'),
+            etypeId: z
+                .number()
+                .int()
+                .optional()
+                .describe('Equip slot (equipTypes: 2 Shield, 3 Head, 4 Body, 5 Accessory)'),
+            price: z.number().int().optional().describe('Buy price'),
+            params: z
+                .array(z.number())
+                .length(8)
+                .optional()
+                .describe('8 flat stat bonuses [maxHP, maxMP, atk, def, mat, mdf, agi, luk]'),
+            traits: z.array(z.unknown()).optional().describe('Trait objects { code, dataId, value }'),
+            note: z.string().optional().describe('Note field'),
+        },
+        handler: (ctx, args) => {
+            const { dryRun: _dryRun, ...overrides } = args;
+            return createArmor(ctx.projectPath, overrides);
+        },
+    },
+    {
+        name: 'update_armor',
+        mutates: true,
+        description: "Update an armor's properties (shallow merge into the existing record)",
+        inputSchema: {
+            armorId: z.number().int().positive().describe('The ID of the armor to update'),
+            updates: z
+                .record(z.string(), z.unknown())
+                .describe('Object containing armor properties to update'),
+        },
+        handler: (ctx, args) => updateArmor(ctx.projectPath, args.armorId, args.updates),
+    },
+];
+//# sourceMappingURL=itemTools.js.map

package/dist/tools/itemTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"itemTools.js","sourceRoot":"","sources":["../../src/tools/itemTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,iFAAiF;AACjF,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,IAAI,EAAE,EAAE;QACR,WAAW,EAAE,EAAE;QACf,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC,EAAE,eAAe;QAC3B,KAAK,EAAE,CAAC,EAAE,OAAO;QACjB,QAAQ,EAAE,CAAC,EAAE,SAAS;QACtB,KAAK,EAAE,CAAC;QACR,WAAW,EAAE,GAAG;QAChB,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,CAAC;QACT,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,CAAC;QACd,KAAK,EAAE,CAAC;QACR,UAAU,EAAE,IAAI;QAChB,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC9E,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,EAAE;KACT,CAAC;AACJ,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,IAAI,EAAE,EAAE;QACR,WAAW,EAAE,EAAE;QACf,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,CAAC;QACd,IAAI,EAAE,EAAE;KACT,CAAC;AACJ,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,IAAI,EAAE,EAAE;QACR,WAAW,EAAE,EAAE;QACf,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,EAAE;KACT,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,WAAmB;IAChD,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACzD,OAAO,MAAM,YAAY,CAAkB,SAAS,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,WAAmB;IAClD,MAAM,WAAW,GAAG,WAAW,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAC7D,OAAO,MAAM,YAAY,CAAoB,WAAW,CAAC,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,WAAmB;IACjD,MAAM,UAAU,GAAG,WAAW,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAC3D,OAAO,MAAM,YAAY,CAAmB,UAAU,CAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,WAAmB;IACjD,MAAM,UAAU,GAAG,WAAW,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAC3D,OAAO,MAAM,YAAY,CAAmB,UAAU,CAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,WAAmB,EAAE,MAAc;IAC/D,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,WAAmB,EACnB,MAAc,EACd,OAAsB;IAEtB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IAExE,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,gBAAgB,MAAM,YAAY,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,CAAE,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;IAEpE,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACzD,MAAM,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAErC,OAAO,KAAK,CAAC,SAAS,CAAE,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,QAAyB,EAAE,KAAgC;IACzF,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACzF,OAAO;QACL,GAAG,WAAW,EAAE;QAChB,GAAG,WAAW,CAAC,KAAK,CAAC;QACrB,EAAE,EAAE,KAAK,GAAG,CAAC;KACd,CAAC;AACJ,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,iBAAiB,CAC/B,QAA2B,EAC3B,KAAkC;IAElC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7E,OAAO;QACL,GAAG,aAAa,EAAE;QAClB,GAAG,WAAW,CAAC,KAAK,CAAC;QACrB,EAAE,EAAE,KAAK,GAAG,CAAC;KACd,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,gBAAgB,CAC9B,QAA0B,EAC1B,KAAiC;IAEjC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7E,OAAO;QACL,GAAG,YAAY,EAAE;QACjB,GAAG,WAAW,CAAC,KAAK,CAAC;QACrB,EAAE,EAAE,KAAK,GAAG,CAAC;KACd,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,WAAmB,EAAE,IAAU;IACxE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACvD,iBAAiB,CAAC,WAAW,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;QAC1D,iBAAiB,CAAC,WAAW,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;QAC1D,iBAAiB,CAAC,WAAW,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;KACjE,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,qBAAqB,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IACtF,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,IAAI,MAAM,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,WAAmB,EACnB,SAAoC;IAEpC,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC;IAE1C,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAElD,MAAM,oBAAoB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAEjD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEpB,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACzD,MAAM,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAErC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAmB,EACnB,SAAsC;IAEtC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAExB,MAAM,WAAW,GAAG,WAAW,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAC7D,MAAM,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAEzC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,WAAmB,EACnB,SAAqC;IAErC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACrD,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEtB,MAAM,UAAU,GAAG,WAAW,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAC3D,MAAM,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAEvC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAmB,EACnB,QAAgB,EAChB,OAAwB;IAExB,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,IAAI,MAAM,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;IAEpF,IAAI,WAAW,KAAK,CAAC,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,kBAAkB,QAAQ,YAAY,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,WAAW,CAAE,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;IAE9E,MAAM,WAAW,GAAG,WAAW,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAC7D,MAAM,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAEzC,OAAO,OAAO,CAAC,WAAW,CAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,WAAmB,EACnB,OAAe,EACf,OAAuB;IAEvB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,KAAK,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IAE9E,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,iBAAiB,OAAO,YAAY,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,UAAU,CAAE,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;IAEzE,MAAM,UAAU,GAAG,WAAW,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAC3D,MAAM,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAEvC,OAAO,MAAM,CAAC,UAAU,CAAE,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,WAAmB,EACnB,OAAe,EACf,OAAuB;IAEvB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,KAAK,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IAE9E,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,iBAAiB,OAAO,YAAY,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,UAAU,CAAE,EAAE,GAAG,OAAO,EAAE,CAAC;IAE5D,MAAM,UAAU,GAAG,WAAW,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAC3D,MAAM,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAEvC,OAAO,MAAM,CAAC,UAAU,CAAE,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,WAAmB,EAAE,UAAkB;IACvE,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC1C,MAAM,eAAe,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IAEjD,OAAO,KAAK,CAAC,MAAM,CACjB,CAAC,IAAI,EAAgB,EAAE,CACrB,CAAC,CAAC,IAAI;QACN,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;YAChD,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAC9D,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAqB;IACnD;QACE,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,IAAI;QACb,WAAW,EACT,gWAAgW;QAClW,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;YACtC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;YACvE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;YAC3E,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,CAAC,0DAA0D,CAAC;YACvE,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,CAAC,mDAAmD,CAAC;YAChE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;YAC7F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YACzE,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YAC9D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YACzE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;YACvE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YACrE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;YACjF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;YAC9E,MAAM,EAAE,CAAC;iBACN,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;iBAC/B,QAAQ,EAAE;iBACV,QAAQ,CAAC,gEAAgE,CAAC;YAC7E,OAAO,EAAE,CAAC;iBACP,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;iBAClB,QAAQ,EAAE;iBACV,QAAQ,CAAC,iDAAiD,CAAC;YAC9D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;SACnD;QACD,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YACrB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,EAAE,GAAG,IAAI,CAAC;YAC/C,OAAO,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,SAAsC,CAAC,CAAC;QAC7E,CAAC;KACF;IACD;QACE,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,sEAAsE;QACnF,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;YAC5E,OAAO,EAAE,CAAC;iBACP,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;iBAC/B,QAAQ,CAAC,6CAA6C,CAAC;SAC3D;QACD,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC;KAC/E;IACD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,qCAAqC;QAClD,WAAW,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC,EAAE;QACjF,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC;KACtE;IACD;QACE,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,IAAI;QACb,WAAW,EACT,oSAAoS;QACtS,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;YACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;YACvE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;YAC3E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;YACzF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;YACxD,MAAM,EAAE,CAAC;iBACN,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,MAAM,CAAC,CAAC,CAAC;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,kEAAkE,CAAC;YAC/E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;YACxE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;YACzF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;SACnD;QACD,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YACrB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,EAAE,GAAG,IAAI,CAAC;YAC/C,OAAO,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,SAAwC,CAAC,CAAC;QACjF,CAAC;KACF;IACD;QACE,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,uEAAuE;QACpF,WAAW,EAAE;YACX,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;YAChF,OAAO,EAAE,CAAC;iBACP,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;iBAC/B,QAAQ,CAAC,+CAA+C,CAAC;SAC7D;QACD,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC;KACnF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,IAAI;QACb,WAAW,EACT,gVAAgV;QAClV,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;YACvC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;YACvE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;YAC3E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;YACvF,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,CAAC,gEAAgE,CAAC;YAC7E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;YACxD,MAAM,EAAE,CAAC;iBACN,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,MAAM,CAAC,CAAC,CAAC;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,kEAAkE,CAAC;YAC/E,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;YACzF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;SACnD;QACD,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YACrB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,EAAE,GAAG,IAAI,CAAC;YAC/C,OAAO,WAAW,CAAC,GAAG,CAAC,WAAW,EAAE,SAAuC,CAAC,CAAC;QAC/E,CAAC;KACF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,uEAAuE;QACpF,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;YAC9E,OAAO,EAAE,CAAC;iBACP,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;iBAC/B,QAAQ,CAAC,8CAA8C,CAAC;SAC5D;QACD,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC;KACjF;CACF,CAAC"}

package/dist/tools/listTools.d.ts

@@ -0,0 +1,58 @@
+import { ToolDefinition } from '../registry.js';
+/**
+ * Database tables that can be listed as a names-only index. Each is stored as a
+ * 1-indexed JSON array whose entries share an `{ id, name }` shape (slot 0 is
+ * null), so a single generic lister covers all of them.
+ */
+export declare const LISTABLE_FILES: {
+    readonly actors: "Actors.json";
+    readonly classes: "Classes.json";
+    readonly items: "Items.json";
+    readonly weapons: "Weapons.json";
+    readonly armors: "Armors.json";
+    readonly skills: "Skills.json";
+    readonly enemies: "Enemies.json";
+    readonly troops: "Troops.json";
+    readonly states: "States.json";
+    readonly common_events: "CommonEvents.json";
+    readonly tilesets: "Tilesets.json";
+    readonly maps: "MapInfos.json";
+};
+export type ListableType = keyof typeof LISTABLE_FILES;
+/**
+ * The subset of {@link LISTABLE_FILES} that `get_database` dumps in full. Two
+ * listable tables are deliberately absent: `maps` is an index, not a record
+ * table (`get_map_infos` / `get_map` own it), and a raw `tilesets` dump carries
+ * an 8192-entry `flags` array per tileset — `get_tilesets` summarizes it and
+ * `get_tile_flags` decodes single entries instead.
+ */
+export declare const DATABASE_TYPES: readonly ["actors", "classes", "items", "weapons", "armors", "skills", "enemies", "troops", "states", "common_events"];
+export type DatabaseType = (typeof DATABASE_TYPES)[number];
+/**
+ * Read one database table in full, or a single record from it by id.
+ *
+ * Every table is a 1-indexed array whose slot 0 is null, so one generic reader
+ * replaces the ten per-table `get_*` dumps that each cost a client a tool slot.
+ * The return shapes are the ones those tools had: the raw array (slot-0 null
+ * included) for a whole table, the record or `null` for a lookup that misses.
+ */
+export declare function getDatabase<T extends {
+    id: number;
+}>(projectPath: string, type: DatabaseType, id?: number): Promise<(T | null)[] | T | null>;
+export interface NamedEntry {
+    id: number;
+    name: string;
+}
+export interface NamedIndex {
+    type: ListableType;
+    count: number;
+    entries: NamedEntry[];
+}
+/**
+ * Return a compact `{ id, name }` index for one database table — far cheaper
+ * than the full-record `get_*`/`search_*` dumps when all you need is to look up
+ * or sanity-check an ID before wiring it into an event.
+ */
+export declare function listNames(projectPath: string, type: ListableType): Promise<NamedIndex>;
+export declare const listToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=listTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"listTools.d.ts","sourceRoot":"","sources":["../../src/tools/listTools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;CAajB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,cAAc,CAAC;AAEvD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,wHAWjB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACxD,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,YAAY,EAClB,EAAE,CAAC,EAAE,MAAM,GACV,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CAIlC;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAc5F;AAED,eAAO,MAAM,mBAAmB,EAAE,cAAc,EAiC/C,CAAC"}

package/dist/tools/listTools.js

@@ -0,0 +1,99 @@
+import { z } from 'zod';
+import { readJsonFile, getDataPath } from '../utils/fileHandler.js';
+/**
+ * Database tables that can be listed as a names-only index. Each is stored as a
+ * 1-indexed JSON array whose entries share an `{ id, name }` shape (slot 0 is
+ * null), so a single generic lister covers all of them.
+ */
+export const LISTABLE_FILES = {
+    actors: 'Actors.json',
+    classes: 'Classes.json',
+    items: 'Items.json',
+    weapons: 'Weapons.json',
+    armors: 'Armors.json',
+    skills: 'Skills.json',
+    enemies: 'Enemies.json',
+    troops: 'Troops.json',
+    states: 'States.json',
+    common_events: 'CommonEvents.json',
+    tilesets: 'Tilesets.json',
+    maps: 'MapInfos.json',
+};
+/**
+ * The subset of {@link LISTABLE_FILES} that `get_database` dumps in full. Two
+ * listable tables are deliberately absent: `maps` is an index, not a record
+ * table (`get_map_infos` / `get_map` own it), and a raw `tilesets` dump carries
+ * an 8192-entry `flags` array per tileset — `get_tilesets` summarizes it and
+ * `get_tile_flags` decodes single entries instead.
+ */
+export const DATABASE_TYPES = [
+    'actors',
+    'classes',
+    'items',
+    'weapons',
+    'armors',
+    'skills',
+    'enemies',
+    'troops',
+    'states',
+    'common_events',
+];
+/**
+ * Read one database table in full, or a single record from it by id.
+ *
+ * Every table is a 1-indexed array whose slot 0 is null, so one generic reader
+ * replaces the ten per-table `get_*` dumps that each cost a client a tool slot.
+ * The return shapes are the ones those tools had: the raw array (slot-0 null
+ * included) for a whole table, the record or `null` for a lookup that misses.
+ */
+export async function getDatabase(projectPath, type, id) {
+    const records = await readJsonFile(getDataPath(projectPath, LISTABLE_FILES[type]));
+    if (id === undefined)
+        return records;
+    return records.find((record) => record && record.id === id) ?? null;
+}
+/**
+ * Return a compact `{ id, name }` index for one database table — far cheaper
+ * than the full-record `get_*`/`search_*` dumps when all you need is to look up
+ * or sanity-check an ID before wiring it into an event.
+ */
+export async function listNames(projectPath, type) {
+    const file = LISTABLE_FILES[type];
+    if (!file) {
+        throw new Error(`Unknown list type: ${type}. Valid types: ${Object.keys(LISTABLE_FILES).join(', ')}`);
+    }
+    const records = await readJsonFile(getDataPath(projectPath, file));
+    const entries = records
+        .filter((record) => record != null)
+        .map((record) => ({ id: record.id, name: record.name }));
+    return { type, count: entries.length, entries };
+}
+export const listToolDefinitions = [
+    {
+        name: 'list_names',
+        description: 'Cheap names-only index for a database table. Returns { id, name } entries instead of full records — use it to look up or sanity-check IDs before wiring them into events, without paying the token cost of a full get_*/search_* dump.',
+        inputSchema: {
+            type: z
+                .enum(Object.keys(LISTABLE_FILES))
+                .describe('Which table to index: actors, classes, items, weapons, armors, skills, enemies, troops, states, common_events, tilesets, or maps.'),
+        },
+        handler: (ctx, args) => listNames(ctx.projectPath, args.type),
+    },
+    {
+        name: 'get_database',
+        description: 'Read a database table in full: actors, classes, items, weapons, armors, skills, enemies, troops, states, or common_events. Returns the raw 1-indexed array (slot 0 is null), or — with `id` — that single record, or null if no such record exists. These are full records: prefer list_names for an id→name index, or search_actors/search_items/search_skills to find records by name, and reach for this only when you need every field. Maps and tilesets are not here: use get_map_infos/get_map and get_tilesets/get_tile_flags. Read-only.',
+        inputSchema: {
+            type: z
+                .enum(DATABASE_TYPES)
+                .describe('Which table to read: actors, classes, items, weapons, armors, skills, enemies, troops, states, or common_events.'),
+            id: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe('Return just this record (null if missing); omitted = the whole table'),
+        },
+        handler: (ctx, args) => getDatabase(ctx.projectPath, args.type, args.id),
+    },
+];
+//# sourceMappingURL=listTools.js.map