@adhisang/minecraft-modding-mcp 1.2.1 → 2.1.0

package/dist/source-service.d.ts

@@ -1,5 +1,5 @@
 import { type ResponseContext as ExplorerResponseContext, type SignatureMember } from "./minecraft-explorer-service.js";
-import { type MixinValidationResult, type MappingHealthReport, type AccessWidenerValidationResult } from "./mixin-validator.js";
+import { type MixinValidationResult, type MixinValidationProvenance, type MappingHealthReport, type AccessWidenerValidationResult } from "./mixin-validator.js";
 import { type ClassApiMatrixInput as MappingClassApiMatrixInput, type ClassApiMatrixOutput as MappingClassApiMatrixOutput, type FindMappingInput as MappingFindMappingInput, type FindMappingOutput as MappingFindMappingOutput, type ResolveMethodMappingExactInput as MappingResolveMethodMappingExactInput, type ResolveMethodMappingExactOutput as MappingResolveMethodMappingExactOutput, type SymbolResolutionOutput as MappingSymbolResolutionOutput, type SymbolExistenceInput as MappingSymbolExistenceInput, type SymbolExistenceOutput as MappingSymbolExistenceOutput } from "./mapping-service.js";
 import { RuntimeMetrics, type RuntimeMetricSnapshot } from "./observability.js";
 import { type WorkspaceCompileMappingOutput } from "./workspace-mapping-service.js";
@@ -33,9 +33,16 @@ export type ResolveArtifactOutput = {
     provenance: ArtifactProvenance;
     qualityFlags: string[];
     repoUrl?: string;
+    artifactContents: ArtifactContentsSummary;
     warnings: string[];
     sampleEntries?: string[];
 };
+export type ArtifactContentsSummary = {
+    sourceKind: "source-jar" | "decompiled-binary";
+    indexedContentKinds: string[];
+    resourcesIncluded: boolean;
+    sourceCoverage: "full" | "partial";
+};
 type SymbolKind = "class" | "interface" | "enum" | "record" | "method" | "field";
 type SearchIntent = "symbol" | "text" | "path";
 type SearchMatch = "exact" | "prefix" | "contains" | "regex";
@@ -44,11 +51,6 @@ export type SearchScope = {
     fileGlob?: string;
     symbolKind?: SymbolKind;
 };
