@satelliteoflove/godot-mcp 1.1.1 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=resource.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resource.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/tools/resource.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,146 @@
1
+ import { describe, it, expect, beforeEach } from 'vitest';
2
+ import { readFileSync } from 'fs';
3
+ import { join, dirname } from 'path';
4
+ import { fileURLToPath } from 'url';
5
+ import { createMockGodot, createToolContext, } from '../helpers/mock-godot.js';
6
+ import { getResourceInfo } from '../../tools/resource.js';
7
+ const __dirname = dirname(fileURLToPath(import.meta.url));
8
+ const FIXTURES_DIR = join(__dirname, '../fixtures');
9
+ function loadFixture(name) {
10
+ const filepath = join(FIXTURES_DIR, `${name}.json`);
11
+ return JSON.parse(readFileSync(filepath, 'utf-8'));
12
+ }
13
+ describe('Resource Tools', () => {
14
+ let mock;
15
+ beforeEach(() => {
16
+ mock = createMockGodot();
17
+ });
18
+ describe('schema validation', () => {
19
+ it('requires resource_path', () => {
20
+ expect(getResourceInfo.schema.safeParse({}).success).toBe(false);
21
+ });
22
+ it('accepts valid resource_path', () => {
23
+ expect(getResourceInfo.schema.safeParse({ resource_path: 'res://test.tres' }).success).toBe(true);
24
+ });
25
+ it('accepts optional max_depth', () => {
26
+ const result = getResourceInfo.schema.safeParse({
27
+ resource_path: 'res://test.tres',
28
+ max_depth: 2,
29
+ });
30
+ expect(result.success).toBe(true);
31
+ });
32
+ it('accepts optional include_internal', () => {
33
+ const result = getResourceInfo.schema.safeParse({
34
+ resource_path: 'res://test.tres',
35
+ include_internal: true,
36
+ });
37
+ expect(result.success).toBe(true);
38
+ });
39
+ it('rejects invalid max_depth type', () => {
40
+ const result = getResourceInfo.schema.safeParse({
41
+ resource_path: 'res://test.tres',
42
+ max_depth: 'deep',
43
+ });
44
+ expect(result.success).toBe(false);
45
+ });
46
+ });
47
+ describe('command execution', () => {
48
+ it('sends correct command name', async () => {
49
+ mock.mockResponse({ resource_path: 'res://test.tres', resource_type: 'Resource' });
50
+ const ctx = createToolContext(mock);
51
+ await getResourceInfo.execute({ resource_path: 'res://test.tres' }, ctx);
52
+ expect(mock.calls[0].command).toBe('get_resource_info');
53
+ });
54
+ it('applies default max_depth of 1', async () => {
55
+ mock.mockResponse({ resource_path: 'res://test.tres', resource_type: 'Resource' });
56
+ const ctx = createToolContext(mock);
57
+ await getResourceInfo.execute({ resource_path: 'res://test.tres' }, ctx);
58
+ expect(mock.calls[0].params.max_depth).toBe(1);
59
+ });
60
+ it('applies default include_internal of false', async () => {
61
+ mock.mockResponse({ resource_path: 'res://test.tres', resource_type: 'Resource' });
62
+ const ctx = createToolContext(mock);
63
+ await getResourceInfo.execute({ resource_path: 'res://test.tres' }, ctx);
64
+ expect(mock.calls[0].params.include_internal).toBe(false);
65
+ });
66
+ it('passes custom max_depth', async () => {
67
+ mock.mockResponse({ resource_path: 'res://test.tres', resource_type: 'Resource' });
68
+ const ctx = createToolContext(mock);
69
+ await getResourceInfo.execute({ resource_path: 'res://test.tres', max_depth: 0 }, ctx);
70
+ expect(mock.calls[0].params.max_depth).toBe(0);
71
+ });
72
+ it('propagates errors from Godot', async () => {
73
+ mock.mockError(new Error('Resource not found: res://missing.tres'));
74
+ const ctx = createToolContext(mock);
75
+ await expect(getResourceInfo.execute({ resource_path: 'res://missing.tres' }, ctx)).rejects.toThrow('Resource not found');
76
+ });
77
+ });
78
+ describe('SpriteFrames response structure (from real Godot data)', () => {
79
+ it('returns correct structure at max_depth=1', async () => {
80
+ const fixture = loadFixture('resource-spriteframes');
81
+ mock.mockResponse(fixture);
82
+ const ctx = createToolContext(mock);
83
+ const result = await getResourceInfo.execute({ resource_path: 'res://player/player_sprites.tres' }, ctx);
84
+ const parsed = JSON.parse(result);
85
+ expect(parsed.resource_type).toBe('SpriteFrames');
86
+ expect(parsed.type_specific).toBeDefined();
87
+ expect(parsed.type_specific.animations).toBeInstanceOf(Array);
88
+ expect(parsed.type_specific.animations.length).toBe(5);
89
+ });
90
+ it('includes frame details with AtlasTexture regions at depth 1', async () => {
91
+ const fixture = loadFixture('resource-spriteframes');
92
+ mock.mockResponse(fixture);
93
+ const ctx = createToolContext(mock);
94
+ const result = await getResourceInfo.execute({ resource_path: 'res://player/player_sprites.tres' }, ctx);
95
+ const parsed = JSON.parse(result);
96
+ const runAnim = parsed.type_specific.animations.find((a) => a.name === 'run');
97
+ expect(runAnim).toBeDefined();
98
+ expect(runAnim.frame_count).toBe(8);
99
+ expect(runAnim.fps).toBe(12);
100
+ expect(runAnim.loop).toBe(true);
101
+ expect(runAnim.frames).toHaveLength(8);
102
+ const firstFrame = runAnim.frames[0];
103
+ expect(firstFrame.texture_type).toBe('AtlasTexture');
104
+ expect(firstFrame.atlas_source).toBe('res://sprites/player/hero.png');
105
+ expect(firstFrame.region).toEqual({ x: 26, y: 314, width: 44, height: 46 });
106
+ });
107
+ it('omits frame details at max_depth=0', async () => {
108
+ const fixture = loadFixture('resource-spriteframes-depth0');
109
+ mock.mockResponse(fixture);
110
+ const ctx = createToolContext(mock);
111
+ const result = await getResourceInfo.execute({ resource_path: 'res://player/player_sprites.tres', max_depth: 0 }, ctx);
112
+ const parsed = JSON.parse(result);
113
+ const idleAnim = parsed.type_specific.animations.find((a) => a.name === 'idle');
114
+ expect(idleAnim).toBeDefined();
115
+ expect(idleAnim.name).toBe('idle');
116
+ expect(idleAnim.frame_count).toBe(1);
117
+ expect(idleAnim.fps).toBe(10);
118
+ expect(idleAnim.loop).toBe(true);
119
+ expect(idleAnim.frames).toBeUndefined();
120
+ });
121
+ it('correctly identifies non-looping animations', async () => {
122
+ const fixture = loadFixture('resource-spriteframes');
123
+ mock.mockResponse(fixture);
124
+ const ctx = createToolContext(mock);
125
+ const result = await getResourceInfo.execute({ resource_path: 'res://player/player_sprites.tres' }, ctx);
126
+ const parsed = JSON.parse(result);
127
+ const damageAnim = parsed.type_specific.animations.find((a) => a.name === 'damage');
128
+ expect(damageAnim.loop).toBe(false);
129
+ });
130
+ });
131
+ describe('Texture2D response structure (from real Godot data)', () => {
132
+ it('returns dimensions and type for CompressedTexture2D', async () => {
133
+ const fixture = loadFixture('resource-texture');
134
+ mock.mockResponse(fixture);
135
+ const ctx = createToolContext(mock);
136
+ const result = await getResourceInfo.execute({ resource_path: 'res://sprites/player/hero.png' }, ctx);
137
+ const parsed = JSON.parse(result);
138
+ expect(parsed.resource_type).toBe('CompressedTexture2D');
139
+ expect(parsed.type_specific.width).toBe(1026);
140
+ expect(parsed.type_specific.height).toBe(1280);
141
+ expect(parsed.type_specific.texture_type).toBe('CompressedTexture2D');
142
+ expect(parsed.type_specific.load_path).toContain('.godot/imported/');
143
+ });
144
+ });
145
+ });
146
+ //# sourceMappingURL=resource.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resource.test.js","sourceRoot":"","sources":["../../../src/__tests__/tools/resource.test.ts"],"names":[],"mappings":"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"}
@@ -7,4 +7,5 @@ export { projectTools } from './project.js';
7
7
  export { screenshotTools } from './screenshot.js';
