@githits/mcp 0.12.1 → 0.14.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/dist/client.d.ts +108 -5
- package/dist/client.js +1 -1
- package/dist/index.d.ts +108 -3
- package/dist/index.js +34 -30
- package/dist/shared/{chunk-8s2r83es.js → chunk-j0jr58yz.js} +2 -2
- package/dist/shared/chunk-zhq9qe0f.js +1507 -0
- package/dist/smoke-test.js +4 -4
- package/dist/tools.d.ts +1 -1
- package/dist/tools.js +1 -1
- package/package.json +1 -1
- package/dist/shared/chunk-p5xxvkdz.js +0 -1371
package/README.md
CHANGED
|
@@ -65,7 +65,7 @@ const tool = toCallableTool(createGetExampleTool(service));
|
|
|
65
65
|
|
|
66
66
|
`toCallableTool()` wraps the tool's Zod object schema, emits input-mode JSON
|
|
67
67
|
Schema, and validates/defaults input before calling the service. The omitted
|
|
68
|
-
`format` field remains optional in the schema and defaults to `"text
|
|
68
|
+
`format` field remains optional in the schema and defaults to `"text"`. The only format values are `"text"` and `"json"`.
|
|
69
69
|
Unknown object properties follow the normal Zod object behavior. Successful
|
|
70
70
|
and structured error results are returned as the serializable `ToolResult`
|
|
71
71
|
shape. If the caller supplies an `AbortSignal`, it is forwarded unchanged to
|
package/dist/client.d.ts
CHANGED
|
@@ -201,6 +201,10 @@ interface UnifiedSearchParams {
|
|
|
201
201
|
offset?: number;
|
|
202
202
|
waitTimeoutMs?: number;
|
|
203
203
|
}
|
|
204
|
+
interface UnifiedSearchReadOptions {
|
|
205
|
+
/** Omit compatibility navigation source when the caller renders only matched evidence. */
|
|
206
|
+
omitFocusedSource?: boolean;
|
|
207
|
+
}
|
|
204
208
|
interface UnifiedSearchEvidenceRange {
|
|
205
209
|
startLine: number;
|
|
206
210
|
endLine: number;
|
|
@@ -232,11 +236,77 @@ interface UnifiedSearchAssociatedSymbolContext extends UnifiedSearchSymbolContex
|
|
|
232
236
|
definitionRange?: UnifiedSearchDefinitionRange;
|
|
233
237
|
}
|
|
234
238
|
type UnifiedSearchSymbolContext = UnifiedSearchEnclosingSymbolContext | UnifiedSearchAssociatedSymbolContext;
|
|
239
|
+
interface UnifiedSearchSemanticPreferredRead {
|
|
240
|
+
targetLabel: string;
|
|
241
|
+
registry: string | null;
|
|
242
|
+
packageName: string | null;
|
|
243
|
+
version: string | null;
|
|
244
|
+
repoUrl: string;
|
|
245
|
+
gitRef: string;
|
|
246
|
+
commitSha: string;
|
|
247
|
+
requestedRef: string | null;
|
|
248
|
+
filePath: string;
|
|
249
|
+
repositoryFilePath: string;
|
|
250
|
+
startLine: number;
|
|
251
|
+
endLine: number;
|
|
252
|
+
}
|
|
253
|
+
interface UnifiedSearchSemanticScope {
|
|
254
|
+
name: string;
|
|
255
|
+
qualifiedPath: string;
|
|
256
|
+
kind: string;
|
|
257
|
+
parentQualifiedPath: string | null;
|
|
258
|
+
declarationStartLine: number;
|
|
259
|
+
declarationEndLine: number;
|
|
260
|
+
parameterNames: string[];
|
|
261
|
+
returnType: string | null;
|
|
262
|
+
symbolRef: string;
|
|
263
|
+
}
|
|
264
|
+
interface UnifiedSearchSemanticContext {
|
|
265
|
+
scopes: UnifiedSearchSemanticScope[];
|
|
266
|
+
scopeChainTruncated: boolean;
|
|
267
|
+
preferredRead: UnifiedSearchSemanticPreferredRead;
|
|
268
|
+
}
|
|
269
|
+
interface UnifiedSearchFocusedSourceLine {
|
|
270
|
+
lineNumber: number;
|
|
271
|
+
text: string;
|
|
272
|
+
highlights: Array<readonly [number, number]>;
|
|
273
|
+
prefixTruncated: boolean;
|
|
274
|
+
suffixTruncated: boolean;
|
|
275
|
+
}
|
|
276
|
+
interface UnifiedSearchFocusedSource {
|
|
277
|
+
startLine: number;
|
|
278
|
+
endLine: number;
|
|
279
|
+
matchLine: number | null;
|
|
280
|
+
rangeKind: string | null;
|
|
281
|
+
matchSpansTruncated: boolean;
|
|
282
|
+
lines: UnifiedSearchFocusedSourceLine[];
|
|
283
|
+
linesOmittedBefore: boolean;
|
|
284
|
+
linesOmittedAfter: boolean;
|
|
285
|
+
}
|
|
286
|
+
type UnifiedSearchBm25MatchField = "SYMBOL_NAME" | "FILE_PATH" | "DOCUMENTATION" | "SOURCE_IDENTIFIER";
|
|
287
|
+
/** Producer-proven focused source; independent of indexed-field provenance. */
|
|
288
|
+
interface UnifiedSearchMatchedSource extends Omit<UnifiedSearchFocusedSource, "rangeKind"> {
|
|
289
|
+
rangeKind: string;
|
|
290
|
+
}
|
|
291
|
+
/** Normalized crawled-page preview with zero-based, half-open grapheme ranges. */
|
|
292
|
+
interface UnifiedSearchDocumentationPreview {
|
|
293
|
+
text: string;
|
|
294
|
+
highlights: Array<readonly [number, number]>;
|
|
295
|
+
}
|
|
296
|
+
interface UnifiedSearchRepositoryEvidence {
|
|
297
|
+
focusedSource?: UnifiedSearchFocusedSource | null;
|
|
298
|
+
semanticContext: UnifiedSearchSemanticContext | null;
|
|
299
|
+
/** Complete positive-term field list; null means unknown, not no matches. */
|
|
300
|
+
bm25MatchFields?: UnifiedSearchBm25MatchField[] | null;
|
|
301
|
+
matchedSource?: UnifiedSearchMatchedSource | null;
|
|
302
|
+
}
|
|
235
303
|
interface UnifiedSearchLocator {
|
|
236
304
|
registry?: string;
|
|
237
305
|
packageName?: string;
|
|
238
306
|
version?: string;
|
|
239
307
|
pageId?: string;
|
|
308
|
+
/** Preferred docs_read target; absent on legacy discovery results. */
|
|
309
|
+
docsReadTarget?: string;
|
|
240
310
|
sourceKind?: string;
|
|
241
311
|
sourceUrl?: string;
|
|
242
312
|
repoUrl?: string;
|
|
@@ -268,6 +338,9 @@ interface UnifiedSearchHit {
|
|
|
268
338
|
title?: Array<readonly [number, number]>;
|
|
269
339
|
summary?: Array<readonly [number, number]>;
|
|
270
340
|
};
|
|
341
|
+
repositoryEvidence?: UnifiedSearchRepositoryEvidence | null;
|
|
342
|
+
documentationPreview?: UnifiedSearchDocumentationPreview | null;
|
|
343
|
+
contentSafety?: ContentSafety;
|
|
271
344
|
locator: UnifiedSearchLocator;
|
|
272
345
|
requestedTargetLabel?: string;
|
|
273
346
|
freshTargetLabel?: string;
|
|
@@ -668,8 +741,8 @@ interface GrepRepoResult {
|
|
|
668
741
|
targetResolution?: TargetResolution;
|
|
669
742
|
}
|
|
670
743
|
interface CodeNavigationService {
|
|
671
|
-
search(params: UnifiedSearchParams): Promise<UnifiedSearchOutcome>;
|
|
672
|
-
searchStatus(searchRef: string, waitTimeoutMs?: number): Promise<UnifiedSearchOutcome>;
|
|
744
|
+
search(params: UnifiedSearchParams, options?: UnifiedSearchReadOptions): Promise<UnifiedSearchOutcome>;
|
|
745
|
+
searchStatus(searchRef: string, waitTimeoutMs?: number, options?: UnifiedSearchReadOptions): Promise<UnifiedSearchOutcome>;
|
|
673
746
|
listFiles(params: ListFilesParams): Promise<ListFilesResult>;
|
|
674
747
|
readFile(params: ReadFileParams): Promise<ReadFileResult>;
|
|
675
748
|
grepRepo(params: GrepRepoParams): Promise<GrepRepoResult>;
|
|
@@ -699,8 +772,8 @@ declare class CodeNavigationServiceImpl implements CodeNavigationService, CodeDi
|
|
|
699
772
|
diagnostics?: ServiceDiagnostics;
|
|
700
773
|
});
|
|
701
774
|
private postGraphqlWithTargetResolutionFallback;
|
|
702
|
-
search(params: UnifiedSearchParams): Promise<UnifiedSearchOutcome>;
|
|
703
|
-
searchStatus(searchRef: string, waitTimeoutMs?: number): Promise<UnifiedSearchOutcome>;
|
|
775
|
+
search(params: UnifiedSearchParams, options?: UnifiedSearchReadOptions): Promise<UnifiedSearchOutcome>;
|
|
776
|
+
searchStatus(searchRef: string, waitTimeoutMs?: number, options?: UnifiedSearchReadOptions): Promise<UnifiedSearchOutcome>;
|
|
704
777
|
codeDiff(params: CodeDiffParams): Promise<CodeDiffResult>;
|
|
705
778
|
private executeCodeDiff;
|
|
706
779
|
private createCodeDiffRootError;
|
|
@@ -903,7 +976,11 @@ interface PackageVulnerabilitiesParams {
|
|
|
903
976
|
minSeverity?: number;
|
|
904
977
|
/** Optional — backend defaults to false when omitted. */
|
|
905
978
|
includeWithdrawn?: boolean;
|
|
906
|
-
/**
|
|
979
|
+
/** Optional — only true enables the extra graph-analysis request; omission/false preserve direct-only behavior. */
|
|
980
|
+
includeTransitive?: boolean;
|
|
981
|
+
/** Optional internal breadth for advisory-wide transitive detail fields. */
|
|
982
|
+
includeTransitiveAdvisoryDetails?: boolean;
|
|
983
|
+
/** Advisory rows to return for the root and opt-in transitive audit; direct counts always include all scopes. */
|
|
907
984
|
advisoryScope?: VulnerabilityScope;
|
|
908
985
|
}
|
|
909
986
|
type VulnerabilityScope = "AFFECTED" | "NON_AFFECTING" | "ALL";
|
|
@@ -944,6 +1021,25 @@ interface VulnerabilitySecurityDetails {
|
|
|
944
1021
|
interface VulnerabilityReport {
|
|
945
1022
|
package: PackageVersionIdentity;
|
|
946
1023
|
security?: VulnerabilitySecurityDetails;
|
|
1024
|
+
transitive?: TransitiveVulnerabilityAudit;
|
|
1025
|
+
}
|
|
1026
|
+
interface TransitiveVulnerabilityAudit {
|
|
1027
|
+
/** Advisory scope applied to dependency-package occurrences. */
|
|
1028
|
+
advisoryScope: VulnerabilityScope;
|
|
1029
|
+
/** Number of resolved package-version graph nodes checked. */
|
|
1030
|
+
totalPackagesAnalyzed: number;
|
|
1031
|
+
/** Number of dependency package rows with occurrences in the selected scope. */
|
|
1032
|
+
packageCount: number;
|
|
1033
|
+
/** Number of advisory occurrences across dependency rows in the selected scope. */
|
|
1034
|
+
occurrenceCount: number;
|
|
1035
|
+
calculatedAt?: string;
|
|
1036
|
+
packages: TransitiveVulnerabilityAuditPackage[];
|
|
1037
|
+
}
|
|
1038
|
+
interface TransitiveVulnerabilityAuditPackage {
|
|
1039
|
+
registry: string;
|
|
1040
|
+
name: string;
|
|
1041
|
+
occurrenceCount: number;
|
|
1042
|
+
occurrences: TransitiveDependencyVulnerability[];
|
|
947
1043
|
}
|
|
948
1044
|
interface PackageDependenciesParams {
|
|
949
1045
|
registry: PkgseerRegistry;
|
|
@@ -1409,6 +1505,8 @@ interface ReadPackageDocParams {
|
|
|
1409
1505
|
}
|
|
1410
1506
|
interface PackageDocPageSummary {
|
|
1411
1507
|
id?: string;
|
|
1508
|
+
/** Preferred read target emitted by the backend. */
|
|
1509
|
+
docsReadTarget: string;
|
|
1412
1510
|
title?: string;
|
|
1413
1511
|
slug?: string;
|
|
1414
1512
|
order?: number;
|
|
@@ -1440,6 +1538,8 @@ interface PackageDocSource {
|
|
|
1440
1538
|
}
|
|
1441
1539
|
interface PackageDocPage {
|
|
1442
1540
|
id?: string;
|
|
1541
|
+
/** Preferred read target emitted by the backend. */
|
|
1542
|
+
docsReadTarget: string;
|
|
1443
1543
|
title?: string;
|
|
1444
1544
|
content?: string;
|
|
1445
1545
|
contentFormat?: string;
|
|
@@ -1492,6 +1592,8 @@ declare class PackageIntelligenceServiceImpl implements PackageIntelligenceServi
|
|
|
1492
1592
|
private executePackageVulnerabilities;
|
|
1493
1593
|
private fetchPackageVulnerabilitiesPage;
|
|
1494
1594
|
private normaliseVulnerabilityReport;
|
|
1595
|
+
private fetchTransitiveVulnerabilityAudit;
|
|
1596
|
+
private normaliseTransitiveVulnerabilityAudit;
|
|
1495
1597
|
packageDependencies(params: PackageDependenciesParams): Promise<DependencyReport>;
|
|
1496
1598
|
packageUpgradeDependencyProbe(params: PackageUpgradeDependencyProbeParams): Promise<DependencyReport>;
|
|
1497
1599
|
packageUpgradeReview(params: PackageUpgradeReviewParams): Promise<PackageUpgradeReviewResponse>;
|
|
@@ -1501,6 +1603,7 @@ declare class PackageIntelligenceServiceImpl implements PackageIntelligenceServi
|
|
|
1501
1603
|
private normaliseDependencyReport;
|
|
1502
1604
|
private normaliseTransitiveVulnerabilitySummary;
|
|
1503
1605
|
private normaliseVulnerabilitySummaryDetail;
|
|
1606
|
+
private normaliseTransitiveAuditAdvisory;
|
|
1504
1607
|
private normaliseDependencyIssuesSummary;
|
|
1505
1608
|
packageChangelog(params: PackageChangelogParams): Promise<ChangelogReport>;
|
|
1506
1609
|
private executePackageChangelog;
|
package/dist/client.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{DEFAULT_MCP_URL2,DEFAULT_API_URL2,DEFAULT_CODE_NAV_URL2,getMcpUrl2,getApiUrl2,getCodeNavigationUrl2,getEnvApiToken2,GitHitsServiceImpl2,PKGSEER_REGISTRY_LIST2,toPkgseerRegistry2,toPkgseerRegistryLowercase2,CodeDiffError2,CodeNavigationServiceImpl2,PackageIntelligenceServiceImpl2,RefreshingGitHitsService2,createStaticTokenProvider2,createClientHeaderBuilder2}from"./shared/chunk-
|
|
1
|
+
import{DEFAULT_MCP_URL2,DEFAULT_API_URL2,DEFAULT_CODE_NAV_URL2,getMcpUrl2,getApiUrl2,getCodeNavigationUrl2,getEnvApiToken2,GitHitsServiceImpl2,PKGSEER_REGISTRY_LIST2,toPkgseerRegistry2,toPkgseerRegistryLowercase2,CodeDiffError2,CodeNavigationServiceImpl2,PackageIntelligenceServiceImpl2,RefreshingGitHitsService2,createStaticTokenProvider2,createClientHeaderBuilder2}from"./shared/chunk-zhq9qe0f.js";export{CodeDiffError2 as CodeDiffError,CodeNavigationServiceImpl2 as CodeNavigationServiceImpl,DEFAULT_API_URL2 as DEFAULT_API_URL,DEFAULT_CODE_NAV_URL2 as DEFAULT_CODE_NAV_URL,DEFAULT_MCP_URL2 as DEFAULT_MCP_URL,GitHitsServiceImpl2 as GitHitsServiceImpl,PKGSEER_REGISTRY_LIST2 as PKGSEER_REGISTRY_LIST,PackageIntelligenceServiceImpl2 as PackageIntelligenceServiceImpl,RefreshingGitHitsService2 as RefreshingGitHitsService,createClientHeaderBuilder2 as createClientHeaderBuilder,createStaticTokenProvider2 as createStaticTokenProvider,getApiUrl2 as getApiUrl,getCodeNavigationUrl2 as getCodeNavigationUrl,getEnvApiToken2 as getEnvApiToken,getMcpUrl2 as getMcpUrl,toPkgseerRegistry2 as toPkgseerRegistry,toPkgseerRegistryLowercase2 as toPkgseerRegistryLowercase};
|
package/dist/index.d.ts
CHANGED
|
@@ -149,6 +149,10 @@ interface UnifiedSearchParams {
|
|
|
149
149
|
offset?: number;
|
|
150
150
|
waitTimeoutMs?: number;
|
|
151
151
|
}
|
|
152
|
+
interface UnifiedSearchReadOptions {
|
|
153
|
+
/** Omit compatibility navigation source when the caller renders only matched evidence. */
|
|
154
|
+
omitFocusedSource?: boolean;
|
|
155
|
+
}
|
|
152
156
|
interface UnifiedSearchEvidenceRange {
|
|
153
157
|
startLine: number;
|
|
154
158
|
endLine: number;
|
|
@@ -180,11 +184,77 @@ interface UnifiedSearchAssociatedSymbolContext extends UnifiedSearchSymbolContex
|
|
|
180
184
|
definitionRange?: UnifiedSearchDefinitionRange;
|
|
181
185
|
}
|
|
182
186
|
type UnifiedSearchSymbolContext = UnifiedSearchEnclosingSymbolContext | UnifiedSearchAssociatedSymbolContext;
|
|
187
|
+
interface UnifiedSearchSemanticPreferredRead {
|
|
188
|
+
targetLabel: string;
|
|
189
|
+
registry: string | null;
|
|
190
|
+
packageName: string | null;
|
|
191
|
+
version: string | null;
|
|
192
|
+
repoUrl: string;
|
|
193
|
+
gitRef: string;
|
|
194
|
+
commitSha: string;
|
|
195
|
+
requestedRef: string | null;
|
|
196
|
+
filePath: string;
|
|
197
|
+
repositoryFilePath: string;
|
|
198
|
+
startLine: number;
|
|
199
|
+
endLine: number;
|
|
200
|
+
}
|
|
201
|
+
interface UnifiedSearchSemanticScope {
|
|
202
|
+
name: string;
|
|
203
|
+
qualifiedPath: string;
|
|
204
|
+
kind: string;
|
|
205
|
+
parentQualifiedPath: string | null;
|
|
206
|
+
declarationStartLine: number;
|
|
207
|
+
declarationEndLine: number;
|
|
208
|
+
parameterNames: string[];
|
|
209
|
+
returnType: string | null;
|
|
210
|
+
symbolRef: string;
|
|
211
|
+
}
|
|
212
|
+
interface UnifiedSearchSemanticContext {
|
|
213
|
+
scopes: UnifiedSearchSemanticScope[];
|
|
214
|
+
scopeChainTruncated: boolean;
|
|
215
|
+
preferredRead: UnifiedSearchSemanticPreferredRead;
|
|
216
|
+
}
|
|
217
|
+
interface UnifiedSearchFocusedSourceLine {
|
|
218
|
+
lineNumber: number;
|
|
219
|
+
text: string;
|
|
220
|
+
highlights: Array<readonly [number, number]>;
|
|
221
|
+
prefixTruncated: boolean;
|
|
222
|
+
suffixTruncated: boolean;
|
|
223
|
+
}
|
|
224
|
+
interface UnifiedSearchFocusedSource {
|
|
225
|
+
startLine: number;
|
|
226
|
+
endLine: number;
|
|
227
|
+
matchLine: number | null;
|
|
228
|
+
rangeKind: string | null;
|
|
229
|
+
matchSpansTruncated: boolean;
|
|
230
|
+
lines: UnifiedSearchFocusedSourceLine[];
|
|
231
|
+
linesOmittedBefore: boolean;
|
|
232
|
+
linesOmittedAfter: boolean;
|
|
233
|
+
}
|
|
234
|
+
type UnifiedSearchBm25MatchField = "SYMBOL_NAME" | "FILE_PATH" | "DOCUMENTATION" | "SOURCE_IDENTIFIER";
|
|
235
|
+
/** Producer-proven focused source; independent of indexed-field provenance. */
|
|
236
|
+
interface UnifiedSearchMatchedSource extends Omit<UnifiedSearchFocusedSource, "rangeKind"> {
|
|
237
|
+
rangeKind: string;
|
|
238
|
+
}
|
|
239
|
+
/** Normalized crawled-page preview with zero-based, half-open grapheme ranges. */
|
|
240
|
+
interface UnifiedSearchDocumentationPreview {
|
|
241
|
+
text: string;
|
|
242
|
+
highlights: Array<readonly [number, number]>;
|
|
243
|
+
}
|
|
244
|
+
interface UnifiedSearchRepositoryEvidence {
|
|
245
|
+
focusedSource?: UnifiedSearchFocusedSource | null;
|
|
246
|
+
semanticContext: UnifiedSearchSemanticContext | null;
|
|
247
|
+
/** Complete positive-term field list; null means unknown, not no matches. */
|
|
248
|
+
bm25MatchFields?: UnifiedSearchBm25MatchField[] | null;
|
|
249
|
+
matchedSource?: UnifiedSearchMatchedSource | null;
|
|
250
|
+
}
|
|
183
251
|
interface UnifiedSearchLocator {
|
|
184
252
|
registry?: string;
|
|
185
253
|
packageName?: string;
|
|
186
254
|
version?: string;
|
|
187
255
|
pageId?: string;
|
|
256
|
+
/** Preferred docs_read target; absent on legacy discovery results. */
|
|
257
|
+
docsReadTarget?: string;
|
|
188
258
|
sourceKind?: string;
|
|
189
259
|
sourceUrl?: string;
|
|
190
260
|
repoUrl?: string;
|
|
@@ -216,6 +286,9 @@ interface UnifiedSearchHit {
|
|
|
216
286
|
title?: Array<readonly [number, number]>;
|
|
217
287
|
summary?: Array<readonly [number, number]>;
|
|
218
288
|
};
|
|
289
|
+
repositoryEvidence?: UnifiedSearchRepositoryEvidence | null;
|
|
290
|
+
documentationPreview?: UnifiedSearchDocumentationPreview | null;
|
|
291
|
+
contentSafety?: ContentSafety;
|
|
219
292
|
locator: UnifiedSearchLocator;
|
|
220
293
|
requestedTargetLabel?: string;
|
|
221
294
|
freshTargetLabel?: string;
|
|
@@ -389,6 +462,11 @@ interface ReadFileResult {
|
|
|
389
462
|
targetResolution?: TargetResolution;
|
|
390
463
|
availableVersions?: AvailableVersion[];
|
|
391
464
|
}
|
|
465
|
+
type ContentModification = "INVISIBLE_CONTROLS_STRIPPED" | "HTML_COMMENTS_STRIPPED" | "IMAGES_REPLACED" | "UNSAFE_LINKS_NEUTRALIZED";
|
|
466
|
+
interface ContentSafety {
|
|
467
|
+
filtered: boolean;
|
|
468
|
+
modifications: ContentModification[];
|
|
469
|
+
}
|
|
392
470
|
type GrepRepoPatternType = "LITERAL" | "REGEX";
|
|
393
471
|
type GrepPathSelectorKind = "EXACT" | "PREFIX" | "GLOB";
|
|
394
472
|
interface GrepRepoPathSelector {
|
|
@@ -462,8 +540,8 @@ interface GrepRepoResult {
|
|
|
462
540
|
targetResolution?: TargetResolution;
|
|
463
541
|
}
|
|
464
542
|
interface CodeNavigationService {
|
|
465
|
-
search(params: UnifiedSearchParams): Promise<UnifiedSearchOutcome>;
|
|
466
|
-
searchStatus(searchRef: string, waitTimeoutMs?: number): Promise<UnifiedSearchOutcome>;
|
|
543
|
+
search(params: UnifiedSearchParams, options?: UnifiedSearchReadOptions): Promise<UnifiedSearchOutcome>;
|
|
544
|
+
searchStatus(searchRef: string, waitTimeoutMs?: number, options?: UnifiedSearchReadOptions): Promise<UnifiedSearchOutcome>;
|
|
467
545
|
listFiles(params: ListFilesParams): Promise<ListFilesResult>;
|
|
468
546
|
readFile(params: ReadFileParams): Promise<ReadFileResult>;
|
|
469
547
|
grepRepo(params: GrepRepoParams): Promise<GrepRepoResult>;
|
|
@@ -587,7 +665,11 @@ interface PackageVulnerabilitiesParams {
|
|
|
587
665
|
minSeverity?: number;
|
|
588
666
|
/** Optional — backend defaults to false when omitted. */
|
|
589
667
|
includeWithdrawn?: boolean;
|
|
590
|
-
/**
|
|
668
|
+
/** Optional — only true enables the extra graph-analysis request; omission/false preserve direct-only behavior. */
|
|
669
|
+
includeTransitive?: boolean;
|
|
670
|
+
/** Optional internal breadth for advisory-wide transitive detail fields. */
|
|
671
|
+
includeTransitiveAdvisoryDetails?: boolean;
|
|
672
|
+
/** Advisory rows to return for the root and opt-in transitive audit; direct counts always include all scopes. */
|
|
591
673
|
advisoryScope?: VulnerabilityScope;
|
|
592
674
|
}
|
|
593
675
|
type VulnerabilityScope = "AFFECTED" | "NON_AFFECTING" | "ALL";
|
|
@@ -628,6 +710,25 @@ interface VulnerabilitySecurityDetails {
|
|
|
628
710
|
interface VulnerabilityReport {
|
|
629
711
|
package: PackageVersionIdentity;
|
|
630
712
|
security?: VulnerabilitySecurityDetails;
|
|
713
|
+
transitive?: TransitiveVulnerabilityAudit;
|
|
714
|
+
}
|
|
715
|
+
interface TransitiveVulnerabilityAudit {
|
|
716
|
+
/** Advisory scope applied to dependency-package occurrences. */
|
|
717
|
+
advisoryScope: VulnerabilityScope;
|
|
718
|
+
/** Number of resolved package-version graph nodes checked. */
|
|
719
|
+
totalPackagesAnalyzed: number;
|
|
720
|
+
/** Number of dependency package rows with occurrences in the selected scope. */
|
|
721
|
+
packageCount: number;
|
|
722
|
+
/** Number of advisory occurrences across dependency rows in the selected scope. */
|
|
723
|
+
occurrenceCount: number;
|
|
724
|
+
calculatedAt?: string;
|
|
725
|
+
packages: TransitiveVulnerabilityAuditPackage[];
|
|
726
|
+
}
|
|
727
|
+
interface TransitiveVulnerabilityAuditPackage {
|
|
728
|
+
registry: string;
|
|
729
|
+
name: string;
|
|
730
|
+
occurrenceCount: number;
|
|
731
|
+
occurrences: TransitiveDependencyVulnerability[];
|
|
631
732
|
}
|
|
632
733
|
interface PackageDependenciesParams {
|
|
633
734
|
registry: PkgseerRegistry;
|
|
@@ -1093,6 +1194,8 @@ interface ReadPackageDocParams {
|
|
|
1093
1194
|
}
|
|
1094
1195
|
interface PackageDocPageSummary {
|
|
1095
1196
|
id?: string;
|
|
1197
|
+
/** Preferred read target emitted by the backend. */
|
|
1198
|
+
docsReadTarget: string;
|
|
1096
1199
|
title?: string;
|
|
1097
1200
|
slug?: string;
|
|
1098
1201
|
order?: number;
|
|
@@ -1124,6 +1227,8 @@ interface PackageDocSource {
|
|
|
1124
1227
|
}
|
|
1125
1228
|
interface PackageDocPage {
|
|
1126
1229
|
id?: string;
|
|
1230
|
+
/** Preferred read target emitted by the backend. */
|
|
1231
|
+
docsReadTarget: string;
|
|
1127
1232
|
title?: string;
|
|
1128
1233
|
content?: string;
|
|
1129
1234
|
contentFormat?: string;
|