@adhisang/minecraft-modding-mcp 3.0.0 → 3.1.0

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

@@ -285,10 +285,11 @@ export declare const inspectMinecraftShape: {
         symbolKind: z.ZodOptional<z.ZodEnum<["class", "interface", "enum", "record", "method", "field"]>>;
         packagePrefix: z.ZodOptional<z.ZodString>;
         fileGlob: z.ZodOptional<z.ZodString>;
-        queryMode: z.ZodOptional<z.ZodEnum<["auto", "token", "literal"]>>;
+        queryMode: z.ZodDefault<z.ZodEnum<["auto", "token", "literal"]>>;
     }, "strip", z.ZodTypeAny, {
         kind: "search";
         query: string;
+        queryMode: "auto" | "token" | "literal";
         match?: "exact" | "prefix" | "contains" | "regex" | undefined;
         symbolKind?: "class" | "method" | "field" | "record" | "interface" | "enum" | undefined;
         intent?: "symbol" | "path" | "text" | undefined;
@@ -304,7 +305,6 @@ export declare const inspectMinecraftShape: {
             };
         } | undefined;
         packagePrefix?: string | undefined;
-        queryMode?: "auto" | "token" | "literal" | undefined;
     }, {
         kind: "search";
         query: string;
@@ -499,10 +499,11 @@ export declare const inspectMinecraftShape: {
             symbolKind: z.ZodOptional<z.ZodEnum<["class", "interface", "enum", "record", "method", "field"]>>;
             packagePrefix: z.ZodOptional<z.ZodString>;
             fileGlob: z.ZodOptional<z.ZodString>;
-            queryMode: z.ZodOptional<z.ZodEnum<["auto", "token", "literal"]>>;
+            queryMode: z.ZodDefault<z.ZodEnum<["auto", "token", "literal"]>>;
         }, "strip", z.ZodTypeAny, {
             kind: "search";
             query: string;
+            queryMode: "auto" | "token" | "literal";
             match?: "exact" | "prefix" | "contains" | "regex" | undefined;
             symbolKind?: "class" | "method" | "field" | "record" | "interface" | "enum" | undefined;
             intent?: "symbol" | "path" | "text" | undefined;
@@ -518,7 +519,6 @@ export declare const inspectMinecraftShape: {
                 };
             } | undefined;
             packagePrefix?: string | undefined;
-            queryMode?: "auto" | "token" | "literal" | undefined;
         }, {
             kind: "search";
             query: string;
@@ -575,6 +575,7 @@ export declare const inspectMinecraftShape: {
         } | {
             kind: "search";
             query: string;
+            queryMode: "auto" | "token" | "literal";
             match?: "exact" | "prefix" | "contains" | "regex" | undefined;
             symbolKind?: "class" | "method" | "field" | "record" | "interface" | "enum" | undefined;
             intent?: "symbol" | "path" | "text" | undefined;
@@ -590,7 +591,6 @@ export declare const inspectMinecraftShape: {
                 };
             } | undefined;
             packagePrefix?: string | undefined;
-            queryMode?: "auto" | "token" | "literal" | undefined;
         } | undefined;
     }, {
         kind: "workspace";
@@ -646,7 +646,7 @@ export declare const inspectMinecraftShape: {
             queryMode?: "auto" | "token" | "literal" | undefined;
         } | undefined;
     }>]>>;
-    includeSnapshots: z.ZodOptional<z.ZodBoolean>;
+    includeSnapshots: z.ZodDefault<z.ZodBoolean>;
     detail: z.ZodOptional<z.ZodEnum<["summary", "standard", "full"]>>;
     include: z.ZodOptional<z.ZodArray<z.ZodEnum<[string, ...string[]]>, "many">>;
     limit: z.ZodOptional<z.ZodNumber>;
@@ -936,10 +936,11 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         symbolKind: z.ZodOptional<z.ZodEnum<["class", "interface", "enum", "record", "method", "field"]>>;
         packagePrefix: z.ZodOptional<z.ZodString>;
         fileGlob: z.ZodOptional<z.ZodString>;
