@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 +22 -0
- package/dist/client.d.ts +102 -6
- package/dist/client.js +1 -1
- package/dist/index.d.ts +56 -4
- package/dist/index.js +42 -23
- package/dist/shared/chunk-f7dn7map.js +31 -0
- package/dist/shared/{chunk-2tjd7frp.js → chunk-mpab140t.js} +36 -21
- package/dist/shared/{chunk-876mzceb.js → chunk-yw09kwnr.js} +3 -3
- package/dist/smoke-test.d.ts +1 -1
- package/dist/smoke-test.js +3 -3
- package/dist/tools.d.ts +38 -3
- package/dist/tools.js +1 -1
- package/package.json +1 -1
- package/dist/shared/chunk-5s5crcy5.js +0 -26
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
|
-
|
|
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
|
|
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
|
|
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-
|
|
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
|
|
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
|
|
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;
|