@adhisang/minecraft-modding-mcp 6.2.0 → 7.0.0-rc.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.
Files changed (98) hide show
  1. package/CHANGELOG.md +71 -0
  2. package/README.md +21 -5
  3. package/dist/cache-policy.d.ts +71 -0
  4. package/dist/cache-policy.js +83 -0
  5. package/dist/cache-registry.js +6 -6
  6. package/dist/cli.js +74 -3
  7. package/dist/compat-stdio-transport.d.ts +1 -1
  8. package/dist/compat-stdio-transport.js +13 -1
  9. package/dist/config.d.ts +3 -0
  10. package/dist/config.js +8 -2
  11. package/dist/decompiler/vineflower.d.ts +1 -0
  12. package/dist/decompiler/vineflower.js +8 -5
  13. package/dist/entry-tools/analyze-mod-service.d.ts +70 -136
  14. package/dist/entry-tools/analyze-symbol-service.d.ts +112 -150
  15. package/dist/entry-tools/compare-minecraft-service.d.ts +59 -145
  16. package/dist/entry-tools/entry-tool-schema.d.ts +38 -4
  17. package/dist/entry-tools/entry-tool-schema.js +4 -1
  18. package/dist/entry-tools/inspect-minecraft/internal.d.ts +235 -799
  19. package/dist/entry-tools/inspect-minecraft/internal.js +65 -28
  20. package/dist/entry-tools/inspect-minecraft-service.d.ts +372 -1736
  21. package/dist/entry-tools/inspect-minecraft-service.js +1 -1
  22. package/dist/entry-tools/manage-cache-service.d.ts +81 -91
  23. package/dist/entry-tools/validate-project/cases/project-summary.d.ts +7 -7
  24. package/dist/entry-tools/validate-project-service.d.ts +164 -592
  25. package/dist/entry-tools/verify-mixin-target-service.d.ts +3 -19
  26. package/dist/era-classifier.d.ts +161 -0
  27. package/dist/era-classifier.js +292 -0
  28. package/dist/error-mapping.js +9 -2
  29. package/dist/index.d.ts +42 -4
  30. package/dist/index.js +637 -475
  31. package/dist/java-process.d.ts +2 -0
  32. package/dist/java-process.js +22 -2
  33. package/dist/json-rpc-framing.d.ts +77 -1
  34. package/dist/json-rpc-framing.js +249 -13
  35. package/dist/mapping/loaders/tiny-loom-selection.d.ts +88 -0
  36. package/dist/mapping/loaders/tiny-loom-selection.js +223 -0
  37. package/dist/mapping/loaders/tiny-loom.js +45 -33
  38. package/dist/mapping/loaders/tiny-maven.js +6 -11
  39. package/dist/mapping/parsers/tiny.d.ts +57 -0
  40. package/dist/mapping/parsers/tiny.js +99 -22
  41. package/dist/mapping-service.d.ts +19 -0
  42. package/dist/mapping-service.js +93 -9
  43. package/dist/mcp-helpers.d.ts +19 -2
  44. package/dist/mcp-helpers.js +48 -6
  45. package/dist/minecraft-explorer-service.d.ts +1 -1
  46. package/dist/mixin/types.d.ts +8 -0
  47. package/dist/mod-analyzer.js +7 -7
  48. package/dist/mod-decompile-service.js +1 -0
  49. package/dist/nbt/java-nbt-codec.js +12 -2
  50. package/dist/nbt/json-patch.js +14 -3
  51. package/dist/nbt/pipeline.js +40 -3
  52. package/dist/nbt/typed-json.js +26 -1
  53. package/dist/registration-adapter.d.ts +32 -0
  54. package/dist/registration-adapter.js +52 -0
  55. package/dist/request-context.d.ts +7 -0
  56. package/dist/request-context.js +9 -0
  57. package/dist/resources.d.ts +1 -1
  58. package/dist/resources.js +25 -19
  59. package/dist/server-identity.d.ts +27 -0
  60. package/dist/server-identity.js +26 -0
  61. package/dist/source/access-validate.js +53 -0
  62. package/dist/source/artifact-resolver.d.ts +69 -1
  63. package/dist/source/artifact-resolver.js +215 -14
  64. package/dist/source/class-source.d.ts +22 -0
  65. package/dist/source/class-source.js +162 -29
  66. package/dist/source/did-you-mean.d.ts +12 -1
  67. package/dist/source/did-you-mean.js +6 -2
  68. package/dist/source/file-access.js +150 -46
  69. package/dist/source/indexer.js +1 -0
  70. package/dist/source/nested-jars.d.ts +19 -0
  71. package/dist/source/nested-jars.js +90 -21
  72. package/dist/source/shared-utils.d.ts +21 -0
  73. package/dist/source/shared-utils.js +23 -0
  74. package/dist/source-service.d.ts +12 -0
  75. package/dist/source-service.js +3 -0
  76. package/dist/stdio-supervisor.d.ts +357 -2
  77. package/dist/stdio-supervisor.js +1031 -80
  78. package/dist/storage/db.d.ts +2 -1
  79. package/dist/storage/db.js +15 -8
  80. package/dist/synthetic-decorator.d.ts +24 -0
  81. package/dist/synthetic-decorator.js +48 -0
  82. package/dist/tool-contract-manifest.js +1 -1
  83. package/dist/tool-guidance.d.ts +17 -1
  84. package/dist/tool-guidance.js +417 -13
  85. package/dist/tool-schema-registry.d.ts +2 -0
  86. package/dist/tool-schema-registry.js +4 -0
  87. package/dist/tool-schemas.d.ts +2214 -3915
  88. package/dist/tool-schemas.js +34 -7
  89. package/dist/types.d.ts +35 -0
  90. package/dist/v1-parity-schemas.d.ts +7 -0
  91. package/dist/v1-parity-schemas.js +5584 -0
  92. package/dist/version-diff-service.d.ts +33 -0
  93. package/dist/version-diff-service.js +148 -3
  94. package/dist/version-service.js +36 -14
  95. package/dist/warning-details.js +18 -1
  96. package/docs/README-ja.md +9 -3
  97. package/docs/tool-reference.md +267 -22
  98. package/package.json +12 -9
