@githits/mcp 0.30.0 → 0.31.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
@@ -18,6 +18,28 @@ update and deployment rather than through a parallel implementation.
18
18
  > filesystem access, authentication implementation or storage, configuration
19
19
  > discovery, or any other host behavior.
20
20
 
21
+ ## Stable Research
22
+
23
+ The public inventory includes `research` by default. It answers one question
24
+ about a public package or repository with a verified, source-cited answer, can
25
+ identify the target from the question, and continues threads by `thread_id`.
26
+ Answers can take a few minutes; `AgenticAskServiceImpl` applies a 210-second
27
+ deadline (`AGENTIC_ASK_REQUEST_TIMEOUT_MS`) and honors the MCP request's abort
28
+ signal. Hosts should keep their request and MCP client timeouts above that
29
+ deadline, or pass a lower `timeoutMs`.
30
+
31
+ Providers must now supply `agenticAskService: AgenticAskService`. Import
32
+ `AgenticAskServiceImpl` and its request/response/runtime contracts from
33
+ `@githits/mcp/client`; construct it with the GitHits REST API base (the same
34
+ `apiUrl` used by `GitHitsServiceImpl`), the request's token provider, and the
35
+ request's client headers and user agent. The browser-callable factory
36
+ `createResearchTool` and `ResearchMcpArgs` are exported from
37
+ `@githits/mcp/tools`. Rate limits map to `RATE_LIMITED`: the short-term limit
38
+ is retryable after `retryAfterSeconds`, while the daily limit sets
39
+ `details.rateLimitScope: "daily"` and is not retryable before 00:00 UTC. Hosted
40
+ MCP must adopt and deploy the released package before its clients receive the
41
+ tool.
42
+
21
43
  ## Stable Target Resolution
22
44
 
23
45
  The public inventory includes `resolve_target` by default. It ranks fuzzy public
package/dist/client.d.ts CHANGED
@@ -56,6 +56,54 @@ interface TokenProvider {
56
56
  forceRefresh(): Promise<string | undefined>;
57
57
  }
58
58
  declare function createStaticTokenProvider(token: string): TokenProvider;