-        queryMode: z.ZodOptional<z.ZodEnum<["auto", "token", "literal"]>>;
+        queryMode: z.ZodDefault<z.ZodEnum<["auto", "token", "literal"]>>;
     }, "strip", z.ZodTypeAny, {
         kind: "search";
         query: string;
+        queryMode: "auto" | "token" | "literal";
         match?: "exact" | "prefix" | "contains" | "regex" | undefined;
         symbolKind?: "class" | "method" | "field" | "record" | "interface" | "enum" | undefined;
         intent?: "symbol" | "path" | "text" | undefined;
@@ -955,7 +956,6 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
             };
         } | undefined;
         packagePrefix?: string | undefined;
-        queryMode?: "auto" | "token" | "literal" | undefined;
     }, {
         kind: "search";
         query: string;
@@ -1150,10 +1150,11 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
             symbolKind: z.ZodOptional<z.ZodEnum<["class", "interface", "enum", "record", "method", "field"]>>;
             packagePrefix: z.ZodOptional<z.ZodString>;
             fileGlob: z.ZodOptional<z.ZodString>;
-            queryMode: z.ZodOptional<z.ZodEnum<["auto", "token", "literal"]>>;
+            queryMode: z.ZodDefault<z.ZodEnum<["auto", "token", "literal"]>>;
         }, "strip", z.ZodTypeAny, {
             kind: "search";
             query: string;
+            queryMode: "auto" | "token" | "literal";
             match?: "exact" | "prefix" | "contains" | "regex" | undefined;
             symbolKind?: "class" | "method" | "field" | "record" | "interface" | "enum" | undefined;
             intent?: "symbol" | "path" | "text" | undefined;
@@ -1169,7 +1170,6 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
                 };
             } | undefined;
             packagePrefix?: string | undefined;
-            queryMode?: "auto" | "token" | "literal" | undefined;
         }, {
             kind: "search";
             query: string;
@@ -1226,6 +1226,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         } | {
             kind: "search";
             query: string;
+            queryMode: "auto" | "token" | "literal";
             match?: "exact" | "prefix" | "contains" | "regex" | undefined;
             symbolKind?: "class" | "method" | "field" | "record" | "interface" | "enum" | undefined;
             intent?: "symbol" | "path" | "text" | undefined;
@@ -1241,7 +1242,6 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
                 };
             } | undefined;
             packagePrefix?: string | undefined;
-            queryMode?: "auto" | "token" | "literal" | undefined;
         } | undefined;
     }, {
         kind: "workspace";
@@ -1297,15 +1297,15 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
             queryMode?: "auto" | "token" | "literal" | undefined;
         } | undefined;
     }>]>>;
-    includeSnapshots: z.ZodOptional<z.ZodBoolean>;
+    includeSnapshots: z.ZodDefault<z.ZodBoolean>;
     detail: z.ZodOptional<z.ZodEnum<["summary", "standard", "full"]>>;
     include: z.ZodOptional<z.ZodArray<z.ZodEnum<[string, ...string[]]>, "many">>;
     limit: z.ZodOptional<z.ZodNumber>;
     cursor: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
+    includeSnapshots: boolean;
     limit?: number | undefined;
     cursor?: string | undefined;
-    includeSnapshots?: boolean | undefined;
     task?: "search" | "auto" | "versions" | "class-source" | "class-members" | "artifact" | "class-overview" | "file" | "list-files" | undefined;
     subject?: {
         kind: "version";
@@ -1366,6 +1366,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
     } | {
         kind: "search";
         query: string;
+        queryMode: "auto" | "token" | "literal";
         match?: "exact" | "prefix" | "contains" | "regex" | undefined;
         symbolKind?: "class" | "method" | "field" | "record" | "interface" | "enum" | undefined;
         intent?: "symbol" | "path" | "text" | undefined;
@@ -1381,7 +1382,6 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
             };
         } | undefined;
         packagePrefix?: string | undefined;
-        queryMode?: "auto" | "token" | "literal" | undefined;
     } | {
         kind: "workspace";
         projectPath: string;
@@ -1418,6 +1418,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         } | {
             kind: "search";
             query: string;
+            queryMode: "auto" | "token" | "literal";
             match?: "exact" | "prefix" | "contains" | "regex" | undefined;
             symbolKind?: "class" | "method" | "field" | "record" | "interface" | "enum" | undefined;
             intent?: "symbol" | "path" | "text" | undefined;
@@ -1433,7 +1434,6 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
                 };
             } | undefined;
             packagePrefix?: string | undefined;