@@ -3,187 +3,101 @@ import type { DiffClassSignaturesOutput } from "../source-service.js";
3
3
  import type { CompareVersionsOutput } from "../version-diff-service.js";
4
4
  import type { GetRegistryDataOutput } from "../registry-service.js";
5
5
  export declare const compareMinecraftShape: {
6
- task: z.ZodOptional<z.ZodEnum<["auto", "versions", "class-diff", "registry-diff", "migration-overview"]>>;
7
- subject: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
6
+ task: z.ZodOptional<z.ZodEnum<{
7
+ auto: "auto";
8
+ versions: "versions";
9
+ "class-diff": "class-diff";
10
+ "registry-diff": "registry-diff";
11
+ "migration-overview": "migration-overview";
12
+ }>>;
13
+ subject: z.ZodDiscriminatedUnion<[z.ZodObject<{
8
14
  kind: z.ZodLiteral<"version-pair">;
9
15
  fromVersion: z.ZodString;
10
16
  toVersion: z.ZodString;
11
17
  packageFilter: z.ZodOptional<z.ZodString>;
12
- }, "strip", z.ZodTypeAny, {
13
- kind: "version-pair";
14
- fromVersion: string;
15
- toVersion: string;
16
- packageFilter?: string | undefined;
17
- }, {
18
- kind: "version-pair";
19
- fromVersion: string;
20
- toVersion: string;
21
- packageFilter?: string | undefined;
22
- }>, z.ZodObject<{
18
+ }, z.core.$strip>, z.ZodObject<{
23
19
  kind: z.ZodLiteral<"class">;
24
20
  className: z.ZodString;
25
21
  fromVersion: z.ZodString;
26
22
  toVersion: z.ZodString;
27
- mapping: z.ZodOptional<z.ZodEnum<["obfuscated", "mojang", "intermediary", "yarn"]>>;
28
- sourcePriority: z.ZodOptional<z.ZodEnum<["loom-first", "maven-first"]>>;
23
+ mapping: z.ZodOptional<z.ZodEnum<{
24
+ obfuscated: "obfuscated";
25
+ mojang: "mojang";
26
+ intermediary: "intermediary";
27
+ yarn: "yarn";
28
+ }>>;
29
+ sourcePriority: z.ZodOptional<z.ZodEnum<{
30
+ "loom-first": "loom-first";
31
+ "maven-first": "maven-first";
32
+ }>>;
29
33
  gradleUserHome: z.ZodOptional<z.ZodString>;
30
- }, "strip", z.ZodTypeAny, {
31
- kind: "class";
32
- className: string;
33
- fromVersion: string;
34
- toVersion: string;
35
- mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
36
- sourcePriority?: "loom-first" | "maven-first" | undefined;
37
- gradleUserHome?: string | undefined;
38
- }, {
39
- kind: "class";
40
- className: string;
41
- fromVersion: string;
42
- toVersion: string;
43
- mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
44
- sourcePriority?: "loom-first" | "maven-first" | undefined;
45
- gradleUserHome?: string | undefined;
46
- }>, z.ZodObject<{
34
+ }, z.core.$strip>, z.ZodObject<{
47
35
  kind: z.ZodLiteral<"registry">;
48
36
  fromVersion: z.ZodString;
49
37
  toVersion: z.ZodString;
50
38
  registry: z.ZodOptional<z.ZodString>;
51
- }, "strip", z.ZodTypeAny, {
52
- kind: "registry";
53
- fromVersion: string;
54
- toVersion: string;
55
- registry?: string | undefined;
56
- }, {
57
- kind: "registry";
58
- fromVersion: string;
59
- toVersion: string;
60
- registry?: string | undefined;
61
- }>]>;
62
- detail: z.ZodOptional<z.ZodEnum<["summary", "standard", "full"]>>;
63
- include: z.ZodOptional<z.ZodArray<z.ZodEnum<[string, ...string[]]>, "many">>;
39
+ }, z.core.$strip>], "kind">;
40
+ detail: z.ZodOptional<z.ZodEnum<{
41
+ summary: "summary";
42
+ standard: "standard";
43
+ full: "full";
44
+ }>>;
45
+ include: z.ZodOptional<z.ZodArray<z.ZodEnum<{
46
+ [x: string]: string;
47
+ }>>>;
64
48
  limit: z.ZodOptional<z.ZodNumber>;
