@satelliteoflove/godot-mcp 0.1.4 → 0.1.6

package/dist/tools/animation.d.ts

@@ -1,281 +1,217 @@
+/**
+ * Animation Tools - consolidated tools for animation operations
+ *
+ * SCHEMA PATTERN FOR CONSOLIDATED TOOLS:
+ *
+ * Claude Code requires tool schemas to have `type: "object"` at the root.
+ * Do NOT use z.discriminatedUnion() - it generates `anyOf` at the root level,
+ * which causes Claude Code to reject the entire MCP tool list.
+ *
+ * Instead, use a flat object schema with .refine() for runtime validation:
+ *
+ *   const Schema = z.object({
+ *     action: z.enum(['foo', 'bar']).describe('Action: foo, bar'),
+ *     param1: z.string().optional().describe('Description (foo only)'),
+ *     param2: z.number().optional().describe('Description (bar only)'),
+ *   }).refine((data) => {
+ *     switch (data.action) {
+ *       case 'foo': return !!data.param1;
+ *       case 'bar': return data.param2 !== undefined;
+ *     }
+ *   }, { message: 'Missing required fields for action' });
+ *
+ * The .refine() runs at runtime only - it doesn't affect the JSON schema output.
+ * Use field descriptions to indicate which action each field applies to.
+ */
 import { z } from 'zod';
 import type { AnyToolDefinition } from '../core/types.js';