-            queryMode?: "auto" | "token" | "literal" | undefined;
         } | undefined;
     } | undefined;
     detail?: "full" | "summary" | "standard" | undefined;
@@ -1575,9 +1575,9 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
     detail?: "full" | "summary" | "standard" | undefined;
     include?: string[] | undefined;
 }>, {
+    includeSnapshots: boolean;
     limit?: number | undefined;
     cursor?: string | undefined;
-    includeSnapshots?: boolean | undefined;
     task?: "search" | "auto" | "versions" | "class-source" | "class-members" | "artifact" | "class-overview" | "file" | "list-files" | undefined;
     subject?: {
         kind: "version";
@@ -1638,6 +1638,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
     } | {
         kind: "search";
         query: string;
+        queryMode: "auto" | "token" | "literal";
         match?: "exact" | "prefix" | "contains" | "regex" | undefined;
         symbolKind?: "class" | "method" | "field" | "record" | "interface" | "enum" | undefined;
         intent?: "symbol" | "path" | "text" | undefined;
@@ -1653,7 +1654,6 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
             };
         } | undefined;
         packagePrefix?: string | undefined;
-        queryMode?: "auto" | "token" | "literal" | undefined;
     } | {
         kind: "workspace";
         projectPath: string;
@@ -1690,6 +1690,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         } | {
             kind: "search";
             query: string;
+            queryMode: "auto" | "token" | "literal";
             match?: "exact" | "prefix" | "contains" | "regex" | undefined;
             symbolKind?: "class" | "method" | "field" | "record" | "interface" | "enum" | undefined;
             intent?: "symbol" | "path" | "text" | undefined;
@@ -1705,7 +1706,6 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
                 };
             } | undefined;
             packagePrefix?: string | undefined;
-            queryMode?: "auto" | "token" | "literal" | undefined;
         } | undefined;
     } | undefined;
     detail?: "full" | "summary" | "standard" | undefined;
