@adhisang/minecraft-modding-mcp 3.0.0 → 3.1.1

package/dist/entry-tools/manage-cache-service.d.ts

@@ -36,9 +36,9 @@ export declare const manageCacheShape: {
     }>>;
     detail: z.ZodOptional<z.ZodEnum<["summary", "standard", "full"]>>;
     include: z.ZodOptional<z.ZodArray<z.ZodEnum<[string, ...string[]]>, "many">>;
-    limit: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
     cursor: z.ZodOptional<z.ZodString>;
-    executionMode: z.ZodOptional<z.ZodEnum<["preview", "apply"]>>;
+    executionMode: z.ZodDefault<z.ZodEnum<["preview", "apply"]>>;
 };
 export declare const manageCacheSchema: z.ZodObject<{
     action: z.ZodEnum<["summary", "list", "inspect", "delete", "prune", "rebuild", "verify"]>;
@@ -76,16 +76,16 @@ export declare const manageCacheSchema: z.ZodObject<{
     }>>;
     detail: z.ZodOptional<z.ZodEnum<["summary", "standard", "full"]>>;
     include: z.ZodOptional<z.ZodArray<z.ZodEnum<[string, ...string[]]>, "many">>;
-    limit: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
     cursor: z.ZodOptional<z.ZodString>;
-    executionMode: z.ZodOptional<z.ZodEnum<["preview", "apply"]>>;
+    executionMode: z.ZodDefault<z.ZodEnum<["preview", "apply"]>>;
 }, "strip", z.ZodTypeAny, {
+    limit: number;
+    executionMode: "preview" | "apply";
     action: "list" | "summary" | "inspect" | "verify" | "delete" | "prune" | "rebuild";
-    limit?: number | undefined;
     cursor?: string | undefined;
     detail?: "full" | "summary" | "standard" | undefined;
     include?: string[] | undefined;
-    executionMode?: "preview" | "apply" | undefined;
     cacheKinds?: ("artifact-index" | "downloads" | "mapping" | "registry" | "decompiled-source" | "mod-remap")[] | undefined;
     selector?: {
         mapping?: string | undefined;

package/dist/entry-tools/manage-cache-service.js

@@ -2,7 +2,7 @@ import { z } from "zod";
 import { PUBLIC_CACHE_KINDS } from "../cache-registry.js";
 import { createError, ERROR_CODES } from "../errors.js";
 import { buildIncludeSchema, detailSchema, executionModeSchema, positiveIntSchema } from "./entry-tool-schema.js";
-import { buildEntryToolResult } from "./response-contract.js";
+import { buildEntryToolResult, createNextAction, createSummarySubject } from "./response-contract.js";
 import { normalizeReadOnlyExecutionMode, requireNonEmptyObject, resolveDetail, resolveInclude } from "./request-normalizers.js";
 const nonEmptyString = z.string().trim().min(1);
 const INCLUDE_GROUPS = ["warnings", "cacheEntries", "paths", "owners", "health", "preview", "timings"];
@@ -22,9 +22,9 @@ export const manageCacheShape = {
     }).optional(),
     detail: detailSchema.optional(),
     include: buildIncludeSchema(INCLUDE_GROUPS),
-    limit: positiveIntSchema.optional(),
+    limit: positiveIntSchema.default(50),
     cursor: nonEmptyString.optional(),
-    executionMode: executionModeSchema.optional()
+    executionMode: executionModeSchema.default("preview")
 };
 export const manageCacheSchema = z.object(manageCacheShape);
 export class ManageCacheService {
@@ -37,6 +37,12 @@ export class ManageCacheService {
         const include = resolveInclude(input.include);
         const executionMode = normalizeReadOnlyExecutionMode(input.action, input.executionMode);
         const cacheKinds = input.cacheKinds?.length ? input.cacheKinds : [...PUBLIC_CACHE_KINDS];
+        const summarySubject = createSummarySubject({
+            action: input.action,
+            cacheKinds,
+            executionMode,
+            selector: input.selector
+        });
         if (executionMode === "apply" &&
             (input.action === "delete" || input.action === "prune" || input.action === "rebuild")) {
             requireNonEmptyObject(input.selector, `${input.action} apply requires a non-empty selector.`);
@@ -58,6 +64,7 @@ export class ManageCacheService {
                         summary: {
                             status: hasUnhealthyKinds ? "partial" : "ok",
                             headline: `Summarized ${cacheKinds.length} cache kind(s).`,
+                            subject: summarySubject,
                             counts: {
                                 entries: entryCount,
                                 bytes: totalBytes
@@ -100,6 +107,7 @@ export class ManageCacheService {
                         summary: {
                             status: hasUnhealthyEntries ? "partial" : "ok",
                             headline: `${input.action === "list" ? "Listed" : "Inspected"} ${page.entries.length} cache entr${page.entries.length === 1 ? "y" : "ies"}.`,
+                            subject: summarySubject,
                             counts: {
                                 entries: page.entries.length
                             }
@@ -137,6 +145,7 @@ export class ManageCacheService {
                         summary: {
                             status: output.unhealthyEntries > 0 ? "partial" : "ok",
                             headline: `Verified ${output.checkedEntries} cache entr${output.checkedEntries === 1 ? "y" : "ies"}.`,
+                            subject: summarySubject,
                             counts: {
                                 checkedEntries: output.checkedEntries,
                                 unhealthyEntries: output.unhealthyEntries
@@ -173,10 +182,23 @@ export class ManageCacheService {
                         summary: {
                             status: output.deletedEntries > 0 && executionMode === "apply" ? "changed" : "unchanged",
                             headline: `${executionMode === "apply" ? "Applied" : "Previewed"} ${input.action} across ${cacheKinds.length} cache kind(s).`,
+                            subject: summarySubject,
                             counts: {
                                 deletedEntries: output.deletedEntries,
                                 deletedBytes: output.deletedBytes
-                            }
+                            },
+                            ...(executionMode === "preview"
+                                ? {
+                                    nextActions: [
+                                        createNextAction("manage-cache", {
+                                            action: input.action,
+                                            cacheKinds,
+                                            executionMode: "apply",
+                                            selector: input.selector
+                                        })
+                                    ]
+                                }
+                                : {})
                         },
                         blocks: {
                             operation: {
@@ -204,9 +226,22 @@ export class ManageCacheService {
                         summary: {
                             status: output.rebuiltEntries > 0 && executionMode === "apply" ? "changed" : "unchanged",
                             headline: `${executionMode === "apply" ? "Applied" : "Previewed"} rebuild for ${cacheKinds.length} cache kind(s).`,
+                            subject: summarySubject,
                             counts: {
                                 rebuiltEntries: output.rebuiltEntries
-                            }
+                            },
+                            ...(executionMode === "preview"
+                                ? {
+                                    nextActions: [
+                                        createNextAction("manage-cache", {
+                                            action: "rebuild",
+                                            cacheKinds,
+                                            executionMode: "apply",
+                                            selector: input.selector
+                                        })
+                                    ]
+                                }
+                                : {})
                         },
                         blocks: {
                             operation: {

package/dist/entry-tools/response-contract.d.ts

@@ -23,6 +23,7 @@ export type TruncationMeta = {
 };
 export declare function normalizeIncludeGroups(include: readonly string[] | undefined): string[];
 export declare function createNextAction(tool: string, params: Record<string, unknown>): NextAction;
+export declare function createSummarySubject(fields: Record<string, unknown>): Record<string, unknown>;
 export declare function createTruncationMeta(input: {
     omittedGroups?: string[];
     nextActions?: NextAction[];

package/dist/entry-tools/response-contract.js

@@ -57,6 +57,9 @@ export function normalizeIncludeGroups(include) {
 export function createNextAction(tool, params) {
     return { tool, params };
 }
+export function createSummarySubject(fields) {
+    return Object.fromEntries(Object.entries(fields).filter(([, value]) => value !== undefined));
+}
 export function createTruncationMeta(input) {
     return {
         didTruncate: true,

package/dist/entry-tools/validate-project-service.d.ts

@@ -142,18 +142,18 @@ export declare const validateProjectShape: {
     sourcePriority: z.ZodOptional<z.ZodEnum<["loom-first", "maven-first"]>>;
     scope: z.ZodOptional<z.ZodEnum<["vanilla", "merged", "loader"]>>;
     preferProjectVersion: z.ZodOptional<z.ZodBoolean>;
-    preferProjectMapping: z.ZodOptional<z.ZodBoolean>;
+    preferProjectMapping: z.ZodDefault<z.ZodBoolean>;
     detail: z.ZodOptional<z.ZodEnum<["summary", "standard", "full"]>>;
     include: z.ZodOptional<z.ZodArray<z.ZodEnum<[string, ...string[]]>, "many">>;
     sourceRoots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     configPaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    minSeverity: z.ZodOptional<z.ZodEnum<["error", "warning", "all"]>>;
-    hideUncertain: z.ZodOptional<z.ZodBoolean>;
-    explain: z.ZodOptional<z.ZodBoolean>;
+    minSeverity: z.ZodDefault<z.ZodEnum<["error", "warning", "all"]>>;
+    hideUncertain: z.ZodDefault<z.ZodBoolean>;
+    explain: z.ZodDefault<z.ZodBoolean>;
     warningMode: z.ZodOptional<z.ZodEnum<["full", "aggregated"]>>;
     warningCategoryFilter: z.ZodOptional<z.ZodArray<z.ZodEnum<["mapping", "configuration", "validation", "resolution", "parse"]>, "many">>;
-    treatInfoAsWarning: z.ZodOptional<z.ZodBoolean>;
-    includeIssues: z.ZodOptional<z.ZodBoolean>;
+    treatInfoAsWarning: z.ZodDefault<z.ZodBoolean>;
+    includeIssues: z.ZodDefault<z.ZodBoolean>;
 };
 export declare const validateProjectSchema: z.ZodEffects<z.ZodObject<{
     task: z.ZodEnum<["project-summary", "mixin", "access-widener"]>;
@@ -298,19 +298,25 @@ export declare const validateProjectSchema: z.ZodEffects<z.ZodObject<{
     sourcePriority: z.ZodOptional<z.ZodEnum<["loom-first", "maven-first"]>>;
     scope: z.ZodOptional<z.ZodEnum<["vanilla", "merged", "loader"]>>;
     preferProjectVersion: z.ZodOptional<z.ZodBoolean>;
-    preferProjectMapping: z.ZodOptional<z.ZodBoolean>;
+    preferProjectMapping: z.ZodDefault<z.ZodBoolean>;
     detail: z.ZodOptional<z.ZodEnum<["summary", "standard", "full"]>>;
     include: z.ZodOptional<z.ZodArray<z.ZodEnum<[string, ...string[]]>, "many">>;
     sourceRoots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     configPaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    minSeverity: z.ZodOptional<z.ZodEnum<["error", "warning", "all"]>>;
-    hideUncertain: z.ZodOptional<z.ZodBoolean>;
-    explain: z.ZodOptional<z.ZodBoolean>;
+    minSeverity: z.ZodDefault<z.ZodEnum<["error", "warning", "all"]>>;
+    hideUncertain: z.ZodDefault<z.ZodBoolean>;
+    explain: z.ZodDefault<z.ZodBoolean>;
     warningMode: z.ZodOptional<z.ZodEnum<["full", "aggregated"]>>;
     warningCategoryFilter: z.ZodOptional<z.ZodArray<z.ZodEnum<["mapping", "configuration", "validation", "resolution", "parse"]>, "many">>;
-    treatInfoAsWarning: z.ZodOptional<z.ZodBoolean>;
-    includeIssues: z.ZodOptional<z.ZodBoolean>;
+    treatInfoAsWarning: z.ZodDefault<z.ZodBoolean>;
+    includeIssues: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
+    minSeverity: "all" | "error" | "warning";
+    hideUncertain: boolean;
+    explain: boolean;
+    preferProjectMapping: boolean;
+    treatInfoAsWarning: boolean;
+    includeIssues: boolean;
     task: "mixin" | "access-widener" | "project-summary";
     subject: {
         kind: "workspace";
@@ -350,14 +356,8 @@ export declare const validateProjectSchema: z.ZodEffects<z.ZodObject<{
     sourcePriority?: "loom-first" | "maven-first" | undefined;
     sourceRoots?: string[] | undefined;
     preferProjectVersion?: boolean | undefined;
-    minSeverity?: "all" | "error" | "warning" | undefined;
-    hideUncertain?: boolean | undefined;
-    explain?: boolean | undefined;
     warningMode?: "full" | "aggregated" | undefined;
-    preferProjectMapping?: boolean | undefined;
     warningCategoryFilter?: ("mapping" | "parse" | "validation" | "configuration" | "resolution")[] | undefined;
-    treatInfoAsWarning?: boolean | undefined;
-    includeIssues?: boolean | undefined;
     configPaths?: string[] | undefined;
     detail?: "full" | "summary" | "standard" | undefined;
     include?: string[] | undefined;
@@ -413,6 +413,12 @@ export declare const validateProjectSchema: z.ZodEffects<z.ZodObject<{
     detail?: "full" | "summary" | "standard" | undefined;
     include?: string[] | undefined;
 }>, {
+    minSeverity: "all" | "error" | "warning";
+    hideUncertain: boolean;
+    explain: boolean;
+    preferProjectMapping: boolean;
+    treatInfoAsWarning: boolean;
+    includeIssues: boolean;
     task: "mixin" | "access-widener" | "project-summary";
     subject: {
         kind: "workspace";
@@ -452,14 +458,8 @@ export declare const validateProjectSchema: z.ZodEffects<z.ZodObject<{
     sourcePriority?: "loom-first" | "maven-first" | undefined;
     sourceRoots?: string[] | undefined;
     preferProjectVersion?: boolean | undefined;
-    minSeverity?: "all" | "error" | "warning" | undefined;
-    hideUncertain?: boolean | undefined;
-    explain?: boolean | undefined;
     warningMode?: "full" | "aggregated" | undefined;
-    preferProjectMapping?: boolean | undefined;
     warningCategoryFilter?: ("mapping" | "parse" | "validation" | "configuration" | "resolution")[] | undefined;
-    treatInfoAsWarning?: boolean | undefined;
-    includeIssues?: boolean | undefined;
     configPaths?: string[] | undefined;
     detail?: "full" | "summary" | "standard" | undefined;
     include?: string[] | undefined;

package/dist/entry-tools/validate-project-service.js

@@ -4,7 +4,7 @@ import fastGlob from "fast-glob";
 import { z } from "zod";
 import { createError, ERROR_CODES } from "../errors.js";
 import { buildIncludeSchema, detailSchema } from "./entry-tool-schema.js";
-import { buildEntryToolResult } from "./response-contract.js";
+import { buildEntryToolResult, createSummarySubject } from "./response-contract.js";
 import { resolveDetail, resolveInclude } from "./request-normalizers.js";
 const nonEmptyString = z.string().trim().min(1);
 const INCLUDE_GROUPS = ["warnings", "issues", "workspace", "recovery"];
@@ -42,18 +42,18 @@ export const validateProjectShape = {
     sourcePriority: z.enum(["loom-first", "maven-first"]).optional(),
     scope: z.enum(["vanilla", "merged", "loader"]).optional(),
     preferProjectVersion: z.boolean().optional(),
-    preferProjectMapping: z.boolean().optional(),
+    preferProjectMapping: z.boolean().default(false),
     detail: detailSchema.optional(),
     include: buildIncludeSchema(INCLUDE_GROUPS),
     sourceRoots: z.array(nonEmptyString).optional(),
     configPaths: z.array(nonEmptyString).optional(),
-    minSeverity: z.enum(["error", "warning", "all"]).optional(),
-    hideUncertain: z.boolean().optional(),
-    explain: z.boolean().optional(),
+    minSeverity: z.enum(["error", "warning", "all"]).default("all"),
+    hideUncertain: z.boolean().default(false),
+    explain: z.boolean().default(false),
     warningMode: z.enum(["full", "aggregated"]).optional(),
     warningCategoryFilter: z.array(z.enum(["mapping", "configuration", "validation", "resolution", "parse"])).optional(),
-    treatInfoAsWarning: z.boolean().optional(),
-    includeIssues: z.boolean().optional()
+    treatInfoAsWarning: z.boolean().default(true),
+    includeIssues: z.boolean().default(true)
 };
 export const validateProjectSchema = z.object(validateProjectShape).superRefine((value, ctx) => {
     if (value.task === "project-summary" && value.subject.kind !== "workspace") {
@@ -162,6 +162,15 @@ export class ValidateProjectService {
                         summary: {
                             status: invalidCount > 0 ? "invalid" : partialCount > 0 ? "partial" : "ok",
                             headline: `Validated ${summary?.total ?? 0} mixin input(s).`,
+                            subject: createSummarySubject({
+                                task: "mixin",
+                                kind: input.subject.kind,
+                                input: input.subject.input,
+                                version: input.version,
+                                mapping: input.mapping,
+                                sourcePriority: input.sourcePriority,
+                                scope: input.scope
+                            }),
                             counts: {
                                 valid: summary?.valid ?? 0,
                                 partial: partialCount,
@@ -205,6 +214,14 @@ export class ValidateProjectService {
                             headline: output.valid
                                 ? "Access Widener is valid."
                                 : "Access Widener contains validation issues.",
+                            subject: createSummarySubject({
+                                task: "access-widener",
+                                kind: input.subject.kind,
+                                input: input.subject.input,
+                                version: input.version,
+                                mapping: input.mapping,
+                                sourcePriority: input.sourcePriority
+                            }),
                             counts: {
                                 valid: output.valid ? 1 : 0,
                                 invalid: output.valid ? 0 : 1
@@ -241,6 +258,12 @@ export class ValidateProjectService {
                             summary: {
                                 status: "blocked",
                                 headline: "project-summary requires version or preferProjectVersion=true.",
+                                subject: createSummarySubject({
+                                    task: "project-summary",
+                                    kind: input.subject.kind,
+                                    projectPath: input.subject.projectPath,
+                                    discover: input.subject.discover
+                                }),
                                 nextActions: [
                                     {
                                         tool: "validate-project",
@@ -350,6 +373,16 @@ export class ValidateProjectService {
                         summary: {
                             status,
                             headline: `Validated ${mixinConfigs.length} mixin config(s) and ${accessWideners.length} access widener(s).`,
+                            subject: createSummarySubject({
+                                task: "project-summary",
+                                kind: input.subject.kind,
+                                projectPath,
+                                discover: input.subject.discover,
+                                version: input.version,
+                                mapping: input.mapping,
+                                sourcePriority: input.sourcePriority,
+                                scope: input.scope
+                            }),
                             counts: {
                                 valid: validMixins + validAw,
                                 partial: partialCount,