65
49
  maxClassResults: z.ZodDefault<z.ZodNumber>;
66
50
  maxEntriesPerRegistry: z.ZodOptional<z.ZodNumber>;
67
51
  includeFullDiff: z.ZodDefault<z.ZodBoolean>;
68
52
  };
69
53
  export declare const compareMinecraftSchema: z.ZodObject<{
70
- task: z.ZodOptional<z.ZodEnum<["auto", "versions", "class-diff", "registry-diff", "migration-overview"]>>;
71
- subject: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
54
+ task: z.ZodOptional<z.ZodEnum<{
55
+ auto: "auto";
56
+ versions: "versions";
57
+ "class-diff": "class-diff";
58
+ "registry-diff": "registry-diff";
59
+ "migration-overview": "migration-overview";
60
+ }>>;
61
+ subject: z.ZodDiscriminatedUnion<[z.ZodObject<{
72
62
  kind: z.ZodLiteral<"version-pair">;
73
63
  fromVersion: z.ZodString;
74
64
  toVersion: z.ZodString;
75
65
  packageFilter: z.ZodOptional<z.ZodString>;
76
- }, "strip", z.ZodTypeAny, {
77
- kind: "version-pair";
78
- fromVersion: string;
79
- toVersion: string;
80
- packageFilter?: string | undefined;
81
- }, {
82
- kind: "version-pair";
83
- fromVersion: string;
84
- toVersion: string;
85
- packageFilter?: string | undefined;
86
- }>, z.ZodObject<{
66
+ }, z.core.$strip>, z.ZodObject<{
87
67
  kind: z.ZodLiteral<"class">;
88
68
  className: z.ZodString;
89
69
  fromVersion: z.ZodString;
90
70
  toVersion: z.ZodString;
91
- mapping: z.ZodOptional<z.ZodEnum<["obfuscated", "mojang", "intermediary", "yarn"]>>;
92
- sourcePriority: z.ZodOptional<z.ZodEnum<["loom-first", "maven-first"]>>;
71
+ mapping: z.ZodOptional<z.ZodEnum<{
72
+ obfuscated: "obfuscated";
73
+ mojang: "mojang";
74
+ intermediary: "intermediary";
75
+ yarn: "yarn";
76
+ }>>;
77
+ sourcePriority: z.ZodOptional<z.ZodEnum<{
78
+ "loom-first": "loom-first";
79
+ "maven-first": "maven-first";
80
+ }>>;
93
81
  gradleUserHome: z.ZodOptional<z.ZodString>;
94
- }, "strip", z.ZodTypeAny, {
95
- kind: "class";
96
- className: string;
97
- fromVersion: string;
98
- toVersion: string;
99
- mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
100
- sourcePriority?: "loom-first" | "maven-first" | undefined;
101
- gradleUserHome?: string | undefined;
102
- }, {
103
- kind: "class";
104
- className: string;
105
- fromVersion: string;
106
- toVersion: string;
107
- mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
108
- sourcePriority?: "loom-first" | "maven-first" | undefined;
109
- gradleUserHome?: string | undefined;
110
- }>, z.ZodObject<{
82
+ }, z.core.$strip>, z.ZodObject<{
111
83
  kind: z.ZodLiteral<"registry">;
112
84
  fromVersion: z.ZodString;
113
85
  toVersion: z.ZodString;
114
86
  registry: z.ZodOptional<z.ZodString>;
115
- }, "strip", z.ZodTypeAny, {
116
- kind: "registry";
117
- fromVersion: string;
118
- toVersion: string;
119
- registry?: string | undefined;
120
- }, {
121
- kind: "registry";
122
- fromVersion: string;
123
- toVersion: string;
124
- registry?: string | undefined;
125
- }>]>;
126
- detail: z.ZodOptional<z.ZodEnum<["summary", "standard", "full"]>>;
127
- include: z.ZodOptional<z.ZodArray<z.ZodEnum<[string, ...string[]]>, "many">>;
87
+ }, z.core.$strip>], "kind">;
88
+ detail: z.ZodOptional<z.ZodEnum<{
89
+ summary: "summary";
90
+ standard: "standard";
91
+ full: "full";
92
+ }>>;
93
+ include: z.ZodOptional<z.ZodArray<z.ZodEnum<{
94
+ [x: string]: string;
95
+ }>>>;
128
96
  limit: z.ZodOptional<z.ZodNumber>;