-export type SearchInclude = {
-    snippetLines?: number;
-    includeDefinition?: boolean;
-    includeOneHop?: boolean;
-};
 export type SearchResultSymbol = {
     symbolKind: SymbolKind;
     symbolName: string;
@@ -59,27 +61,9 @@ export type SearchSourceHit = {
     filePath: string;
     score: number;
     matchedIn: "symbol" | "path" | "content";
-    startLine: number;
-    endLine: number;
-    snippet: string;
     reasonCodes: string[];
     symbol?: SearchResultSymbol;
 };
-export type SearchRelation = {
-    fromSymbol: {
-        symbolKind: SymbolKind;
-        symbolName: string;
-        filePath: string;
-        line: number;
-    };
-    toSymbol: {
-        symbolKind: SymbolKind;
-        symbolName: string;
-        filePath: string;
-        line: number;
-    };
-    relation: "calls" | "uses-type" | "imports";
-};
 export type QueryMode = "auto" | "token" | "literal";
 export type SearchClassSourceInput = {
     artifactId: string;
@@ -87,17 +71,16 @@ export type SearchClassSourceInput = {
     intent?: SearchIntent;
     match?: SearchMatch;
     scope?: SearchScope;
-    include?: SearchInclude;
     queryMode?: QueryMode;
     limit?: number;
     cursor?: string;
 };
 export type SearchClassSourceOutput = {
     hits: SearchSourceHit[];
-    relations?: SearchRelation[];
     nextCursor?: string;
-    totalApprox: number;
     mappingApplied: SourceMapping;
+    returnedNamespace: SourceMapping;
+    artifactContents: ArtifactContentsSummary;
 };
 export type GetArtifactFileInput = {
     artifactId: string;
@@ -110,6 +93,8 @@ export type GetArtifactFileOutput = {
     contentBytes: number;
     truncated: boolean;
     mappingApplied: SourceMapping;
+    returnedNamespace: SourceMapping;
+    artifactContents: ArtifactContentsSummary;
 };
 export type ListArtifactFilesInput = {
     artifactId: string;
@@ -121,6 +106,8 @@ export type ListArtifactFilesOutput = {
     items: string[];
     nextCursor?: string;
     mappingApplied: SourceMapping;
+    artifactContents: ArtifactContentsSummary;
+    warnings: string[];
 };
 export type FindMappingInput = MappingFindMappingInput;
 export type FindMappingOutput = MappingFindMappingOutput;
@@ -140,6 +127,7 @@ export type ResolveWorkspaceSymbolInput = {
     descriptor?: string;
     sourceMapping: SourceMapping;
     sourcePriority?: MappingSourcePriority;
+    maxCandidates?: number;
 };
 export type ResolveWorkspaceSymbolOutput = MappingSymbolResolutionOutput & {
     workspaceDetection: WorkspaceCompileMappingOutput;
@@ -178,8 +166,10 @@ export type GetClassSourceOutput = {
     artifactId: string;
     requestedMapping: SourceMapping;
     mappingApplied: SourceMapping;
+    returnedNamespace: SourceMapping;
     provenance: ArtifactProvenance;
     qualityFlags: string[];
+    artifactContents: ArtifactContentsSummary;
     outputFile?: string;
     warnings: string[];
 };
@@ -236,8 +226,10 @@ export type GetClassMembersOutput = {
     artifactId: string;
     requestedMapping: SourceMapping;
     mappingApplied: SourceMapping;
+    returnedNamespace: SourceMapping;
     provenance: ArtifactProvenance;
     qualityFlags: string[];
+    artifactContents: ArtifactContentsSummary;
     warnings: string[];
 };
 export type TraceSymbolLifecycleInput = {
@@ -282,9 +274,9 @@ type DiffMemberChangedField = "accessFlags" | "isSynthetic" | "javaSignature" |
 export type DiffMember = SignatureMember;
 export type DiffMemberChange = {
     key: string;
-    from: DiffMember;
-    to: DiffMember;
     changed: DiffMemberChangedField[];
+    from?: DiffMember;
+    to?: DiffMember;
 };
 export type DiffClassMemberDelta = {
     added: DiffMember[];
@@ -297,6 +289,7 @@ export type DiffClassSignaturesInput = {
     toVersion: string;
     mapping?: SourceMapping;
     sourcePriority?: MappingSourcePriority;
+    includeFullDiff?: boolean;
 };
 export type DiffClassSignaturesOutput = {
     query: {
@@ -356,11 +349,22 @@ export type IndexArtifactOutput = {
     mappingApplied: SourceMapping;
 };
 export type ValidateMixinInput = {
-    source?: string;
-    sourcePath?: string;
-    sourcePaths?: string[];
-    mixinConfigPath?: string | string[];
-    sourceRoot?: string;
+    input: {
+        mode: "inline";
+        source: string;
+    } | {
+        mode: "path";
+        path: string;
+    } | {
+        mode: "paths";
+        paths: string[];
+    } | {
+        mode: "config";
+        configPaths: string[];
+    } | {
+        mode: "project";
+        path: string;
+    };
     sourceRoots?: string[];
     version: string;
     mapping?: SourceMapping;
@@ -373,12 +377,19 @@ export type ValidateMixinInput = {
     explain?: boolean;
     warningMode?: "full" | "aggregated";
     preferProjectMapping?: boolean;
-    reportMode?: "compact" | "full";
+    reportMode?: "compact" | "full" | "summary-first";
     warningCategoryFilter?: ("mapping" | "configuration" | "validation" | "resolution" | "parse")[];
     treatInfoAsWarning?: boolean;
+    includeIssues?: boolean;
+};
+export type ValidateMixinResultSource = {
+    kind: "inline" | "path" | "config";
+    label: string;
+    path?: string;
+    configPath?: string;
 };
 export type ValidateMixinBatchResult = {
-    sourcePath: string;
+    source: ValidateMixinResultSource;
     result?: MixinValidationResult;
     error?: string;
 };
@@ -389,23 +400,25 @@ export type ValidateMixinBatchIssueSummaryItem = {
     count: number;
     sampleTargets: string[];
 };
-export type ValidateMixinBatchOutput = {
+export type ValidateMixinOutput = {
+    mode: ValidateMixinInput["input"]["mode"];
     results: ValidateMixinBatchResult[];
     summary: {
         total: number;
         valid: number;
+        partial: number;
         invalid: number;
-        /** @deprecated Use processingErrors instead */
-        errors: number;
         processingErrors: number;
         totalValidationErrors: number;
         totalValidationWarnings: number;
-        confidenceScore?: number;
     };
     issueSummary?: ValidateMixinBatchIssueSummaryItem[];
+    provenance?: MixinValidationProvenance;
+    incompleteReasons?: string[];
     toolHealth?: MappingHealthReport;
+    confidenceScore?: number;
+    warnings: string[];
 };
-export type ValidateMixinOutput = MixinValidationResult | ValidateMixinBatchOutput;
 export type ValidateAccessWidenerInput = {
     content: string;
     version: string;
@@ -429,9 +442,13 @@ export declare class SourceService {
     private readonly versionDiffService;
     private readonly modDecompileService;
     private readonly modSearchService;
+    private cacheMetricsState;
     constructor(explicitConfig?: Config, metrics?: RuntimeMetrics);
     private discoverVersionSourceJar;
     private buildVersionSourceRecoveryCommand;
+    private buildArtifactContentsSummary;
+    private inferVersionFromContext;
+    private resolveVersionContext;
     resolveArtifact(input: ResolveArtifactInput): Promise<ResolveArtifactOutput>;
     searchClassSource(input: SearchClassSourceInput): Promise<SearchClassSourceOutput>;
     getArtifactFile(input: GetArtifactFileInput): Promise<GetArtifactFileOutput>;
@@ -453,7 +470,15 @@ export declare class SourceService {
     getClassSource(input: GetClassSourceInput): Promise<GetClassSourceOutput>;
     getClassMembers(input: GetClassMembersInput): Promise<GetClassMembersOutput>;
     validateMixin(input: ValidateMixinInput): Promise<ValidateMixinOutput>;
-    private validateMixinBatch;
+    private createProjectValidateMixinConfigInput;
+    private shouldRetryValidateMixinWithMavenFirst;
+    private findValidateMixinClassMapping;
+    private validateMixinSingle;
+    private resolveMixinInputPath;
+    private resolveMixinConfigSources;
+    private validateMixinMany;
+    private applyValidateMixinOutputCompaction;
+    private buildValidateMixinOutput;
     validateAccessWidener(input: ValidateAccessWidenerInput): Promise<ValidateAccessWidenerOutput>;
     getRuntimeMetrics(): RuntimeMetricSnapshot;
     indexArtifact(input: IndexArtifactInput): Promise<IndexArtifactOutput>;
@@ -468,13 +493,13 @@ export declare class SourceService {
     private indexedCandidateLimitForMatch;
     private extractClassMetadata;
     private resolveClassFilePath;
-    private findNearestSymbolForLine;
-    private findNearestSymbolFromList;
-    private buildOneHopRelations;
+    private resolveBinaryFallbackArtifact;
     private buildProvenance;
     private buildFallbackProvenance;
-    private resolveToOfficialClassName;
-    private resolveToOfficialMemberName;
+    private resolveClassNameForLookup;
+    private buildClassSourceNotFoundError;
+    private resolveToObfuscatedClassName;
+    private resolveToObfuscatedMemberName;
     private remapSignatureMembers;
     private fallbackArtifactSignature;
     private resolveIndexRebuildReason;
@@ -487,5 +512,9 @@ export declare class SourceService {
     private hasAnyFiles;
     private enforceCacheLimits;
     private refreshCacheMetrics;
+    private touchCacheMetrics;
+    private upsertCacheMetrics;
+    private removeCacheMetrics;
+    private publishCacheMetrics;
 }
 export {};