59
+ declare const AGENTIC_ASK_REQUEST_TIMEOUT_MS = 21e4;
60
+ interface AgenticAskQuestion {
61
+ question: string;
62
+ }
63
+ type AgenticAskSubject = {
64
+ target?: string;
65
+ threadId?: never;
66
+ } | {
67
+ target?: never;
68
+ threadId: string;
69
+ };
70
+ type AgenticAskRequest = AgenticAskQuestion & AgenticAskSubject & {
71
+ sourceFormat?: "cli" | "mcp" | "url";
72
+ };
73
+ interface AgenticAskRequestOptions {
74
+ signal?: AbortSignal;
75
+ }
76
+ /** Expected backend envelope; successful JSON is deliberately not runtime-validated. */
77
+ interface AgenticAskResponse {
78
+ display_markdown: string;
79
+ tool_call_id?: string;
80
+ thread_id?: string;
81
+ [key: string]: unknown;
82
+ }
83
+ interface AgenticAskService {
84
+ ask(request: AgenticAskRequest, options?: AgenticAskRequestOptions): Promise<AgenticAskResponse>;
85
+ }
86
+ /**
87
+ * Which Research limit rejected a 429 request: the short-term request rate or
88
+ * the daily limit, which resets at 00:00 UTC.
89
+ */
90
+ type AgenticAskRateLimitScope = "request" | "daily";
91
+ interface AgenticAskServiceRuntimeOptions {
92
+ clientHeaders?: ClientHeaderBuilder;
93
+ userAgent?: string;
94
+ timeoutMs?: number;
95
+ diagnostics?: ServiceDiagnostics;
96
+ }
97
+ declare class AgenticAskServiceImpl implements AgenticAskService {
98
+ private readonly apiUrl;
99
+ private readonly tokenProvider;
100
+ private readonly fetchFn;
101
+ private readonly runtime;
102
+ constructor(apiUrl: string, tokenProvider: TokenProvider, fetchFn?: typeof fetch, runtime?: AgenticAskServiceRuntimeOptions);
103
+ ask(request: AgenticAskRequest, options?: AgenticAskRequestOptions): Promise<AgenticAskResponse>;
104
+ private askRequest;
105
+ private executeAsk;
106
+ }
59
107
  /**
60
108
  * Registry taxonomy shared by code-navigation and package-intelligence
61
109
  * services. Single source of truth for:
@@ -120,6 +168,29 @@ interface ReadTarget {
120
168
  startLine?: number;
121
169
  endLine?: number;
122
170
  }
171
+ /** Nullable registry-version association carried by public error inventories. */
172
+ interface RecoveryRef {
173
+ ref: string;
174
+ version?: string | null;
175
+ }
176
+ /** Public recovery facts; registry releases and indexed snapshots stay distinct. */
177
+ interface VersionRefRecovery {
178
+ code: "VERSION_NOT_FOUND" | "REF_NOT_FOUND";
179
+ retryable?: boolean;
180
+ package?: string;
181
+ requestedVersion?: string;
182
+ requestedRef?: string;
183
+ repoUrl?: string;
184
+ latestVersion?: string;
185
+ latestIndexed?: string;
186
+ availablePackageVersions?: string[];
187
+ availableVersions?: RecoveryRef[];
188
+ availableRefs?: RecoveryRef[];
189
+ suggestedRefs?: RecoveryRef[];
190
+ inputPath?: (string | number)[];
191
+ targetIndex?: number;
192
+ targetCount?: number;
193
+ }
123
194
  /**
124
195
  * Back-compat alias — the canonical registry union now lives in
125
196
  * `src/shared/pkgseer-registry.ts`. Re-exported here so existing
@@ -1221,7 +1292,8 @@ declare class ListGraphQLError extends Error {
1221
1292
  readonly indexingRef?: string | undefined;
1222
1293
  readonly hint?: string | undefined;
1223
1294
  readonly indexingMetadata: ListIndexingErrorMetadata | undefined;
1224
- constructor(message: string, code?: string | undefined, retryable?: boolean | undefined, repoUrl?: string | undefined, commitSha?: string | undefined, indexingRef?: string | undefined, hint?: string | undefined, indexingMetadata?: ListIndexingErrorMetadata | undefined);
1295
+ readonly recovery: VersionRefRecovery | undefined;
1296
+ constructor(message: string, code?: string | undefined, retryable?: boolean | undefined, repoUrl?: string | undefined, commitSha?: string | undefined, indexingRef?: string | undefined, hint?: string | undefined, indexingMetadata?: ListIndexingErrorMetadata | undefined, recovery?: VersionRefRecovery | undefined);
1225
1297
  }
1226
1298
  declare class ListBackendError extends Error {
1227
1299
  readonly status?: number | undefined;
@@ -1312,10 +1384,10 @@ interface PackageVulnerabilitiesParams {
1312
1384
  includeTransitive?: boolean;
1313
1385
  /** Optional internal breadth for advisory-wide transitive detail fields. */
1314
1386
  includeTransitiveAdvisoryDetails?: boolean;
1315
- /** Advisory rows to return for the root and opt-in transitive audit; direct counts always include all scopes. */
1387
+ /** Advisory rows to return. Summary counts always include all scopes. */
1316
1388
  advisoryScope?: VulnerabilityScope;
1317
1389
  }