129
97
  maxClassResults: z.ZodDefault<z.ZodNumber>;
130
98
  maxEntriesPerRegistry: z.ZodOptional<z.ZodNumber>;
131
99
  includeFullDiff: z.ZodDefault<z.ZodBoolean>;
132
- }, "strip", z.ZodTypeAny, {
133
- subject: {
134
- kind: "version-pair";
135
- fromVersion: string;
136
- toVersion: string;
137
- packageFilter?: string | undefined;
138
- } | {
139
- kind: "class";
140
- className: string;
141
- fromVersion: string;
142
- toVersion: string;
143
- mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
144
- sourcePriority?: "loom-first" | "maven-first" | undefined;
145
- gradleUserHome?: string | undefined;
146
- } | {
147
- kind: "registry";
148
- fromVersion: string;
149
- toVersion: string;
150
- registry?: string | undefined;
151
- };
152
- maxClassResults: number;
153
- includeFullDiff: boolean;
154
- limit?: number | undefined;
155
- task?: "auto" | "versions" | "class-diff" | "registry-diff" | "migration-overview" | undefined;
156
- detail?: "summary" | "standard" | "full" | undefined;
157
- include?: string[] | undefined;
158
- maxEntriesPerRegistry?: number | undefined;
159
- }, {
160
- subject: {
161
- kind: "version-pair";
162
- fromVersion: string;
163
- toVersion: string;
164
- packageFilter?: string | undefined;
165
- } | {
166
- kind: "class";
167
- className: string;
168
- fromVersion: string;
169
- toVersion: string;
170
- mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
171
- sourcePriority?: "loom-first" | "maven-first" | undefined;
172
- gradleUserHome?: string | undefined;
173
- } | {
174
- kind: "registry";
175
- fromVersion: string;
176
- toVersion: string;
177
- registry?: string | undefined;
178
- };
179
- limit?: number | undefined;
180
- task?: "auto" | "versions" | "class-diff" | "registry-diff" | "migration-overview" | undefined;
181
- detail?: "summary" | "standard" | "full" | undefined;
182
- include?: string[] | undefined;
183
- maxClassResults?: number | undefined;
184
- maxEntriesPerRegistry?: number | undefined;
185
- includeFullDiff?: boolean | undefined;
186
- }>;
100
+ }, z.core.$strip>;
187
101
  export type CompareMinecraftInput = z.infer<typeof compareMinecraftSchema>;
