@adhisang/minecraft-modding-mcp 4.0.0 → 4.1.1

package/dist/entry-tools/compare-minecraft-service.d.ts

@@ -31,14 +31,14 @@ export declare const compareMinecraftShape: {
         className: string;
         fromVersion: string;
         toVersion: string;
-        mapping?: "intermediary" | "mojang" | "yarn" | "obfuscated" | undefined;
+        mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         sourcePriority?: "loom-first" | "maven-first" | undefined;
     }, {
         kind: "class";
         className: string;
         fromVersion: string;
         toVersion: string;
-        mapping?: "intermediary" | "mojang" | "yarn" | "obfuscated" | undefined;
+        mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         sourcePriority?: "loom-first" | "maven-first" | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"registry">;
@@ -92,14 +92,14 @@ export declare const compareMinecraftSchema: z.ZodObject<{
         className: string;
         fromVersion: string;
         toVersion: string;
-        mapping?: "intermediary" | "mojang" | "yarn" | "obfuscated" | undefined;
+        mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         sourcePriority?: "loom-first" | "maven-first" | undefined;
     }, {
         kind: "class";
         className: string;
         fromVersion: string;
         toVersion: string;
-        mapping?: "intermediary" | "mojang" | "yarn" | "obfuscated" | undefined;
+        mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         sourcePriority?: "loom-first" | "maven-first" | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"registry">;
@@ -135,7 +135,7 @@ export declare const compareMinecraftSchema: z.ZodObject<{
         className: string;
         fromVersion: string;
         toVersion: string;
-        mapping?: "intermediary" | "mojang" | "yarn" | "obfuscated" | undefined;
+        mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         sourcePriority?: "loom-first" | "maven-first" | undefined;
     } | {
         kind: "registry";
@@ -160,7 +160,7 @@ export declare const compareMinecraftSchema: z.ZodObject<{
         className: string;
         fromVersion: string;
         toVersion: string;
-        mapping?: "intermediary" | "mojang" | "yarn" | "obfuscated" | undefined;
+        mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         sourcePriority?: "loom-first" | "maven-first" | undefined;
     } | {
         kind: "registry";

package/dist/entry-tools/inspect-minecraft/handlers/artifact.d.ts

@@ -0,0 +1,5 @@
+import { type DetailLevel } from "../../response-contract.js";
+import { type Subject, type InspectMinecraftDeps } from "../internal.js";
+export declare function handleArtifact(deps: InspectMinecraftDeps, subject: Subject, detail: DetailLevel, include: string[]): Promise<{
+    warnings: string[];
+}>;

package/dist/entry-tools/inspect-minecraft/handlers/artifact.js

@@ -0,0 +1,83 @@
+import { buildEntryToolResult, createNextAction, createSummarySubject } from "../../response-contract.js";
+import { nextActionsOrUndefined } from "../../request-normalizers.js";
+import { resolveArtifactReference } from "../internal.js";
+export async function handleArtifact(deps, subject, detail, include) {
+    const resolved = await resolveArtifactReference(deps, subject);
+    if (!resolved.artifactId) {
+        const summary = {
+            status: "blocked",
+            headline: "Could not resolve an artifact without a Minecraft version.",
+            subject: createSummarySubject({
+                task: "artifact",
+                requested: subject
+            }),
+            nextActions: nextActionsOrUndefined([
+                createNextAction("inspect-minecraft", {
+                    task: "artifact",
+                    subject: {
+                        kind: "version",
+                        version: "1.21.10"
+                    }
+                })
+            ])
+        };
+        return {
+            ...buildEntryToolResult({
+                task: "artifact",
+                summary,
+                detail,
+                include,
+                blocks: {
+                    subject: {
+                        requested: subject
+                    }
+                },
+                alwaysBlocks: ["subject"]
+            }),
+            warnings: resolved.warnings
+        };
+    }
+    const summary = {
+        status: "ok",
+        headline: `Resolved artifact ${resolved.artifactId}.`,
+        subject: createSummarySubject({
+            task: "artifact",
+            requested: subject,
+            artifactId: resolved.artifactId,
+            version: resolved.version
+        }),
+        counts: {
+            warnings: resolved.warnings.length
+        }
+    };
+    return {
+        ...buildEntryToolResult({
+            task: "artifact",
+            summary,
+            detail,
+            include,
+            blocks: {
+                subject: {
+                    requested: subject,
+                    resolved: {
+                        artifactId: resolved.artifactId,
+                        version: resolved.version
+                    }
+                },
+                artifact: resolved.artifact
+                    ? {
+                        artifactId: resolved.artifact.artifactId,
+                        artifactAlias: resolved.artifact.artifactAlias,
+                        origin: resolved.artifact.origin,
+                        mappingApplied: resolved.artifact.mappingApplied,
+                        version: resolved.artifact.version,
+                        artifactContents: resolved.artifact.artifactContents
+                    }
+                    : { artifactId: resolved.artifactId }
+            },
+            alwaysBlocks: ["subject"]
+        }),
+        warnings: resolved.warnings
+    };
+}
+//# sourceMappingURL=artifact.js.map

package/dist/entry-tools/inspect-minecraft/handlers/class-members.d.ts

@@ -0,0 +1,6 @@
+import { type DetailLevel } from "../../response-contract.js";
+import { type Subject, type InspectMinecraftDeps } from "../internal.js";
+export declare function handleClassMembers(deps: InspectMinecraftDeps, subject: Subject, detail: DetailLevel, include: string[], limit: number | undefined): Promise<{
+    meta?: Record<string, unknown> | undefined;
+    warnings: string[];
+}>;

package/dist/entry-tools/inspect-minecraft/handlers/class-members.js

@@ -0,0 +1,80 @@
+import { buildEntryToolResult, buildEntryToolMeta, createNextAction, createSummarySubject, createTruncationMeta } from "../../response-contract.js";
+import { buildClassSubject, resolveClassArtifactReference, invalidTaskSubjectError } from "../internal.js";
+export async function handleClassMembers(deps, subject, detail, include, limit) {
+    if (subject.kind !== "class" && !(subject.kind === "workspace" && subject.focus?.kind === "class")) {
+        invalidTaskSubjectError("class-members", subject);
+    }
+    const classSubject = buildClassSubject(subject);
+    const artifact = await resolveClassArtifactReference(deps, subject, classSubject, "class-members");
+    const members = await deps.getClassMembers({
+        className: classSubject.className,
+        artifactId: artifact.artifactId || undefined,
+        mapping: classSubject.mapping,
+        scope: classSubject.scope,
+        projectPath: classSubject.projectPath,
+        preferProjectVersion: classSubject.preferProjectVersion,
+        strictVersion: classSubject.strictVersion,
+        maxMembers: limit
+    });
+    const summary = {
+        status: members.truncated ? "partial" : "ok",
+        headline: `Collected ${members.counts.total} members for ${members.className}.`,
+        subject: createSummarySubject({
+            task: "class-members",
+            requested: subject,
+            className: members.className,
+            artifactId: members.artifactId
+        }),
+        counts: members.counts
+    };
+    return {
+        ...buildEntryToolResult({
+            task: "class-members",
+            summary,
+            detail,
+            include,
+            blocks: {
+                subject: {
+                    requested: subject,
+                    resolved: {
+                        artifactId: members.artifactId,
+                        className: members.className
+                    }
+                },
+                members: include.includes("members") || detail !== "summary"
+                    ? {
+                        ...members.members,
+                        ...(members.decompiledFallback ? { decompiledFallback: members.decompiledFallback } : {}),
+                        ...(members.decompiledMemberCounts ? { decompiledMemberCounts: members.decompiledMemberCounts } : {})
+                    }
+                    : {
+                        counts: members.counts,
+                        ...(members.decompiledMemberCounts ? { decompiledMemberCounts: members.decompiledMemberCounts } : {})
+                    }
+            },
+            alwaysBlocks: ["subject"]
+        }),
+        warnings: [...artifact.warnings, ...members.warnings],
+        ...(members.truncated
+            ? {
+                meta: buildEntryToolMeta({
+                    detail,
+                    include,
+                    warnings: [...artifact.warnings, ...members.warnings],
+                    truncated: createTruncationMeta({
+                        omittedGroups: ["members"],
+                        nextActions: [
+                            createNextAction("inspect-minecraft", {
+                                task: "class-members",
+                                detail: "full",
+                                include: ["members"],
+                                subject
+                            })
+                        ]
+                    })
+                })
+            }
+            : {})
+    };
+}
+//# sourceMappingURL=class-members.js.map

package/dist/entry-tools/inspect-minecraft/handlers/class-overview.d.ts

@@ -0,0 +1,5 @@
+import { type DetailLevel } from "../../response-contract.js";
+import { type Subject, type InspectMinecraftDeps } from "../internal.js";
+export declare function handleClassOverview(deps: InspectMinecraftDeps, subject: Subject, detail: DetailLevel, include: string[]): Promise<{
+    warnings: string[];
+}>;

package/dist/entry-tools/inspect-minecraft/handlers/class-overview.js

@@ -0,0 +1,248 @@
+import { buildEntryToolResult, createNextAction, createSummarySubject } from "../../response-contract.js";
+import { nextActionsOrUndefined } from "../../request-normalizers.js";
+import { hasPartialVanillaCoverage, buildClassSubject, resolveClassArtifactReference, invalidTaskSubjectError, resolveBinaryBackedClass } from "../internal.js";
+export async function handleClassOverview(deps, subject, detail, include) {
+    if (subject.kind !== "class" && !(subject.kind === "workspace" && subject.focus?.kind === "class")) {
+        invalidTaskSubjectError("class-overview", subject);
+    }
+    const classSubject = buildClassSubject(subject);
+    const className = classSubject.className;
+    const artifact = await resolveClassArtifactReference(deps, subject, classSubject, "class-overview");
+    if (!artifact.artifactId) {
+        const summary = {
+            status: "blocked",
+            headline: `Could not resolve artifact context for ${className}.`,
+            subject: createSummarySubject({
+                task: "class-overview",
+                requested: subject,
+                className
+            })
+        };
+        return {
+            ...buildEntryToolResult({
+                task: "class-overview",
+                summary,
+                detail,
+                include,
+                blocks: {
+                    subject: {
+                        requested: subject
+                    }
+                },
+                alwaysBlocks: ["subject"]
+            }),
+            warnings: artifact.warnings
+        };
+    }
+    const matches = await deps.findClass({
+        artifactId: artifact.artifactId,
+        className,
+        limit: 10
+    });
+    if (matches.total === 0) {
+        const partialSourceFallback = subject.kind === "workspace" && hasPartialVanillaCoverage(artifact.artifact)
+            ? await resolveBinaryBackedClass(deps, className, {
+                version: artifact.version,
+                mapping: classSubject.mapping
+            })
+            : undefined;
+        if (partialSourceFallback) {
+            const metadata = await deps.getClassSource({
+                className: partialSourceFallback.className,
+                artifactId: artifact.artifactId,
+                mapping: classSubject.mapping,
+                scope: classSubject.scope,
+                projectPath: classSubject.projectPath,
+                preferProjectVersion: classSubject.preferProjectVersion,
+                strictVersion: classSubject.strictVersion,
+                mode: "metadata"
+            });
+            const summary = {
+                status: "ok",
+                headline: `Resolved class overview for ${partialSourceFallback.className}.`,
+                subject: createSummarySubject({
+                    task: "class-overview",
+                    requested: subject,
+                    className: partialSourceFallback.className,
+                    artifactId: metadata.artifactId
+                }),
+                counts: {
+                    totalLines: metadata.totalLines
+                },
+                notes: [
+                    "Source coverage was partial, so inspect-minecraft confirmed the vanilla class through binary-backed symbol lookup."
+                ]
+            };
+            return {
+                ...buildEntryToolResult({
+                    task: "class-overview",
+                    summary,
+                    detail,
+                    include,
+                    blocks: {
+                        subject: {
+                            requested: subject,
+                            resolved: {
+                                artifactId: metadata.artifactId,
+                                className: partialSourceFallback.className
+                            }
+                        },
+                        class: {
+                            className: partialSourceFallback.className,
+                            totalLines: metadata.totalLines,
+                            returnedNamespace: metadata.returnedNamespace
+                        }
+                    },
+                    alwaysBlocks: ["subject"]
+                }),
+                warnings: [
+                    ...artifact.warnings,
+                    ...matches.warnings,
+                    ...partialSourceFallback.warnings,
+                    ...metadata.warnings
+                ]
+            };
+        }
+        const summary = {
+            status: "not_found",
+            headline: `No class match was found for ${className}.`,
+            subject: createSummarySubject({
+                task: "class-overview",
+                requested: subject,
+                className,
+                artifactId: artifact.artifactId
+            })
+        };
+        return {
+            ...buildEntryToolResult({
+                task: "class-overview",
+                summary,
+                detail,
+                include,
+                blocks: {
+                    subject: {
+                        requested: subject,
+                        resolved: {
+                            artifactId: artifact.artifactId
+                        }
+                    }
+                },
+                alwaysBlocks: ["subject"]
+            }),
+            warnings: [...artifact.warnings, ...matches.warnings]
+        };
+    }
+    if (matches.total > 1) {
+        const candidateActions = matches.matches.slice(0, 3).map((match) => createNextAction("inspect-minecraft", {
+            task: "class-source",
+            subject: {
+                kind: "class",
+                className: match.qualifiedName,
+                artifact: {
+                    type: "resolved-id",
+                    artifactId: artifact.artifactId
+                }
+            },
+            include: ["source"]
+        }));
+        const summary = {
+            status: "ambiguous",
+            headline: `Found ${matches.total} class matches for ${className}.`,
+            subject: createSummarySubject({
+                task: "class-overview",
+                requested: subject,
+                className,
+                artifactId: artifact.artifactId
+            }),
+            counts: {
+                matches: matches.total
+            },
+            nextActions: nextActionsOrUndefined(candidateActions)
+        };
+        return {
+            ...buildEntryToolResult({
+                task: "class-overview",
+                summary,
+                detail,
+                include,
+                blocks: {
+                    subject: {
+                        requested: subject,
+                        resolved: {
+                            artifactId: artifact.artifactId
+                        }
+                    },
+                    candidates: matches.matches
+                },
+                alwaysBlocks: ["subject"]
+            }),
+            warnings: [...artifact.warnings, ...matches.warnings]
+        };
+    }
+    const match = matches.matches[0];
+    const metadata = await deps.getClassSource({
+        className: match.qualifiedName,
+        artifactId: artifact.artifactId,
+        mode: "metadata"
+    });
+    const summary = {
+        status: "ok",
+        headline: `Resolved class overview for ${match.qualifiedName}.`,
+        subject: createSummarySubject({
+            task: "class-overview",
+            requested: subject,
+            className: match.qualifiedName,
+            artifactId: artifact.artifactId
+        }),
+        counts: {
+            totalLines: metadata.totalLines
+        },
+        nextActions: nextActionsOrUndefined([
+            createNextAction("inspect-minecraft", {
+                task: "class-source",
+                subject: {
+                    kind: "class",
+                    className: match.qualifiedName,
+                    artifact: {
+                        type: "resolved-id",
+                        artifactId: artifact.artifactId
+                    }
+                },
+                include: ["source"]
+            })
+        ])
+    };
+    return {
+        ...buildEntryToolResult({
+            task: "class-overview",
+            summary,
+            detail,
+            include,
+            blocks: {
+                subject: {
+                    requested: subject,
+                    resolved: {
+                        artifactId: artifact.artifactId,
+                        className: match.qualifiedName
+                    }
+                },
+                artifact: artifact.artifact
+                    ? {
+                        artifactId: artifact.artifact.artifactId,
+                        version: artifact.artifact.version,
+                        origin: artifact.artifact.origin
+                    }
+                    : { artifactId: artifact.artifactId },
+                class: {
+                    className: match.qualifiedName,
+                    filePath: match.filePath,
+                    totalLines: metadata.totalLines,
+                    returnedNamespace: metadata.returnedNamespace
+                }
+            },
+            alwaysBlocks: ["subject"]
+        }),
+        warnings: [...artifact.warnings, ...matches.warnings, ...metadata.warnings]
+    };
+}
+//# sourceMappingURL=class-overview.js.map

package/dist/entry-tools/inspect-minecraft/handlers/class-source.d.ts

@@ -0,0 +1,5 @@
+import { type DetailLevel } from "../../response-contract.js";
+import { type Subject, type InspectMinecraftDeps } from "../internal.js";
+export declare function handleClassSource(deps: InspectMinecraftDeps, subject: Subject, detail: DetailLevel, include: string[]): Promise<{
+    warnings: string[];
+}>;

package/dist/entry-tools/inspect-minecraft/handlers/class-source.js

@@ -0,0 +1,60 @@
+import { buildEntryToolResult, createSummarySubject } from "../../response-contract.js";
+import { buildClassSubject, resolveClassArtifactReference, invalidTaskSubjectError } from "../internal.js";
+export async function handleClassSource(deps, subject, detail, include) {
+    if (subject.kind !== "class" && !(subject.kind === "workspace" && subject.focus?.kind === "class")) {
+        invalidTaskSubjectError("class-source", subject);
+    }
+    const classSubject = buildClassSubject(subject);
+    const className = classSubject.className;
+    const artifactContext = await resolveClassArtifactReference(deps, subject, classSubject, "class-source");
+    const source = await deps.getClassSource({
+        className,
+        artifactId: artifactContext.artifactId || undefined,
+        mapping: classSubject.mapping,
+        scope: classSubject.scope,
+        projectPath: classSubject.projectPath,
+        preferProjectVersion: classSubject.preferProjectVersion,
+        strictVersion: classSubject.strictVersion,
+        mode: include.includes("source") || detail === "full" ? "snippet" : "metadata"
+    });
+    const summary = {
+        status: "ok",
+        headline: `Resolved source for ${source.className}.`,
+        subject: createSummarySubject({
+            task: "class-source",
+            requested: subject,
+            className: source.className,
+            artifactId: source.artifactId
+        }),
+        counts: {
+            totalLines: source.totalLines
+        }
+    };
+    return {
+        ...buildEntryToolResult({
+            task: "class-source",
+            summary,
+            detail,
+            include,
+            blocks: {
+                subject: {
+                    requested: subject,
+                    resolved: {
+                        artifactId: source.artifactId,
+                        className: source.className
+                    }
+                },
+                source: {
+                    className: source.className,
+                    mode: source.mode,
+                    returnedRange: source.returnedRange,
+                    totalLines: source.totalLines,
+                    sourceText: source.sourceText
+                }
+            },
+            alwaysBlocks: ["subject"]
+        }),
+        warnings: [...artifactContext.warnings, ...source.warnings]
+    };
+}
+//# sourceMappingURL=class-source.js.map

package/dist/entry-tools/inspect-minecraft/handlers/file.d.ts

@@ -0,0 +1,5 @@
+import { type DetailLevel } from "../../response-contract.js";
+import { type Subject, type InspectMinecraftDeps } from "../internal.js";
+export declare function handleFile(deps: InspectMinecraftDeps, subject: Subject, detail: DetailLevel, include: string[]): Promise<{
+    warnings: string[];
+}>;

package/dist/entry-tools/inspect-minecraft/handlers/file.js

@@ -0,0 +1,54 @@
+import { buildEntryToolResult, createSummarySubject } from "../../response-contract.js";
+import { requireWorkspaceFileFocus, resolveWorkspaceArtifactReference, invalidTaskSubjectError, resolveArtifactReference } from "../internal.js";
+export async function handleFile(deps, subject, detail, include) {
+    if (subject.kind !== "file" && !(subject.kind === "workspace" && subject.focus?.kind === "file")) {
+        invalidTaskSubjectError("file", subject);
+    }
+    const fileSubject = subject.kind === "file" ? subject : requireWorkspaceFileFocus(subject);
+    const artifact = subject.kind === "file"
+        ? await resolveArtifactReference(deps, subject, "file")
+        : await resolveWorkspaceArtifactReference(deps, subject, fileSubject.artifact);
+    const file = await deps.getArtifactFile({
+        artifactId: artifact.artifactId,
+        filePath: fileSubject.filePath
+    });
+    const summary = {
+        status: "ok",
+        headline: `Read ${file.filePath}.`,
+        subject: createSummarySubject({
+            task: "file",
+            requested: subject,
+            filePath: file.filePath,
+            artifactId: artifact.artifactId
+        }),
+        counts: {
+            bytes: file.contentBytes
+        }
+    };
+    return {
+        ...buildEntryToolResult({
+            task: "file",
+            summary,
+            detail,
+            include,
+            blocks: {
+                subject: {
+                    requested: subject,
+                    resolved: {
+                        artifactId: artifact.artifactId,
+                        filePath: file.filePath
+                    }
+                },
+                file: {
+                    filePath: file.filePath,
+                    contentBytes: file.contentBytes,
+                    truncated: file.truncated,
+                    content: include.includes("source") || detail !== "summary" ? file.content : undefined
+                }
+            },
+            alwaysBlocks: ["subject"]
+        }),
+        warnings: [...artifact.warnings]
+    };
+}
+//# sourceMappingURL=file.js.map

package/dist/entry-tools/inspect-minecraft/handlers/list-files.d.ts

@@ -0,0 +1,5 @@
+import { type DetailLevel } from "../../response-contract.js";
+import { type Subject, type InspectMinecraftDeps } from "../internal.js";
+export declare function handleListFiles(deps: InspectMinecraftDeps, subject: Subject, detail: DetailLevel, include: string[], limit: number | undefined, cursor: string | undefined): Promise<{
+    warnings: string[];
+}>;