@adhisang/minecraft-modding-mcp 4.2.1 → 5.0.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 (114) hide show
  1. package/CHANGELOG.md +33 -0
  2. package/README.md +5 -4
  3. package/dist/access-transformer-parser.d.ts +2 -1
  4. package/dist/access-transformer-parser.js +10 -1
  5. package/dist/build-suggested-call.js +31 -10
  6. package/dist/cache-registry.d.ts +8 -0
  7. package/dist/cache-registry.js +15 -1
  8. package/dist/config.d.ts +1 -0
  9. package/dist/config.js +4 -0
  10. package/dist/entry-tools/analyze-mod-service.d.ts +24 -24
  11. package/dist/entry-tools/analyze-symbol-service.d.ts +57 -22
  12. package/dist/entry-tools/analyze-symbol-service.js +124 -28
  13. package/dist/entry-tools/batch-class-members-service.d.ts +3 -1
  14. package/dist/entry-tools/batch-class-members-service.js +6 -6
  15. package/dist/entry-tools/batch-class-source-service.d.ts +3 -1
  16. package/dist/entry-tools/batch-class-source-service.js +5 -6
  17. package/dist/entry-tools/batch-mappings-service.d.ts +3 -1
  18. package/dist/entry-tools/batch-mappings-service.js +4 -5
  19. package/dist/entry-tools/batch-symbol-exists-service.d.ts +3 -1
  20. package/dist/entry-tools/batch-symbol-exists-service.js +4 -5
  21. package/dist/entry-tools/compare-minecraft-service.d.ts +10 -10
  22. package/dist/entry-tools/entry-tool-schema.d.ts +1 -1
  23. package/dist/entry-tools/inspect-minecraft/handlers/artifact.js +1 -3
  24. package/dist/entry-tools/inspect-minecraft/handlers/class-members.js +2 -2
  25. package/dist/entry-tools/inspect-minecraft/handlers/class-overview.js +0 -5
  26. package/dist/entry-tools/inspect-minecraft/handlers/class-source.js +0 -1
  27. package/dist/entry-tools/inspect-minecraft/handlers/file.js +0 -1
  28. package/dist/entry-tools/inspect-minecraft/handlers/list-files.js +0 -1
  29. package/dist/entry-tools/inspect-minecraft/handlers/search.d.ts +8 -0
  30. package/dist/entry-tools/inspect-minecraft/handlers/search.js +13 -2
  31. package/dist/entry-tools/inspect-minecraft/handlers/versions.d.ts +1 -1
  32. package/dist/entry-tools/inspect-minecraft/handlers/versions.js +1 -1
  33. package/dist/entry-tools/inspect-minecraft/internal.d.ts +90 -89
  34. package/dist/entry-tools/inspect-minecraft/internal.js +30 -14
  35. package/dist/entry-tools/inspect-minecraft-service.d.ts +218 -218
  36. package/dist/entry-tools/inspect-minecraft-service.js +1 -1
  37. package/dist/entry-tools/manage-cache-service.d.ts +4 -4
  38. package/dist/entry-tools/response-contract.d.ts +1 -1
  39. package/dist/entry-tools/response-contract.js +1 -0
  40. package/dist/entry-tools/validate-project/cases/mixin.js +2 -1
  41. package/dist/entry-tools/validate-project/cases/project-summary.js +5 -3
  42. package/dist/entry-tools/validate-project-service.d.ts +42 -36
  43. package/dist/entry-tools/validate-project-service.js +3 -1
  44. package/dist/entry-tools/verify-mixin-target-service.d.ts +30 -0
  45. package/dist/entry-tools/verify-mixin-target-service.js +113 -22
  46. package/dist/error-mapping.d.ts +51 -0
  47. package/dist/error-mapping.js +157 -2
  48. package/dist/index.js +138 -71
  49. package/dist/mapping/internal-types.d.ts +7 -0
  50. package/dist/mapping/lookup.d.ts +1 -1
  51. package/dist/mapping/lookup.js +7 -1
  52. package/dist/mapping/types.d.ts +6 -0
  53. package/dist/mapping-service.d.ts +26 -2
  54. package/dist/mapping-service.js +178 -36
  55. package/dist/mcp-helpers.d.ts +1 -0
  56. package/dist/mcp-helpers.js +25 -3
  57. package/dist/minecraft-explorer-service.js +24 -11
  58. package/dist/mixin/access-validators.js +33 -1
  59. package/dist/mixin/annotation-validators.js +53 -7
  60. package/dist/mixin/parsed-validator.js +2 -2
  61. package/dist/mixin-parser.js +48 -4
  62. package/dist/mod-decompile-service.js +2 -1
  63. package/dist/mod-remap-service.d.ts +20 -1
  64. package/dist/mod-remap-service.js +95 -40
  65. package/dist/nbt/java-nbt-codec.js +6 -0
  66. package/dist/observability.d.ts +6 -0
  67. package/dist/observability.js +10 -0
  68. package/dist/page-cursor.d.ts +17 -0
  69. package/dist/page-cursor.js +0 -0
  70. package/dist/registry-service.js +25 -1
  71. package/dist/resources.js +45 -9
  72. package/dist/response-utils.d.ts +29 -4
  73. package/dist/response-utils.js +95 -5
  74. package/dist/source/access-validate.js +12 -2
  75. package/dist/source/artifact-resolver.js +1 -1
  76. package/dist/source/class-source/members-builder.d.ts +44 -1
  77. package/dist/source/class-source/members-builder.js +51 -4
  78. package/dist/source/class-source/snippet-builder.d.ts +13 -0
  79. package/dist/source/class-source/snippet-builder.js +48 -4
  80. package/dist/source/class-source-helpers.js +67 -11
  81. package/dist/source/class-source.js +97 -20
  82. package/dist/source/indexer.js +5 -2
  83. package/dist/source/search.d.ts +1 -1
  84. package/dist/source/search.js +94 -22
  85. package/dist/source/validate-mixin.d.ts +2 -1
  86. package/dist/source/validate-mixin.js +45 -4
  87. package/dist/source/workspace-target.js +15 -9
  88. package/dist/source-jar-reader.d.ts +54 -1
  89. package/dist/source-jar-reader.js +121 -10
  90. package/dist/source-service.d.ts +28 -7
  91. package/dist/storage/files-repo.d.ts +12 -0
  92. package/dist/storage/files-repo.js +24 -0
  93. package/dist/storage/symbols-repo.d.ts +6 -0
  94. package/dist/storage/symbols-repo.js +6 -0
  95. package/dist/symbols/symbol-extractor.js +35 -6
  96. package/dist/text-truncate.d.ts +7 -0
  97. package/dist/text-truncate.js +21 -0
  98. package/dist/tiny-remapper-resolver.js +10 -0
  99. package/dist/tool-contract-manifest.js +2 -2
  100. package/dist/tool-execution-gate.js +12 -1
  101. package/dist/tool-guidance.d.ts +4 -1
  102. package/dist/tool-guidance.js +37 -12
  103. package/dist/tool-schemas.d.ts +559 -494
  104. package/dist/tool-schemas.js +99 -63
  105. package/dist/types.d.ts +1 -0
  106. package/dist/version-diff-service.js +5 -0
  107. package/dist/version-service.d.ts +3 -0
  108. package/dist/version-service.js +18 -2
  109. package/dist/warning-details.d.ts +18 -0
  110. package/dist/warning-details.js +63 -0
  111. package/docs/README-ja.md +2 -2
  112. package/docs/examples.md +26 -2
  113. package/docs/tool-reference.md +22 -17
  114. package/package.json +1 -1