188
102
  type CompareMinecraftDeps = {
189
103
  compareVersions: (input: {
@@ -1,6 +1,40 @@
1
1
  import { z } from "zod";
2
- export declare const detailSchema: z.ZodEnum<["summary", "standard", "full"]>;
3
- export declare const includeGroupSchema: z.ZodEnum<["warnings", "provenance", "candidates", "members", "descriptors", "source", "files", "samples", "diff", "issues", "timeline", "matrix", "entries", "workspace", "health", "recovery", "paths", "owners", "preview", "cacheEntries", "timings", "artifact", "classes", "registry"]>;
4
- export declare const executionModeSchema: z.ZodEnum<["preview", "apply"]>;
2
+ export declare const detailSchema: z.ZodEnum<{
3
+ summary: "summary";
4
+ standard: "standard";
5
+ full: "full";
6
+ }>;
7
+ export declare const includeGroupSchema: z.ZodEnum<{
8
+ entries: "entries";
9
+ workspace: "workspace";
10
+ candidates: "candidates";
11
+ source: "source";
12
+ warnings: "warnings";
13
+ registry: "registry";
14
+ preview: "preview";
15
+ members: "members";
16
+ files: "files";
17
+ samples: "samples";
18
+ timings: "timings";
19
+ matrix: "matrix";
20
+ provenance: "provenance";
21
+ descriptors: "descriptors";
22
+ diff: "diff";
23
+ issues: "issues";
24
+ timeline: "timeline";
25
+ health: "health";
26
+ recovery: "recovery";
27
+ paths: "paths";
28
+ owners: "owners";
29
+ cacheEntries: "cacheEntries";
30
+ artifact: "artifact";
31
+ classes: "classes";
32
+ }>;
33
+ export declare const executionModeSchema: z.ZodEnum<{
34
+ preview: "preview";
35
+ apply: "apply";
36
+ }>;
5
37
  export declare const positiveIntSchema: z.ZodNumber;
6
- export declare function buildIncludeSchema(allowed: readonly string[]): z.ZodOptional<z.ZodArray<z.ZodEnum<[string, ...string[]]>, "many">>;
38
+ export declare function buildIncludeSchema(allowed: readonly string[]): z.ZodOptional<z.ZodArray<z.ZodEnum<{
39
+ [x: string]: string;
40
+ }>>>;
@@ -1,9 +1,12 @@
1
1
  import { z } from "zod";
2
2
  import { CANONICAL_INCLUDE_GROUPS, DETAIL_LEVELS } from "./response-contract.js";
3
+ import { zod3ParityIntCheck } from "../tool-schemas.js";
3
4
  export const detailSchema = z.enum(DETAIL_LEVELS);
4
5
  export const includeGroupSchema = z.enum(CANONICAL_INCLUDE_GROUPS);
5
6
  export const executionModeSchema = z.enum(["preview", "apply"]);
6
- export const positiveIntSchema = z.number().int().positive();
7
+ // zod3-parity: same acceptance/error contract as tool-schemas' optionalPositiveInt
8
+ // (zod4's .int() rejects unsafe integers and reworded the float error).
9
+ export const positiveIntSchema = z.number().check(zod3ParityIntCheck).positive();
7
10
  export function buildIncludeSchema(allowed) {
8
11
  return z.array(z.enum(allowed)).optional();
9
12
  }