@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 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-v1"`.
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
- /** Advisory rows to return; counts always include all scopes. */
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-p5xxvkdz.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};
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
- /** Advisory rows to return; counts always include all scopes. */
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;