@@ -14,7 +14,6 @@ export async function handleClassOverview(deps, subject, detail, include) {
14
14
  headline: `Could not resolve artifact context for ${className}.`,
15
15
  subject: createSummarySubject({
16
16
  task: "class-overview",
17
- requested: subject,
18
17
  className
19
18
  })
20
19
  };
@@ -64,7 +63,6 @@ export async function handleClassOverview(deps, subject, detail, include) {
64
63
  headline: `Resolved class overview for ${partialSourceFallback.className}.`,
65
64
  subject: createSummarySubject({
66
65
  task: "class-overview",
67
- requested: subject,
68
66
  className: partialSourceFallback.className,
69
67
  artifactId: metadata.artifactId
70
68
  }),
@@ -110,7 +108,6 @@ export async function handleClassOverview(deps, subject, detail, include) {
110
108
  headline: `No class match was found for ${className}.`,
111
109
  subject: createSummarySubject({
112
110
  task: "class-overview",
113
- requested: subject,
114
111
  className,
115
112
  artifactId: artifact.artifactId
116
113
  })
@@ -152,7 +149,6 @@ export async function handleClassOverview(deps, subject, detail, include) {
152
149
  headline: `Found ${matches.total} class matches for ${className}.`,
153
150
  subject: createSummarySubject({
154
151
  task: "class-overview",
155
- requested: subject,
156
152
  className,
157
153
  artifactId: artifact.artifactId
158
154
  }),
@@ -192,7 +188,6 @@ export async function handleClassOverview(deps, subject, detail, include) {
192
188
  headline: `Resolved class overview for ${match.qualifiedName}.`,
193
189
  subject: createSummarySubject({
194
190
  task: "class-overview",
195
- requested: subject,
196
191
  className: match.qualifiedName,
197
192
  artifactId: artifact.artifactId
198
193
  }),
@@ -23,7 +23,6 @@ export async function handleClassSource(deps, subject, detail, include) {
23
23
  headline: `Resolved source for ${source.className}.`,
24
24
  subject: createSummarySubject({
25
25
  task: "class-source",
26
- requested: subject,
27
26
  className: source.className,
28
27
  artifactId: source.artifactId
29
28
  }),
@@ -17,7 +17,6 @@ export async function handleFile(deps, subject, detail, include) {
17
17
  headline: `Read ${file.filePath}.`,
18
18
  subject: createSummarySubject({
19
19
  task: "file",
20
- requested: subject,
21
20
  filePath: file.filePath,
22
21
  artifactId: artifact.artifactId
23
22
  }),
@@ -52,7 +52,6 @@ export async function handleListFiles(deps, subject, detail, include, limit, cur
52
52
  headline: `Listed ${files.items.length} files for ${artifact.artifactId}.`,
53
53
  subject: createSummarySubject({
54
54
  task: "list-files",
55
- requested: subject,
56
55
  artifactId: artifact.artifactId
57
56
  }),
58
57
  counts: {
@@ -2,4 +2,12 @@ import { type DetailLevel } from "../../response-contract.js";
2
2
  import { type Subject, type InspectMinecraftDeps } from "../internal.js";
3
3
  export declare function handleSearch(deps: InspectMinecraftDeps, subject: Subject, detail: DetailLevel, include: string[], limit: number | undefined, cursor: string | undefined): Promise<{
4
4
  warnings: string[];
5
+ meta: {
6
+ pagination: {
7
+ cursorIgnored?: boolean | undefined;
8
+ nextCursor?: string | undefined;
9
+ returnedCount: number;
10
+ hasMore: boolean;
11
+ };
12
+ };
5
13
  }>;
@@ -82,7 +82,6 @@ export async function handleSearch(deps, subject, detail, include, limit, cursor
82
82
  : `No source hits were found for ${searchSubject.query}.`,
83
83
  subject: createSummarySubject({
84
84
  task: "search",
85
- requested: requestedSubject,
86
85
  query: searchSubject.query,
87
86
  artifactId: artifact.artifactId
88
87
  }),
@@ -129,6 +128,7 @@ export async function handleSearch(deps, subject, detail, include, limit, cursor
129
128
  }
130
129
  : {})
131
130
  };
131
+ const returnedCount = (detail === "summary" ? sampledHits.items : effectiveHits).length;
132
132
  return {
133
133
  ...buildEntryToolResult({
134
134
  task: "search",
@@ -150,7 +150,18 @@ export async function handleSearch(deps, subject, detail, include, limit, cursor
150
150
  },
151
151
  alwaysBlocks: ["subject"]
152
152
  }),
153
- warnings: [...artifact.warnings, ...(binaryBackedClassHit?.warnings ?? [])]
153
+ warnings: [...artifact.warnings, ...(binaryBackedClassHit?.warnings ?? [])],
154
+ // Always surface continuation state in meta, even in summary mode where the
155
+ // search block (and its nextCursor) is omitted, so callers never stop early
156
+ // believing they have all results.
157
+ meta: {
158
+ pagination: {
159
+ returnedCount,
160
+ hasMore: search.nextCursor != null,
161
+ ...(search.nextCursor != null ? { nextCursor: search.nextCursor } : {}),
162
+ ...(search.cursorIgnored ? { cursorIgnored: true } : {})
163
+ }
164
+ }
154
165
  };
155
166
  }
156
167
  //# sourceMappingURL=search.js.map
@@ -2,5 +2,5 @@ import { type DetailLevel } from "../../response-contract.js";
2
2
  import { type InspectMinecraftDeps } from "../internal.js";
3
3
  import { type InspectMinecraftInput } from "../../inspect-minecraft-service.js";
4
4
  export declare function handleVersions(deps: InspectMinecraftDeps, input: InspectMinecraftInput, detail: DetailLevel, include: string[]): Promise<{
5
- warnings: never[];
5
+ warnings: string[];
6
6
  }>;
@@ -43,7 +43,7 @@ export async function handleVersions(deps, input, detail, include) {
43
43
  }
44
44
  }
45
45
  }),
46
- warnings: []
46
+ warnings: versions.warnings ?? []
47
47
  };
48
48
  }
49
49
  //# sourceMappingURL=versions.js.map