1318
- type VulnerabilityScope = "AFFECTED" | "NON_AFFECTING" | "ALL";
1390
+ type VulnerabilityScope = "AFFECTED" | "NON_AFFECTING" | "UNKNOWN" | "ALL";
1319
1391
  interface PackageVersionIdentity {
1320
1392
  name: string;
1321
1393
  registry?: string;
@@ -1339,10 +1411,14 @@ interface VulnerabilityDetail {
1339
1411
  aliases?: string[];
1340
1412
  isMalicious?: boolean;
1341
1413
  affectsInspectedVersion?: boolean;
1414
+ assessmentStatus?: string;
1415
+ assessmentReasons?: string[];
1342
1416
  matchedAffectedVersionRanges?: string[];
1343
1417
  duplicateIds?: string[];
1344
1418
  }
1345
1419
  interface VulnerabilitySecurityDetails {
1420
+ unknownVulnerabilityCount?: number;
1421
+ assessmentStatus?: string;
1346
1422
  affectedVulnerabilityCount: number;
1347
1423
  nonAffectingVulnerabilityCount: number;
1348
1424
  allVulnerabilityCount: number;
@@ -1355,7 +1431,13 @@ interface VulnerabilityReport {
1355
1431
  security?: VulnerabilitySecurityDetails;
1356
1432
  transitive?: TransitiveVulnerabilityAudit;
1357
1433
  }
1358
- interface TransitiveVulnerabilityAudit {
1434
+ interface TransitiveVulnerabilityAuditCounts {
1435
+ affectedCount: number;
1436
+ nonAffectingCount: number;
1437
+ unknownCount: number;
1438
+ totalCount: number;
1439
+ }
1440
+ interface TransitiveVulnerabilityAudit extends TransitiveVulnerabilityAuditCounts {
1359
1441
  /** Advisory scope applied to dependency-package occurrences. */
1360
1442
  advisoryScope: VulnerabilityScope;
1361
1443
  /** Number of resolved package-version graph nodes checked. */
@@ -1367,7 +1449,7 @@ interface TransitiveVulnerabilityAudit {
1367
1449
  calculatedAt?: string;
1368
1450
  packages: TransitiveVulnerabilityAuditPackage[];
1369
1451
  }
1370
- interface TransitiveVulnerabilityAuditPackage {
1452
+ interface TransitiveVulnerabilityAuditPackage extends TransitiveVulnerabilityAuditCounts {
1371
1453
  registry: string;
1372
1454
  name: string;
1373
1455
  occurrenceCount: number;
@@ -1427,6 +1509,8 @@ interface PackageUpgradeReviewParams {
1427
1509
  minSeverity?: number;
1428
1510
  }
1429
1511
  interface PackageUpgradeAdvisorySummary {
1512
+ assessmentStatus?: string;
1513
+ assessmentReasons?: string[];
1430
1514
  id?: string;
1431
1515
  aliases: string[];
1432
1516
  summary?: string;
@@ -1436,6 +1520,8 @@ interface PackageUpgradeAdvisorySummary {
1436
1520
  isMalicious?: boolean;
1437
1521
  }
1438
1522
  interface PackageUpgradeVersionVulnerabilitySummary {
1523
+ unknownVulnerabilityCount?: number;
1524
+ assessmentStatus?: string;
1439
1525
  version: string;
1440
1526
  publishedAt?: string;
1441
1527
  deprecated?: boolean;
@@ -1551,6 +1637,12 @@ interface PackageUpgradeDependencyIssues {
1551
1637
  introducedConflicts: string[];
1552
1638
  introducedOutdated: string[];
1553
1639
  }
1640
+ interface PackageUpgradeUnknownEvidence {
1641
+ section: string;
1642
+ code: string;
1643
+ message: string;
1644
+ retryable?: boolean;
1645
+ }
1554
1646
  interface PackageUpgradeReview {
1555
1647
  registry: string;
1556
1648
  name: string;
@@ -1563,7 +1655,9 @@ interface PackageUpgradeReview {
1563
1655
  compatibility?: PackageUpgradeCompatibility;
1564
1656
  dependencyChanges?: PackageUpgradeDependencyChanges;
1565
1657
  dependencyIssues?: PackageUpgradeDependencyIssues;
1658
+ /** Compatibility field derived from unknownDetails, never selected separately. */
1566
1659
  unknowns: string[];
1660
+ unknownDetails?: PackageUpgradeUnknownEvidence[];
1567
1661
  }
1568
1662
  interface PackageUpgradeReviewResponse {
1569
1663
  summary: {
@@ -1683,6 +1777,8 @@ interface VulnerabilitySummaryDetail {
1683
1777
  isMalicious?: boolean;
1684
1778
  }
1685
1779
  interface TransitiveDependencyVulnerability {
1780
+ assessmentStatus?: string;
1781
+ assessmentReasons?: string[];
1686
1782
  version: string;
1687
1783
  affectsResolvedVersion: boolean;
1688
1784
  matchedAffectedVersionRanges: string[];
@@ -2216,4 +2312,4 @@ declare class ResolveTargetServiceImpl implements ResolveTargetService {
2216
2312
  resolveTarget(params: ResolveTargetParams): Promise<ResolveTargetResult>;
2217
2313
  private executeResolveTarget;
2218
2314
  }
2219
- export { AgentInfo, CodeDiffError, CodeDiffErrorDetails, CodeDiffErrorRef, CodeDiffMode, CodeDiffOptions, CodeDiffPackageInfo, CodeDiffPackageTarget, CodeDiffParams, CodeDiffPartialResult, CodeDiffRefKind, CodeDiffRefResolution, CodeDiffRepositoryTarget, CodeDiffResult, CodeDiffService, CodeDiffTarget, CodeDiffVersionSource, CodeNavigationService, CodeNavigationServiceImpl, CodeSymbolCandidate, CodeSymbolResolution, CodeSymbolSuggestion, ContentModification, ContentSafety, DEFAULT_API_URL, DEFAULT_CODE_NAV_URL, DEFAULT_MCP_URL, DiscoveryIndexingEstimate, GitHitsService, GitHitsServiceImpl, GrepAccessError, GrepBackendError, GrepContentSafety, GrepCorpus, GrepFileIssue, GrepGraphQLError, GrepHit, GrepLineSlice, GrepNetworkError, GrepParams, GrepPathSelector, GrepReadAction, GrepReadiness, GrepRepositoryHit, GrepResult, GrepService, GrepServiceImpl, GrepSiteHit, GrepTarget, GrepTargetStatus, GrepTraversal, GrepUnavailableTarget, IndexingDurationEstimate, KnownLatestVersionMaliciousStatus, KnownMaliciousAdvisoryClassificationReason, LatestVersionMaliciousStatus, ListAccessError, ListAction, ListAvailableVersion, ListBackendError, ListBrowseAction, ListEntry, ListEntryKind, ListFileIntent, ListGraphQLError, ListIndexingEstimate, ListInventoryKind, ListNetworkError, ListParams, ListReadAction, ListResolution, ListResult, ListService, ListServiceImpl, ListSiteJob, ListSitePreparation, ListSiteWait, ListSiteWaitOutcome, ListTargetIdentity, ListTargetResolution, MalformedGrepResponseError, MalformedListResponseError, MaliciousAdvisoryClassificationReason, PKGSEER_REGISTRY_LIST, PackageIntelligenceService, PackageIntelligenceServiceImpl, RawCodeDiff, RawCodeDiffContentCoverage, RawCodeDiffContentFailure, RawCodeDiffFile, RawCodeDiffFileContentStatus, RawCodeDiffFileStatus, RawCodeDiffPathEncoding, RawCodeDiffScope, RawCodeDiffScopeStatus, RawCodeDiffSummary, ReadCodeResult, ReadDocsResult, ReadParams, ReadResult, ReadService, ReadServiceImpl, ReadSymbolResolutionResult, ReadTarget, RefreshingGitHitsService, ResolveTargetKind, ResolveTargetLatestVersionMaliciousAdvisory, ResolveTargetLatestVersionMaliciousEvidence, ResolveTargetMatch, ResolveTargetParams, ResolveTargetReference, ResolveTargetResult, ResolveTargetService, ResolveTargetServiceImpl, ResolveTargetTarget, ServiceDiagnostics, SessionIdConfigError, TokenProvider, createClientHeaderBuilder, createStaticTokenProvider, getApiUrl, getCodeNavigationUrl, getEnvApiToken, getEnvSessionId, getMcpUrl, toPkgseerRegistry, toPkgseerRegistryLowercase };
2315
+ export { AGENTIC_ASK_REQUEST_TIMEOUT_MS, AgentInfo, AgenticAskRateLimitScope, AgenticAskRequest, AgenticAskRequestOptions, AgenticAskResponse, AgenticAskService, AgenticAskServiceImpl, AgenticAskServiceRuntimeOptions, CodeDiffError, CodeDiffErrorDetails, CodeDiffErrorRef, CodeDiffMode, CodeDiffOptions, CodeDiffPackageInfo, CodeDiffPackageTarget, CodeDiffParams, CodeDiffPartialResult, CodeDiffRefKind, CodeDiffRefResolution, CodeDiffRepositoryTarget, CodeDiffResult, CodeDiffService, CodeDiffTarget, CodeDiffVersionSource, CodeNavigationService, CodeNavigationServiceImpl, CodeSymbolCandidate, CodeSymbolResolution, CodeSymbolSuggestion, ContentModification, ContentSafety, DEFAULT_API_URL, DEFAULT_CODE_NAV_URL, DEFAULT_MCP_URL, DiscoveryIndexingEstimate, GitHitsService, GitHitsServiceImpl, GrepAccessError, GrepBackendError, GrepContentSafety, GrepCorpus, GrepFileIssue, GrepGraphQLError, GrepHit, GrepLineSlice, GrepNetworkError, GrepParams, GrepPathSelector, GrepReadAction, GrepReadiness, GrepRepositoryHit, GrepResult, GrepService, GrepServiceImpl, GrepSiteHit, GrepTarget, GrepTargetStatus, GrepTraversal, GrepUnavailableTarget, IndexingDurationEstimate, KnownLatestVersionMaliciousStatus, KnownMaliciousAdvisoryClassificationReason, LatestVersionMaliciousStatus, ListAccessError, ListAction, ListAvailableVersion, ListBackendError, ListBrowseAction, ListEntry, ListEntryKind, ListFileIntent, ListGraphQLError, ListIndexingEstimate, ListInventoryKind, ListNetworkError, ListParams, ListReadAction, ListResolution, ListResult, ListService, ListServiceImpl, ListSiteJob, ListSitePreparation, ListSiteWait, ListSiteWaitOutcome, ListTargetIdentity, ListTargetResolution, MalformedGrepResponseError, MalformedListResponseError, MaliciousAdvisoryClassificationReason, PKGSEER_REGISTRY_LIST, PackageIntelligenceService, PackageIntelligenceServiceImpl, RawCodeDiff, RawCodeDiffContentCoverage, RawCodeDiffContentFailure, RawCodeDiffFile, RawCodeDiffFileContentStatus, RawCodeDiffFileStatus, RawCodeDiffPathEncoding, RawCodeDiffScope, RawCodeDiffScopeStatus, RawCodeDiffSummary, ReadCodeResult, ReadDocsResult, ReadParams, ReadResult, ReadService, ReadServiceImpl, ReadSymbolResolutionResult, ReadTarget, RefreshingGitHitsService, ResolveTargetKind, ResolveTargetLatestVersionMaliciousAdvisory, ResolveTargetLatestVersionMaliciousEvidence, ResolveTargetMatch, ResolveTargetParams, ResolveTargetReference, ResolveTargetResult, ResolveTargetService, ResolveTargetServiceImpl, ResolveTargetTarget, ServiceDiagnostics, SessionIdConfigError, TokenProvider, createClientHeaderBuilder, createStaticTokenProvider, getApiUrl, getCodeNavigationUrl, getEnvApiToken, getEnvSessionId, getMcpUrl, toPkgseerRegistry, toPkgseerRegistryLowercase };
package/dist/client.js CHANGED
@@ -1 +1 @@
1
- import{GrepGraphQLError2,GrepBackendError2,GrepAccessError2,GrepNetworkError2,MalformedGrepResponseError2,GrepServiceImpl2,ListAccessError2,ListGraphQLError2,ListBackendError2,ListNetworkError2,MalformedListResponseError2,ListServiceImpl2,ReadServiceImpl2,RefreshingGitHitsService2,ResolveTargetServiceImpl2,createStaticTokenProvider2,SessionIdConfigError2,getEnvSessionId2,createClientHeaderBuilder2}from"./shared/chunk-876mzceb.js";import{DEFAULT_MCP_URL2,DEFAULT_API_URL2,DEFAULT_CODE_NAV_URL2,getMcpUrl2,getApiUrl2,getCodeNavigationUrl2,getEnvApiToken2,PKGSEER_REGISTRY_LIST2,toPkgseerRegistry2,toPkgseerRegistryLowercase2,GitHitsServiceImpl2,CodeDiffError2,CodeNavigationServiceImpl2,PackageIntelligenceServiceImpl2}from"./shared/chunk-2tjd7frp.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,GrepAccessError2 as GrepAccessError,GrepBackendError2 as GrepBackendError,GrepGraphQLError2 as GrepGraphQLError,GrepNetworkError2 as GrepNetworkError,GrepServiceImpl2 as GrepServiceImpl,ListAccessError2 as ListAccessError,ListBackendError2 as ListBackendError,ListGraphQLError2 as ListGraphQLError,ListNetworkError2 as ListNetworkError,ListServiceImpl2 as ListServiceImpl,MalformedGrepResponseError2 as MalformedGrepResponseError,MalformedListResponseError2 as MalformedListResponseError,PKGSEER_REGISTRY_LIST2 as PKGSEER_REGISTRY_LIST,PackageIntelligenceServiceImpl2 as PackageIntelligenceServiceImpl,ReadServiceImpl2 as ReadServiceImpl,RefreshingGitHitsService2 as RefreshingGitHitsService,ResolveTargetServiceImpl2 as ResolveTargetServiceImpl,SessionIdConfigError2 as SessionIdConfigError,createClientHeaderBuilder2 as createClientHeaderBuilder,createStaticTokenProvider2 as createStaticTokenProvider,getApiUrl2 as getApiUrl,getCodeNavigationUrl2 as getCodeNavigationUrl,getEnvApiToken2 as getEnvApiToken,getEnvSessionId2 as getEnvSessionId,getMcpUrl2 as getMcpUrl,toPkgseerRegistry2 as toPkgseerRegistry,toPkgseerRegistryLowercase2 as toPkgseerRegistryLowercase};
1
+ import{GrepGraphQLError2,GrepBackendError2,GrepAccessError2,GrepNetworkError2,MalformedGrepResponseError2,GrepServiceImpl2,ListAccessError2,ListGraphQLError2,ListBackendError2,ListNetworkError2,MalformedListResponseError2,ListServiceImpl2,ReadServiceImpl2,RefreshingGitHitsService2,ResolveTargetServiceImpl2,createStaticTokenProvider2,SessionIdConfigError2,getEnvSessionId2,createClientHeaderBuilder2}from"./shared/chunk-yw09kwnr.js";import{DEFAULT_MCP_URL2,DEFAULT_API_URL2,DEFAULT_CODE_NAV_URL2,getMcpUrl2,getApiUrl2,getCodeNavigationUrl2,getEnvApiToken2,GitHitsServiceImpl2,AGENTIC_ASK_REQUEST_TIMEOUT_MS2,AgenticAskServiceImpl2,PKGSEER_REGISTRY_LIST2,toPkgseerRegistry2,toPkgseerRegistryLowercase2,CodeDiffError2,CodeNavigationServiceImpl2,PackageIntelligenceServiceImpl2}from"./shared/chunk-mpab140t.js";export{AGENTIC_ASK_REQUEST_TIMEOUT_MS2 as AGENTIC_ASK_REQUEST_TIMEOUT_MS,AgenticAskServiceImpl2 as AgenticAskServiceImpl,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,GrepAccessError2 as GrepAccessError,GrepBackendError2 as GrepBackendError,GrepGraphQLError2 as GrepGraphQLError,GrepNetworkError2 as GrepNetworkError,GrepServiceImpl2 as GrepServiceImpl,ListAccessError2 as ListAccessError,ListBackendError2 as ListBackendError,ListGraphQLError2 as ListGraphQLError,ListNetworkError2 as ListNetworkError,ListServiceImpl2 as ListServiceImpl,MalformedGrepResponseError2 as MalformedGrepResponseError,MalformedListResponseError2 as MalformedListResponseError,PKGSEER_REGISTRY_LIST2 as PKGSEER_REGISTRY_LIST,PackageIntelligenceServiceImpl2 as PackageIntelligenceServiceImpl,ReadServiceImpl2 as ReadServiceImpl,RefreshingGitHitsService2 as RefreshingGitHitsService,ResolveTargetServiceImpl2 as ResolveTargetServiceImpl,SessionIdConfigError2 as SessionIdConfigError,createClientHeaderBuilder2 as createClientHeaderBuilder,createStaticTokenProvider2 as createStaticTokenProvider,getApiUrl2 as getApiUrl,getCodeNavigationUrl2 as getCodeNavigationUrl,getEnvApiToken2 as getEnvApiToken,getEnvSessionId2 as getEnvSessionId,getMcpUrl2 as getMcpUrl,toPkgseerRegistry2 as toPkgseerRegistry,toPkgseerRegistryLowercase2 as toPkgseerRegistryLowercase};
package/dist/index.d.ts CHANGED
@@ -19,6 +19,32 @@ declare function buildMcpQuickStart(options?: BuildMcpQuickStartOptions): string
19
19
  */
20
20
  declare function buildMcpInstructions(options?: BuildMcpInstructionsOptions): string;
21
21
  import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
22
+ interface AgenticAskQuestion {
23
+ question: string;
24
+ }
25
+ type AgenticAskSubject = {
26
+ target?: string;
27
+ threadId?: never;
28
+ } | {
29
+ target?: never;
30
+ threadId: string;
31
+ };
32
+ type AgenticAskRequest = AgenticAskQuestion & AgenticAskSubject & {
33
+ sourceFormat?: "cli" | "mcp" | "url";
34
+ };
35
+ interface AgenticAskRequestOptions {
36
+ signal?: AbortSignal;
37
+ }
38
+ /** Expected backend envelope; successful JSON is deliberately not runtime-validated. */
39
+ interface AgenticAskResponse {
40
+ display_markdown: string;
41
+ tool_call_id?: string;
42
+ thread_id?: string;
43
+ [key: string]: unknown;
44
+ }
45
+ interface AgenticAskService {
46
+ ask(request: AgenticAskRequest, options?: AgenticAskRequestOptions): Promise<AgenticAskResponse>;
47
+ }
22
48
  declare const registryMap: {
23
49
  readonly npm: "NPM";
24
50
  readonly pypi: "PYPI";
@@ -1029,10 +1055,10 @@ interface PackageVulnerabilitiesParams {
1029
1055
  includeTransitive?: boolean;
1030
1056
  /** Optional internal breadth for advisory-wide transitive detail fields. */
1031
1057
  includeTransitiveAdvisoryDetails?: boolean;
1032
- /** Advisory rows to return for the root and opt-in transitive audit; direct counts always include all scopes. */
1058
+ /** Advisory rows to return. Summary counts always include all scopes. */
1033
1059
  advisoryScope?: VulnerabilityScope;
1034
1060
  }
1035
- type VulnerabilityScope = "AFFECTED" | "NON_AFFECTING" | "ALL";
1061
+ type VulnerabilityScope = "AFFECTED" | "NON_AFFECTING" | "UNKNOWN" | "ALL";
1036
1062
  interface PackageVersionIdentity {
1037
1063
  name: string;
1038
1064
  registry?: string;
@@ -1056,10 +1082,14 @@ interface VulnerabilityDetail {
1056
1082
  aliases?: string[];
1057
1083
  isMalicious?: boolean;
1058
1084
  affectsInspectedVersion?: boolean;
1085
+ assessmentStatus?: string;
1086
+ assessmentReasons?: string[];
1059
1087
  matchedAffectedVersionRanges?: string[];
1060
1088
  duplicateIds?: string[];
1061
1089
  }
1062
1090
  interface VulnerabilitySecurityDetails {
1091
+ unknownVulnerabilityCount?: number;
1092
+ assessmentStatus?: string;
1063
1093
  affectedVulnerabilityCount: number;
1064
1094
  nonAffectingVulnerabilityCount: number;
1065
1095
  allVulnerabilityCount: number;
@@ -1072,7 +1102,13 @@ interface VulnerabilityReport {
1072
1102
  security?: VulnerabilitySecurityDetails;
1073
1103
  transitive?: TransitiveVulnerabilityAudit;
1074
1104
  }
1075
- interface TransitiveVulnerabilityAudit {
1105
+ interface TransitiveVulnerabilityAuditCounts {
1106
+ affectedCount: number;
1107
+ nonAffectingCount: number;
1108
+ unknownCount: number;
1109
+ totalCount: number;
1110
+ }
1111
+ interface TransitiveVulnerabilityAudit extends TransitiveVulnerabilityAuditCounts {
1076
1112
  /** Advisory scope applied to dependency-package occurrences. */
1077
1113
  advisoryScope: VulnerabilityScope;
1078
1114
  /** Number of resolved package-version graph nodes checked. */
@@ -1084,7 +1120,7 @@ interface TransitiveVulnerabilityAudit {
1084
1120
  calculatedAt?: string;
1085
1121
  packages: TransitiveVulnerabilityAuditPackage[];
1086
1122
  }
1087
- interface TransitiveVulnerabilityAuditPackage {
1123
+ interface TransitiveVulnerabilityAuditPackage extends TransitiveVulnerabilityAuditCounts {
1088
1124
  registry: string;
1089
1125
  name: string;
1090
1126
  occurrenceCount: number;
@@ -1144,6 +1180,8 @@ interface PackageUpgradeReviewParams {
1144
1180
  minSeverity?: number;
1145
1181
  }
1146
1182
  interface PackageUpgradeAdvisorySummary {
1183
+ assessmentStatus?: string;
1184
+ assessmentReasons?: string[];
1147
1185
  id?: string;
1148
1186
  aliases: string[];
1149
1187
  summary?: string;
@@ -1153,6 +1191,8 @@ interface PackageUpgradeAdvisorySummary {
1153
1191
  isMalicious?: boolean;
1154
1192
  }
1155
1193
  interface PackageUpgradeVersionVulnerabilitySummary {
1194
+ unknownVulnerabilityCount?: number;
1195
+ assessmentStatus?: string;
1156
1196
  version: string;
1157
1197
  publishedAt?: string;
1158
1198
  deprecated?: boolean;
@@ -1268,6 +1308,12 @@ interface PackageUpgradeDependencyIssues {
1268
1308
  introducedConflicts: string[];
1269
1309
  introducedOutdated: string[];
1270
1310
  }
1311
+ interface PackageUpgradeUnknownEvidence {
1312
+ section: string;
1313
+ code: string;
1314
+ message: string;
1315
+ retryable?: boolean;
1316
+ }
1271
1317
  interface PackageUpgradeReview {
1272
1318
  registry: string;
1273
1319
  name: string;
@@ -1280,7 +1326,9 @@ interface PackageUpgradeReview {
1280
1326
  compatibility?: PackageUpgradeCompatibility;
1281
1327
  dependencyChanges?: PackageUpgradeDependencyChanges;
1282
1328
  dependencyIssues?: PackageUpgradeDependencyIssues;
1329
+ /** Compatibility field derived from unknownDetails, never selected separately. */
1283
1330
  unknowns: string[];
1331
+ unknownDetails?: PackageUpgradeUnknownEvidence[];
1284
1332
  }
1285
1333
  interface PackageUpgradeReviewResponse {
1286
1334
  summary: {
@@ -1400,6 +1448,8 @@ interface VulnerabilitySummaryDetail {
1400
1448
  isMalicious?: boolean;
1401
1449
  }
1402
1450
  interface TransitiveDependencyVulnerability {
1451
+ assessmentStatus?: string;
1452
+ assessmentReasons?: string[];
1403
1453
  version: string;
1404
1454
  affectsResolvedVersion: boolean;
1405
1455
  matchedAffectedVersionRanges: string[];
@@ -1892,6 +1942,8 @@ interface McpToolServices {
1892
1942
  readService: ReadService;
1893
1943
  grepService: GrepService;
1894
1944
  resolveTargetService: ResolveTargetService;
1945
+ /** Research over the GitHits REST API; answers can take a few minutes. */
1946
+ agenticAskService: AgenticAskService;
1895
1947
  }
1896
1948
  interface McpServerMetadata {
1897
1949
  name: string;