8
8
  export { animationTools } from './animation.js';
9
9
  export { tilemapTools } from './tilemap.js';
10
+ export { resourceTools } from './resource.js';
10
11
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAUA,wBAAgB,gBAAgB,IAAI,IAAI,CASvC;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAWA,wBAAgB,gBAAgB,IAAI,IAAI,CAUvC;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}
@@ -7,6 +7,7 @@ import { projectTools } from './project.js';
7
7
  import { screenshotTools } from './screenshot.js';
8
8
  import { animationTools } from './animation.js';
9
9
  import { tilemapTools } from './tilemap.js';
10
+ import { resourceTools } from './resource.js';
10
11
  export function registerAllTools() {
11
12
  registry.registerTools(sceneTools);
12
13
  registry.registerTools(nodeTools);
@@ -16,6 +17,7 @@ export function registerAllTools() {
16
17
  registry.registerTools(screenshotTools);
17
18
  registry.registerTools(animationTools);
18
19
  registry.registerTools(tilemapTools);
20
+ registry.registerTools(resourceTools);
19
21
  }
20
22
  export { sceneTools } from './scene.js';
21
23
  export { nodeTools } from './node.js';
@@ -25,4 +27,5 @@ export { projectTools } from './project.js';
25
27
  export { screenshotTools } from './screenshot.js';
26
28
  export { animationTools } from './animation.js';
27
29
  export { tilemapTools } from './tilemap.js';
30
+ export { resourceTools } from './resource.js';
28
31
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,UAAU,gBAAgB;IAC9B,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IACnC,QAAQ,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;IACpC,QAAQ,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;IACpC,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;IACxC,QAAQ,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;IACvC,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;AACvC,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,UAAU,gBAAgB;IAC9B,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IACnC,QAAQ,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;IACpC,QAAQ,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;IACpC,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;IACxC,QAAQ,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;IACvC,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;AACxC,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}
@@ -0,0 +1,17 @@
1
+ import { z } from 'zod';
2
+ import type { AnyToolDefinition } from '../core/types.js';
3
+ export declare const getResourceInfo: import("../core/types.js").ToolDefinition<z.ZodObject<{
4
+ resource_path: z.ZodString;
5
+ max_depth: z.ZodOptional<z.ZodNumber>;
6
+ include_internal: z.ZodOptional<z.ZodBoolean>;
7
+ }, "strip", z.ZodTypeAny, {
8
+ resource_path: string;
9
+ max_depth?: number | undefined;
10
+ include_internal?: boolean | undefined;
11
+ }, {
12
+ resource_path: string;
13
+ max_depth?: number | undefined;
14
+ include_internal?: boolean | undefined;
15
+ }>>;
16
+ export declare const resourceTools: AnyToolDefinition[];
17
+ //# sourceMappingURL=resource.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/tools/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAS1D,eAAO,MAAM,eAAe;;;;;;;;;;;;GA8B1B,CAAC;AAEH,eAAO,MAAM,aAAa,EAAwB,iBAAiB,EAAE,CAAC"}
@@ -0,0 +1,29 @@
1
+ import { z } from 'zod';
2
+ import { defineTool } from '../core/define-tool.js';
3
+ export const getResourceInfo = defineTool({
4
+ name: 'get_resource_info',
5
+ description: 'Load and inspect any Godot Resource by path. Returns type-specific structured data for SpriteFrames, TileSet, Material, Texture2D, etc. Falls back to generic property inspection for unknown types.',
6
+ schema: z.object({
7
+ resource_path: z
8
+ .string()
9
+ .describe('Resource path (e.g., "res://player/sprites.tres")'),
10
+ max_depth: z
11
+ .number()
12
+ .optional()
13
+ .describe('Detail level: 0 = summary only, 1 = full detail (default), 2+ = expand sub-resources'),
14
+ include_internal: z
15
+ .boolean()
16
+ .optional()
17
+ .describe('Include internal properties starting with underscore (default: false)'),
18
+ }),
19
+ async execute({ resource_path, max_depth, include_internal }, { godot }) {
20
+ const result = await godot.sendCommand('get_resource_info', {
21
+ resource_path,
22
+ max_depth: max_depth ?? 1,
23
+ include_internal: include_internal ?? false,
24
+ });
25
+ return JSON.stringify(result, null, 2);
26
+ },
27
+ });
28
+ export const resourceTools = [getResourceInfo];
29
+ //# sourceMappingURL=resource.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resource.js","sourceRoot":"","sources":["../../src/tools/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAUpD,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC;IACxC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,sMAAsM;IACxM,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,aAAa,EAAE,CAAC;aACb,MAAM,EAAE;aACR,QAAQ,CAAC,mDAAmD,CAAC;QAChE,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,sFAAsF,CACvF;QACH,gBAAgB,EAAE,CAAC;aAChB,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,uEAAuE,CAAC;KACrF,CAAC;IACF,KAAK,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,EAAE,EAAE,KAAK,EAAE;QACrE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,WAAW,CACpC,mBAAmB,EACnB;YACE,aAAa;YACb,SAAS,EAAE,SAAS,IAAI,CAAC;YACzB,gBAAgB,EAAE,gBAAgB,IAAI,KAAK;SAC5C,CACF,CAAC;QACF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,eAAe,CAAwB,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@satelliteoflove/godot-mcp",
3
- "version": "1.1.1",
3
+ "version": "1.2.0",
4
4
  "description": "MCP server for Godot Engine integration",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",