@adhisang/minecraft-modding-mcp 1.1.0 → 1.2.0

package/dist/storage/files-repo.js

@@ -1,4 +1,5 @@
 import { createHash } from "node:crypto";
+import { createError, ERROR_CODES } from "../errors.js";
 import { log } from "../logger.js";
 function buildCursor(sortKey) {
     return Buffer.from(JSON.stringify({ sortKey }), "utf8").toString("base64");
@@ -11,13 +12,26 @@ function parseCursor(cursor) {
         const decoded = Buffer.from(cursor, "base64").toString("utf8");
         const parsed = JSON.parse(decoded);
         if (typeof parsed.sortKey !== "string") {
-            return undefined;
+            throw createError({
+                code: ERROR_CODES.INVALID_INPUT,
+                message: "Invalid pagination cursor.",
+                details: {
+                    nextAction: "Omit the cursor parameter to start from the first page, or use a cursor value from a previous response."
+                }
+            });
         }
         return parsed;
     }
-    catch {
-        log("warn", "storage.files.invalid_list_cursor", { cursor });
-        return undefined;
+    catch (err) {
+        if (err instanceof Error && "code" in err)
+            throw err;
+        throw createError({
+            code: ERROR_CODES.INVALID_INPUT,
+            message: "Invalid pagination cursor.",
+            details: {
+                nextAction: "Omit the cursor parameter to start from the first page, or use a cursor value from a previous response."
+            }
+        });
     }
 }
 function buildSearchCursor(score, filePath) {
@@ -31,13 +45,26 @@ function parseSearchCursor(cursor) {
         const decoded = Buffer.from(cursor, "base64").toString("utf8");
         const parsed = JSON.parse(decoded);
         if (typeof parsed.score !== "number" || typeof parsed.filePath !== "string") {
-            return undefined;
+            throw createError({
+                code: ERROR_CODES.INVALID_INPUT,
+                message: "Invalid pagination cursor.",
+                details: {
+                    nextAction: "Omit the cursor parameter to start from the first page, or use a cursor value from a previous response."
+                }
+            });
         }
         return parsed;
     }
-    catch {
-        log("warn", "storage.files.invalid_search_cursor", { cursor });
-        return undefined;
+    catch (err) {
+        if (err instanceof Error && "code" in err)
+            throw err;
+        throw createError({
+            code: ERROR_CODES.INVALID_INPUT,
+            message: "Invalid pagination cursor.",
+            details: {
+                nextAction: "Omit the cursor parameter to start from the first page, or use a cursor value from a previous response."
+            }
+        });
     }
 }
 function nextCursorFromRows(rows) {

package/dist/types.d.ts

@@ -2,6 +2,7 @@ export type SourceOrigin = "local-jar" | "local-m2" | "remote-repo" | "decompile
 export type SourceMapping = "official" | "mojang" | "intermediary" | "yarn";
 export type MappingSourcePriority = "loom-first" | "maven-first";
 export type ArtifactTargetKind = "version" | "jar" | "coordinate";
+export type ArtifactScope = "vanilla" | "merged" | "loader";
 export interface SourceTargetInput {
     kind: ArtifactTargetKind;
     value: string;

package/dist/version-service.js

@@ -21,7 +21,11 @@ function ensureVersionDetail(value, version) {
         throw createError({
             code: ERROR_CODES.VERSION_NOT_FOUND,
             message: `Version metadata for "${version}" is invalid.`,
-            details: { version }
+            details: {
+                version,
+                nextAction: "Use list-versions to see available Minecraft versions.",
+                suggestedCall: { tool: "list-versions", params: {} }
+            }
         });
     }
     return value;
@@ -105,7 +109,11 @@ export class VersionService {
             throw createError({
                 code: ERROR_CODES.VERSION_NOT_FOUND,
                 message: `Minecraft version "${normalizedVersion}" was not found in version manifest.`,
-                details: { version: normalizedVersion }
+                details: {
+                    version: normalizedVersion,
+                    nextAction: "Use list-versions to see available Minecraft versions.",
+                    suggestedCall: { tool: "list-versions", params: {} }
+                }
             });
         }
         const details = await this.fetchVersionDetails(versionEntry.url, normalizedVersion);
@@ -133,7 +141,11 @@ export class VersionService {
             throw createError({
                 code: ERROR_CODES.VERSION_NOT_FOUND,
                 message: `Minecraft version "${normalizedVersion}" was not found in version manifest.`,
-                details: { version: normalizedVersion }
+                details: {
+                    version: normalizedVersion,
+                    nextAction: "Use list-versions to see available Minecraft versions.",
+                    suggestedCall: { tool: "list-versions", params: {} }
+                }
             });
         }
         const details = await this.fetchVersionDetails(versionEntry.url, normalizedVersion);
@@ -142,7 +154,11 @@ export class VersionService {
             throw createError({
                 code: ERROR_CODES.VERSION_NOT_FOUND,
                 message: `Minecraft version "${normalizedVersion}" does not expose a server download URL.`,
-                details: { version: normalizedVersion }
+                details: {
+                    version: normalizedVersion,
+                    nextAction: "Use list-versions to see available Minecraft versions.",
+                    suggestedCall: { tool: "list-versions", params: {} }
+                }
             });
         }
         const destinationPath = defaultDownloadPath(this.config.cacheDir, serverJarUrl);
@@ -230,7 +246,11 @@ export class VersionService {
             throw createError({
                 code: ERROR_CODES.VERSION_NOT_FOUND,
                 message: `Minecraft version "${normalizedVersion}" was not found in version manifest.`,
-                details: { version: normalizedVersion }
+                details: {
+                    version: normalizedVersion,
+                    nextAction: "Use list-versions to see available Minecraft versions.",
+                    suggestedCall: { tool: "list-versions", params: {} }
+                }
             });
         }
         const details = await this.fetchVersionDetails(versionEntry.url, normalizedVersion);
@@ -239,7 +259,11 @@ export class VersionService {
             throw createError({
                 code: ERROR_CODES.VERSION_NOT_FOUND,
                 message: `Minecraft version "${normalizedVersion}" does not expose a client download URL.`,
-                details: { version: normalizedVersion }
+                details: {
+                    version: normalizedVersion,
+                    nextAction: "Use list-versions to see available Minecraft versions.",
+                    suggestedCall: { tool: "list-versions", params: {} }
+                }
             });
         }
         const destinationPath = defaultDownloadPath(this.config.cacheDir, clientJarUrl);

package/dist/workspace-mapping-service.d.ts

@@ -15,4 +15,5 @@ export type WorkspaceCompileMappingOutput = {
 };
 export declare class WorkspaceMappingService {
     detectCompileMapping(input: WorkspaceCompileMappingInput): Promise<WorkspaceCompileMappingOutput>;
+    detectProjectMinecraftVersion(projectPath: string): Promise<string | undefined>;
 }

package/dist/workspace-mapping-service.js

@@ -85,5 +85,29 @@ export class WorkspaceMappingService {
             warnings: []
         };
     }
+    async detectProjectMinecraftVersion(projectPath) {
+        const root = resolve(projectPath);
+        const propsPath = resolve(root, "gradle.properties");
+        let content;
+        try {
+            content = await readFile(propsPath, "utf8");
+        }
+        catch {
+            return undefined;
+        }
+        // Search for common MC version property patterns
+        const patterns = [
+            /^minecraft_version\s*=\s*(.+)$/m,
+            /^mc_version\s*=\s*(.+)$/m,
+            /^minecraftVersion\s*=\s*(.+)$/m
+        ];
+        for (const pattern of patterns) {
+            const match = content.match(pattern);
+            if (match?.[1]?.trim()) {
+                return match[1].trim();
+            }
+        }
+        return undefined;
+    }
 }
 //# sourceMappingURL=workspace-mapping-service.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adhisang/minecraft-modding-mcp",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "MCP server with utilities for Minecraft modding workflows",
   "type": "module",
   "main": "dist/index.js",