-export declare const listAnimationPlayers: import("../core/types.js").ToolDefinition<z.ZodObject<{
+export declare const animationQuery: import("../core/types.js").ToolDefinition<z.ZodEffects<z.ZodObject<{
+    action: z.ZodEnum<["list_players", "get_info", "get_details", "get_keyframes"]>;
     root_path: z.ZodOptional<z.ZodString>;
+    node_path: z.ZodOptional<z.ZodString>;
+    animation_name: z.ZodOptional<z.ZodString>;
+    track_index: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
+    action: "list_players" | "get_info" | "get_details" | "get_keyframes";
+    node_path?: string | undefined;
     root_path?: string | undefined;
+    animation_name?: string | undefined;
+    track_index?: number | undefined;
 }, {
+    action: "list_players" | "get_info" | "get_details" | "get_keyframes";
+    node_path?: string | undefined;
     root_path?: string | undefined;
-}>>;
-export declare const getAnimationPlayerInfo: import("../core/types.js").ToolDefinition<z.ZodObject<{
-    node_path: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    node_path: string;
-}, {
-    node_path: string;
-}>>;
-export declare const getAnimationDetails: import("../core/types.js").ToolDefinition<z.ZodObject<{
-    node_path: z.ZodString;
-    animation_name: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    node_path: string;
-    animation_name: string;
-}, {
-    node_path: string;
-    animation_name: string;
-}>>;
-export declare const getTrackKeyframes: import("../core/types.js").ToolDefinition<z.ZodObject<{
-    node_path: z.ZodString;
-    animation_name: z.ZodString;
-    track_index: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    node_path: string;
-    animation_name: string;
-    track_index: number;
+    animation_name?: string | undefined;
+    track_index?: number | undefined;
+}>, {
+    action: "list_players" | "get_info" | "get_details" | "get_keyframes";
+    node_path?: string | undefined;
+    root_path?: string | undefined;
+    animation_name?: string | undefined;
+    track_index?: number | undefined;
 }, {
-    node_path: string;
-    animation_name: string;
-    track_index: number;
+    action: "list_players" | "get_info" | "get_details" | "get_keyframes";
+    node_path?: string | undefined;
+    root_path?: string | undefined;
+    animation_name?: string | undefined;
+    track_index?: number | undefined;
 }>>;
-export declare const playAnimation: import("../core/types.js").ToolDefinition<z.ZodObject<{
+export declare const animationPlayback: import("../core/types.js").ToolDefinition<z.ZodEffects<z.ZodObject<{
+    action: z.ZodEnum<["play", "stop", "pause", "seek", "queue", "clear_queue"]>;
     node_path: z.ZodString;
-    animation_name: z.ZodString;
+    animation_name: z.ZodOptional<z.ZodString>;
     custom_blend: z.ZodOptional<z.ZodNumber>;
     custom_speed: z.ZodOptional<z.ZodNumber>;
     from_end: z.ZodOptional<z.ZodBoolean>;
+    keep_state: z.ZodOptional<z.ZodBoolean>;
+    paused: z.ZodOptional<z.ZodBoolean>;
+    seconds: z.ZodOptional<z.ZodNumber>;
+    update: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     node_path: string;
-    animation_name: string;
+    action: "play" | "stop" | "pause" | "seek" | "queue" | "clear_queue";
+    animation_name?: string | undefined;
     custom_blend?: number | undefined;
     custom_speed?: number | undefined;
     from_end?: boolean | undefined;
+    keep_state?: boolean | undefined;
+    paused?: boolean | undefined;
+    seconds?: number | undefined;
+    update?: boolean | undefined;
 }, {
     node_path: string;
-    animation_name: string;
+    action: "play" | "stop" | "pause" | "seek" | "queue" | "clear_queue";
+    animation_name?: string | undefined;
     custom_blend?: number | undefined;
     custom_speed?: number | undefined;
     from_end?: boolean | undefined;
-}>>;
-export declare const stopAnimation: import("../core/types.js").ToolDefinition<z.ZodObject<{
-    node_path: z.ZodString;
-    keep_state: z.ZodOptional<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    node_path: string;
     keep_state?: boolean | undefined;
-}, {
+    paused?: boolean | undefined;
+    seconds?: number | undefined;
+    update?: boolean | undefined;
+}>, {
     node_path: string;
+    action: "play" | "stop" | "pause" | "seek" | "queue" | "clear_queue";
+    animation_name?: string | undefined;
+    custom_blend?: number | undefined;
+    custom_speed?: number | undefined;
+    from_end?: boolean | undefined;
     keep_state?: boolean | undefined;
-}>>;
-export declare const pauseAnimation: import("../core/types.js").ToolDefinition<z.ZodObject<{
-    node_path: z.ZodString;
-    paused: z.ZodBoolean;
-}, "strip", z.ZodTypeAny, {
-    node_path: string;
-    paused: boolean;
-}, {
-    node_path: string;
-    paused: boolean;
-}>>;
-export declare const seekAnimation: import("../core/types.js").ToolDefinition<z.ZodObject<{
-    node_path: z.ZodString;
-    seconds: z.ZodNumber;
-    update: z.ZodOptional<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    node_path: string;
-    seconds: number;
+    paused?: boolean | undefined;
+    seconds?: number | undefined;
     update?: boolean | undefined;
 }, {
     node_path: string;
-    seconds: number;
+    action: "play" | "stop" | "pause" | "seek" | "queue" | "clear_queue";
+    animation_name?: string | undefined;
+    custom_blend?: number | undefined;
+    custom_speed?: number | undefined;
+    from_end?: boolean | undefined;
+    keep_state?: boolean | undefined;
+    paused?: boolean | undefined;
+    seconds?: number | undefined;
     update?: boolean | undefined;
 }>>;
-export declare const queueAnimation: import("../core/types.js").ToolDefinition<z.ZodObject<{
-    node_path: z.ZodString;
-    animation_name: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    node_path: string;
-    animation_name: string;
-}, {
-    node_path: string;
-    animation_name: string;
-}>>;
-export declare const clearAnimationQueue: import("../core/types.js").ToolDefinition<z.ZodObject<{
-    node_path: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    node_path: string;
-}, {
-    node_path: string;
-}>>;
-export declare const createAnimation: import("../core/types.js").ToolDefinition<z.ZodObject<{
+export declare const animationEdit: import("../core/types.js").ToolDefinition<z.ZodEffects<z.ZodObject<{
+    action: z.ZodEnum<["create", "delete", "rename", "update_props", "add_track", "remove_track", "add_keyframe", "remove_keyframe", "update_keyframe"]>;
     node_path: z.ZodString;
-    animation_name: z.ZodString;
+    animation_name: z.ZodOptional<z.ZodString>;
     library_name: z.ZodOptional<z.ZodString>;
     length: z.ZodOptional<z.ZodNumber>;
     loop_mode: z.ZodOptional<z.ZodEnum<["none", "linear", "pingpong"]>>;
     step: z.ZodOptional<z.ZodNumber>;
+    old_name: z.ZodOptional<z.ZodString>;
+    new_name: z.ZodOptional<z.ZodString>;
+    track_type: z.ZodOptional<z.ZodEnum<["value", "position_3d", "rotation_3d", "scale_3d", "blend_shape", "method", "bezier", "audio", "animation"]>>;
+    track_path: z.ZodOptional<z.ZodString>;
+    insert_at: z.ZodOptional<z.ZodNumber>;
+    track_index: z.ZodOptional<z.ZodNumber>;
+    time: z.ZodOptional<z.ZodNumber>;
+    value: z.ZodOptional<z.ZodUnknown>;
+    transition: z.ZodOptional<z.ZodNumber>;
+    method_name: z.ZodOptional<z.ZodString>;
+    args: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+    keyframe_index: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     node_path: string;
-    animation_name: string;
+    action: "create" | "delete" | "rename" | "update_props" | "add_track" | "remove_track" | "add_keyframe" | "remove_keyframe" | "update_keyframe";
+    value?: unknown;
     length?: number | undefined;
+    animation_name?: string | undefined;
+    track_index?: number | undefined;
     library_name?: string | undefined;
     loop_mode?: "none" | "linear" | "pingpong" | undefined;
     step?: number | undefined;
+    old_name?: string | undefined;
+    new_name?: string | undefined;
+    track_type?: "value" | "audio" | "position_3d" | "rotation_3d" | "scale_3d" | "blend_shape" | "method" | "bezier" | "animation" | undefined;
+    track_path?: string | undefined;
+    insert_at?: number | undefined;
+    time?: number | undefined;
+    transition?: number | undefined;
+    method_name?: string | undefined;
+    args?: unknown[] | undefined;
+    keyframe_index?: number | undefined;
 }, {
     node_path: string;
-    animation_name: string;
+    action: "create" | "delete" | "rename" | "update_props" | "add_track" | "remove_track" | "add_keyframe" | "remove_keyframe" | "update_keyframe";
+    value?: unknown;
     length?: number | undefined;
+    animation_name?: string | undefined;
+    track_index?: number | undefined;
     library_name?: string | undefined;
     loop_mode?: "none" | "linear" | "pingpong" | undefined;
     step?: number | undefined;
-}>>;
-export declare const deleteAnimation: import("../core/types.js").ToolDefinition<z.ZodObject<{
-    node_path: z.ZodString;
-    animation_name: z.ZodString;
-    library_name: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    node_path: string;
-    animation_name: string;
-    library_name?: string | undefined;
-}, {
-    node_path: string;
-    animation_name: string;
-    library_name?: string | undefined;
-}>>;
-export declare const renameAnimation: import("../core/types.js").ToolDefinition<z.ZodObject<{
-    node_path: z.ZodString;
-    old_name: z.ZodString;
-    new_name: z.ZodString;
-    library_name: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    node_path: string;
-    old_name: string;
-    new_name: string;
-    library_name?: string | undefined;
-}, {
-    node_path: string;
-    old_name: string;
-    new_name: string;
-    library_name?: string | undefined;
-}>>;
-export declare const updateAnimationProperties: import("../core/types.js").ToolDefinition<z.ZodObject<{
-    node_path: z.ZodString;
-    animation_name: z.ZodString;
-    length: z.ZodOptional<z.ZodNumber>;
-    loop_mode: z.ZodOptional<z.ZodEnum<["none", "linear", "pingpong"]>>;
-    step: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    node_path: string;
-    animation_name: string;
-    length?: number | undefined;
-    loop_mode?: "none" | "linear" | "pingpong" | undefined;
-    step?: number | undefined;
-}, {
-    node_path: string;
-    animation_name: string;
-    length?: number | undefined;
-    loop_mode?: "none" | "linear" | "pingpong" | undefined;
-    step?: number | undefined;
-}>>;
-export declare const addAnimationTrack: import("../core/types.js").ToolDefinition<z.ZodObject<{
-    node_path: z.ZodString;
-    animation_name: z.ZodString;
-    track_type: z.ZodEnum<["value", "position_3d", "rotation_3d", "scale_3d", "blend_shape", "method", "bezier", "audio", "animation"]>;
-    track_path: z.ZodString;
-    insert_at: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    node_path: string;
-    animation_name: string;
-    track_type: "value" | "audio" | "position_3d" | "rotation_3d" | "scale_3d" | "blend_shape" | "method" | "bezier" | "animation";
-    track_path: string;
+    old_name?: string | undefined;
+    new_name?: string | undefined;
+    track_type?: "value" | "audio" | "position_3d" | "rotation_3d" | "scale_3d" | "blend_shape" | "method" | "bezier" | "animation" | undefined;
+    track_path?: string | undefined;
     insert_at?: number | undefined;
-}, {
-    node_path: string;
-    animation_name: string;
-    track_type: "value" | "audio" | "position_3d" | "rotation_3d" | "scale_3d" | "blend_shape" | "method" | "bezier" | "animation";
-    track_path: string;
-    insert_at?: number | undefined;
-}>>;
-export declare const removeAnimationTrack: import("../core/types.js").ToolDefinition<z.ZodObject<{
-    node_path: z.ZodString;
-    animation_name: z.ZodString;
-    track_index: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    node_path: string;
-    animation_name: string;
-    track_index: number;
-}, {
-    node_path: string;
-    animation_name: string;
-    track_index: number;
-}>>;
-export declare const addKeyframe: import("../core/types.js").ToolDefinition<z.ZodObject<{
-    node_path: z.ZodString;
-    animation_name: z.ZodString;
-    track_index: z.ZodNumber;
-    time: z.ZodNumber;
-    value: z.ZodUnknown;
-    transition: z.ZodOptional<z.ZodNumber>;
-    method_name: z.ZodOptional<z.ZodString>;
-    args: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
-}, "strip", z.ZodTypeAny, {
-    node_path: string;
-    animation_name: string;
-    track_index: number;
-    time: number;
-    value?: unknown;
+    time?: number | undefined;
     transition?: number | undefined;
     method_name?: string | undefined;
     args?: unknown[] | undefined;
-}, {
+    keyframe_index?: number | undefined;
+}>, {
     node_path: string;
-    animation_name: string;
-    track_index: number;
-    time: number;
+    action: "create" | "delete" | "rename" | "update_props" | "add_track" | "remove_track" | "add_keyframe" | "remove_keyframe" | "update_keyframe";
     value?: unknown;
+    length?: number | undefined;
+    animation_name?: string | undefined;
+    track_index?: number | undefined;
+    library_name?: string | undefined;
+    loop_mode?: "none" | "linear" | "pingpong" | undefined;
+    step?: number | undefined;
+    old_name?: string | undefined;
+    new_name?: string | undefined;
+    track_type?: "value" | "audio" | "position_3d" | "rotation_3d" | "scale_3d" | "blend_shape" | "method" | "bezier" | "animation" | undefined;
+    track_path?: string | undefined;
+    insert_at?: number | undefined;
+    time?: number | undefined;
     transition?: number | undefined;
     method_name?: string | undefined;
     args?: unknown[] | undefined;
-}>>;
-export declare const removeKeyframe: import("../core/types.js").ToolDefinition<z.ZodObject<{
-    node_path: z.ZodString;
-    animation_name: z.ZodString;
-    track_index: z.ZodNumber;
-    keyframe_index: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    node_path: string;
-    animation_name: string;
-    track_index: number;
-    keyframe_index: number;
+    keyframe_index?: number | undefined;
 }, {
     node_path: string;
-    animation_name: string;
-    track_index: number;
-    keyframe_index: number;
-}>>;
-export declare const updateKeyframe: import("../core/types.js").ToolDefinition<z.ZodObject<{
-    node_path: z.ZodString;
-    animation_name: z.ZodString;
-    track_index: z.ZodNumber;
-    keyframe_index: z.ZodNumber;
-    time: z.ZodOptional<z.ZodNumber>;
-    value: z.ZodOptional<z.ZodUnknown>;
-    transition: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    node_path: string;
-    animation_name: string;
-    track_index: number;
-    keyframe_index: number;
-    value?: unknown;
-    time?: number | undefined;
-    transition?: number | undefined;
-}, {
-    node_path: string;
-    animation_name: string;
-    track_index: number;
-    keyframe_index: number;
+    action: "create" | "delete" | "rename" | "update_props" | "add_track" | "remove_track" | "add_keyframe" | "remove_keyframe" | "update_keyframe";
     value?: unknown;
+    length?: number | undefined;
+    animation_name?: string | undefined;
+    track_index?: number | undefined;
+    library_name?: string | undefined;
+    loop_mode?: "none" | "linear" | "pingpong" | undefined;
+    step?: number | undefined;
+    old_name?: string | undefined;
+    new_name?: string | undefined;
+    track_type?: "value" | "audio" | "position_3d" | "rotation_3d" | "scale_3d" | "blend_shape" | "method" | "bezier" | "animation" | undefined;
+    track_path?: string | undefined;
+    insert_at?: number | undefined;
     time?: number | undefined;
     transition?: number | undefined;
+    method_name?: string | undefined;
+    args?: unknown[] | undefined;
+    keyframe_index?: number | undefined;
 }>>;
 export declare const animationTools: AnyToolDefinition[];
 //# sourceMappingURL=animation.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"animation.d.ts","sourceRoot":"","sources":["../../src/tools/animation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,eAAO,MAAM,oBAAoB;;;;;;GAmB/B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;GAkBjC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;GA4B9B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;GAyB5B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;GAiCxB,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;GAcxB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;GAWzB,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;GAkBxB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;GAczB,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;GAU9B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;GA8B1B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;GAkB1B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;GAkB1B,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;GA6BpC,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;GA4C5B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;GAe/B,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDtB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;GAwBzB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;GAsCzB,CAAC;AAEH,eAAO,MAAM,cAAc,EAoBtB,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"animation.d.ts","sourceRoot":"","sources":["../../src/tools/animation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AA4B1D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEzB,CAAC;AAmCH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyD5B,CAAC;AAiFH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0HxB,CAAC;AAEH,eAAO,MAAM,cAAc,EAAyD,iBAAiB,EAAE,CAAC"}