@@ -1939,6 +1939,7 @@ export declare class InspectMinecraftService {
     private resolveClassArtifactReference;
     private resolveWorkspaceArtifactReference;
     private resolveTask;
+    private summarizeRequestedSubject;
     private resolveArtifactReference;
     private resolveArtifactRef;
     private handleVersions;

package/dist/entry-tools/inspect-minecraft-service.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { createError, ERROR_CODES } from "../errors.js";
 import { buildIncludeSchema, detailSchema, positiveIntSchema } from "./entry-tool-schema.js";
-import { buildEntryToolResult, buildEntryToolMeta, createNextAction, createTruncationMeta } from "./response-contract.js";
+import { buildEntryToolResult, buildEntryToolMeta, createNextAction, createSummarySubject, createTruncationMeta } from "./response-contract.js";
 import { capArray, nextActionsOrUndefined, resolveDetail, resolveInclude } from "./request-normalizers.js";
 const INCLUDE_GROUPS = ["warnings", "provenance", "candidates", "members", "source", "files", "samples", "artifact", "timings"];
 const TASKS = ["auto", "versions", "artifact", "class-overview", "class-source", "class-members", "search", "file", "list-files"];
@@ -41,7 +41,7 @@ const workspaceFocusSchema = z.discriminatedUnion("kind", [
         symbolKind: z.enum(["class", "interface", "enum", "record", "method", "field"]).optional(),
         packagePrefix: nonEmptyString.optional(),
         fileGlob: nonEmptyString.optional(),
-        queryMode: z.enum(["auto", "token", "literal"]).optional()
+        queryMode: z.enum(["auto", "token", "literal"]).default("auto")
     })
 ]);
 const subjectSchema = z.discriminatedUnion("kind", [
@@ -87,7 +87,7 @@ const subjectSchema = z.discriminatedUnion("kind", [
         symbolKind: z.enum(["class", "interface", "enum", "record", "method", "field"]).optional(),
         packagePrefix: nonEmptyString.optional(),
         fileGlob: nonEmptyString.optional(),
-        queryMode: z.enum(["auto", "token", "literal"]).optional()
+        queryMode: z.enum(["auto", "token", "literal"]).default("auto")
     }),
     z.object({
         kind: z.literal("workspace"),
@@ -102,7 +102,7 @@ const subjectSchema = z.discriminatedUnion("kind", [
 export const inspectMinecraftShape = {
     task: z.enum(TASKS).optional(),
     subject: subjectSchema.optional(),
-    includeSnapshots: z.boolean().optional(),
+    includeSnapshots: z.boolean().default(false),
     detail: detailSchema.optional(),
     include: buildIncludeSchema(INCLUDE_GROUPS),
     limit: positiveIntSchema.optional(),
@@ -116,7 +116,7 @@ export const inspectMinecraftSchema = z.object(inspectMinecraftShape).superRefin
             message: "subject is required unless task=versions."
         });
     }
-    if (value.includeSnapshots !== undefined && value.task && value.task !== "versions") {
+    if (value.includeSnapshots && value.task && value.task !== "versions") {
         ctx.addIssue({
             code: z.ZodIssueCode.custom,
             path: ["includeSnapshots"],
@@ -260,6 +260,26 @@ export class InspectMinecraftService {
                 return "search";
         }
     }
+    summarizeRequestedSubject(subject) {
+        if (subject.kind === "search") {
+            if (subject.queryMode !== "auto") {
+                return subject;
+            }
+            const { queryMode: _queryMode, ...requestedSubject } = subject;
+            return requestedSubject;
+        }
+        if (subject.kind === "workspace" && subject.focus?.kind === "search") {
+            if (subject.focus.queryMode !== "auto") {
+                return subject;
+            }
+            const { queryMode: _queryMode, ...requestedFocus } = subject.focus;
+            return {
+                ...subject,
+                focus: requestedFocus
+            };
+        }
+        return subject;
+    }
     async resolveArtifactReference(subject) {
         if (subject.kind === "artifact") {
             return this.resolveArtifactRef(subject.artifact, subject);
@@ -341,6 +361,12 @@ export class InspectMinecraftService {
         const summary = {
             status: "ok",
             headline: `Found ${versions.totalAvailable} Minecraft versions.`,
+            subject: createSummarySubject({
+                task: "versions",
+                kind: "versions",
+                includeSnapshots: input.includeSnapshots === false ? undefined : input.includeSnapshots,
+                limit: input.limit
+            }),
             counts: {
                 releases: versions.releases.length,
                 snapshots: versions.snapshots?.length ?? 0
@@ -379,6 +405,10 @@ export class InspectMinecraftService {
             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",
@@ -408,6 +438,12 @@ export class InspectMinecraftService {
         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
             }
@@ -454,7 +490,12 @@ export class InspectMinecraftService {
         if (!artifact.artifactId) {
             const summary = {
                 status: "blocked",
-                headline: `Could not resolve artifact context for ${className}.`
+                headline: `Could not resolve artifact context for ${className}.`,
+                subject: createSummarySubject({
+                    task: "class-overview",
+                    requested: subject,
+                    className
+                })
             };
             return {
                 ...buildEntryToolResult({
@@ -480,7 +521,13 @@ export class InspectMinecraftService {
         if (matches.total === 0) {
             const summary = {
                 status: "not_found",
-                headline: `No class match was found for ${className}.`
+                headline: `No class match was found for ${className}.`,
+                subject: createSummarySubject({
+                    task: "class-overview",
+                    requested: subject,
+                    className,
+                    artifactId: artifact.artifactId
+                })
             };
             return {
                 ...buildEntryToolResult({
@@ -517,6 +564,12 @@ export class InspectMinecraftService {
             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
                 },
@@ -551,6 +604,12 @@ export class InspectMinecraftService {
         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
             },
@@ -625,6 +684,12 @@ export class InspectMinecraftService {
         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
             }
@@ -678,6 +743,12 @@ export class InspectMinecraftService {
         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 {
@@ -733,6 +804,8 @@ export class InspectMinecraftService {
             });
         }
         const searchSubject = subject.kind === "search" ? subject : this.requireWorkspaceSearchFocus(subject);
+        const requestedSubject = this.summarizeRequestedSubject(subject);
+        const queryMode = searchSubject.queryMode ?? "auto";
         const artifact = subject.kind === "search"
             ? await this.resolveArtifactReference(subject)
             : await this.resolveWorkspaceArtifactReference(subject, searchSubject.artifact);
@@ -741,7 +814,7 @@ export class InspectMinecraftService {
             query: searchSubject.query,
             intent: searchSubject.intent,
             match: searchSubject.match,
-            queryMode: searchSubject.queryMode,
+            queryMode,
             limit,
             cursor,
             scope: searchSubject.packagePrefix || searchSubject.fileGlob || searchSubject.symbolKind
@@ -753,14 +826,69 @@ export class InspectMinecraftService {
                 : undefined
         });
         const sampledHits = capArray(search.hits, 5);
+        const isAutoSeparatorMiss = search.hits.length === 0 &&
+            queryMode === "auto" &&
+            /[._$]/.test(searchSubject.query);
+        const literalRetrySubject = subject.kind === "search"
+            ? {
+                ...subject,
+                queryMode: "literal"
+            }
+            : {
+                ...subject,
+                focus: {
+                    ...searchSubject,
+                    kind: "search",
+                    queryMode: "literal"
+                }
+            };
         const summary = {
             status: search.hits.length > 0 ? "ok" : "not_found",
             headline: search.hits.length > 0
                 ? `Found ${search.hits.length} source hits for ${searchSubject.query}.`
                 : `No source hits were found for ${searchSubject.query}.`,
+            subject: createSummarySubject({
+                task: "search",
+                requested: requestedSubject,
+                query: searchSubject.query,
+                artifactId: artifact.artifactId
+            }),
             counts: {
                 hits: search.hits.length
-            }
+            },
+            nextActions: nextActionsOrUndefined([
+                ...(search.hits.length > 0
+                    ? [
+                        createNextAction("inspect-minecraft", {
+                            task: "file",
+                            subject: {
+                                kind: "file",
+                                filePath: search.hits[0].filePath,
+                                artifact: {
+                                    type: "resolved-id",
+                                    artifactId: artifact.artifactId
+                                }
+                            },
+                            include: ["source"]
+                        })
+                    ]
+                    : []),
+                ...(isAutoSeparatorMiss
+                    ? [
+                        createNextAction("inspect-minecraft", {
+                            task: "search",
+                            subject: literalRetrySubject
+                        })
+                    ]
+                    : [])
+            ]),
+            ...(isAutoSeparatorMiss
+                ? {
+                    notes: [
+                        "Separator query returned no indexed hits. Retry with queryMode=\"literal\" for an explicit full substring scan."
+                    ]
+                }
+                : {})
         };
         return {
             ...buildEntryToolResult({
@@ -770,7 +898,7 @@ export class InspectMinecraftService {
                 include,
                 blocks: {
                     subject: {
-                        requested: subject,
+                        requested: requestedSubject,
                         resolved: {
                             artifactId: artifact.artifactId
                         }
@@ -804,6 +932,12 @@ export class InspectMinecraftService {
         const summary = {
             status: "ok",
             headline: `Read ${file.filePath}.`,
+            subject: createSummarySubject({
+                task: "file",
+                requested: subject,
+                filePath: file.filePath,
+                artifactId: artifact.artifactId
+            }),
             counts: {
                 bytes: file.contentBytes
             }
@@ -845,9 +979,29 @@ export class InspectMinecraftService {
         const summary = {
             status: "ok",
             headline: `Listed ${files.items.length} files for ${artifact.artifactId}.`,
+            subject: createSummarySubject({
+                task: "list-files",
+                requested: subject,
+                artifactId: artifact.artifactId
+            }),
             counts: {
                 files: files.items.length
-            }
+            },
+            nextActions: nextActionsOrUndefined(files.items.length > 0
+                ? [
+                    createNextAction("inspect-minecraft", {
+                        task: "file",
+                        subject: {
+                            kind: "file",
+                            filePath: files.items[0],
+                            artifact: {
+                                type: "resolved-id",
+                                artifactId: artifact.artifactId
+                            }
+                        }
+                    })
+                ]
+                : [])
         };
         return {
             ...buildEntryToolResult({

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;