@githits/mcp 0.31.0 → 0.32.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 +2 -0
- package/dist/client.d.ts +38 -27
- package/dist/client.js +1 -1
- package/dist/index.d.ts +24 -13
- package/dist/index.js +11 -11
- package/dist/shared/chunk-9qbcj09a.js +31 -0
- package/dist/shared/chunk-a1w4dxpc.js +352 -0
- package/dist/shared/{chunk-mpab140t.js → chunk-j6q0y6f2.js} +4 -4
- package/dist/smoke-test.js +1 -1
- package/dist/tools.d.ts +12 -1
- package/dist/tools.js +1 -1
- package/package.json +1 -1
- package/dist/shared/chunk-f7dn7map.js +0 -31
- package/dist/shared/chunk-yw09kwnr.js +0 -352
package/README.md
CHANGED
|
@@ -157,6 +157,8 @@ boundary is authenticated and reached.
|
|
|
157
157
|
|
|
158
158
|
The package expects callers to provide service implementations through `McpToolServices` or a request-scoped `McpToolServicesProvider`. `McpToolServices.readService` is required for the advertised compact `read` tool; remote hosts should construct the `ReadServiceImpl` instance per request with that request's endpoint, token, headers, fetch function, and diagnostics. GitHits does not populate MCP initialize instructions because hosts expose them inconsistently; `quick_start` owns shared guidance instead. Callers may still pass their own `instructions` explicitly. Use `quickStartOptions` to configure the guide. Servers can pass `traceTool` to `createMcpServer()` or `registerMcpTools()` to wrap public tool execution for instrumentation without receiving arguments or auth data.
|
|
159
159
|
|
|
160
|
+
Network-backed tools forward the MCP request's abort signal to their service call as an optional trailing `ServiceRequestOptions` argument (`{ signal }`), so a cancelled call or closed connection aborts the backend request. The bundled service implementations behind these tools honor it; custom service implementations should forward `options?.signal` to their own requests. Calls without a signal keep their single-argument shape.
|
|
161
|
+
|
|
160
162
|
Only imports from `@githits/mcp`, `@githits/mcp/client`, `@githits/mcp/smoke-test`, `@githits/mcp/tools`, and `@githits/mcp/package.json` are public. The workspace alias `@githits/mcp/internal` is not exported, is not supported for external consumers, and must not be used by remote MCP server implementations.
|
|
161
163
|
|
|
162
164
|
Remote MCP servers should provide request-scoped services through `createMcpServer()` and keep transport, auth/session handling, deployment config, and observability outside this package.
|
package/dist/client.d.ts
CHANGED
|
@@ -168,6 +168,17 @@ interface ReadTarget {
|
|
|
168
168
|
startLine?: number;
|
|
169
169
|
endLine?: number;
|
|
170
170
|
}
|
|
171
|
+
/**
|
|
172
|
+
* Optional per-call controls shared by network-backed service methods.
|
|
173
|
+
*
|
|
174
|
+
* `signal` is the caller's cancellation signal, such as an MCP request
|
|
175
|
+
* cancellation. Services combine it with their own request deadline: a caller
|
|
176
|
+
* abort rejects with the signal's reason and is never retried, while an
|
|
177
|
+
* internal deadline keeps each service's timeout error mapping.
|
|
178
|
+
*/
|
|
179
|
+
interface ServiceRequestOptions {
|
|
180
|
+
signal?: AbortSignal;
|
|
181
|
+
}
|
|
171
182
|
/** Nullable registry-version association carried by public error inventories. */
|
|
172
183
|
interface RecoveryRef {
|
|
173
184
|
ref: string;
|
|
@@ -862,7 +873,7 @@ interface CodeNavigationService {
|
|
|
862
873
|
}
|
|
863
874
|
/** Additive client capability for the unpromoted CodeDiff surface. */
|
|
864
875
|
interface CodeDiffService {
|
|
865
|
-
codeDiff(params: CodeDiffParams): Promise<CodeDiffResult>;
|
|
876
|
+
codeDiff(params: CodeDiffParams, options?: ServiceRequestOptions): Promise<CodeDiffResult>;
|
|
866
877
|
}
|
|
867
878
|
/**
|
|
868
879
|
* GraphQL resolver error for CodeDiff. `partial` is present only when the
|
|
@@ -887,7 +898,7 @@ declare class CodeNavigationServiceImpl implements CodeNavigationService, CodeDi
|
|
|
887
898
|
private postGraphqlWithTargetResolutionFallback;
|
|
888
899
|
search(params: UnifiedSearchParams, options?: UnifiedSearchReadOptions): Promise<UnifiedSearchOutcome>;
|
|
889
900
|
searchStatus(searchRef: string, waitTimeoutMs?: number, options?: UnifiedSearchReadOptions): Promise<UnifiedSearchOutcome>;
|
|
890
|
-
codeDiff(params: CodeDiffParams): Promise<CodeDiffResult>;
|
|
901
|
+
codeDiff(params: CodeDiffParams, options?: ServiceRequestOptions): Promise<CodeDiffResult>;
|
|
891
902
|
private executeCodeDiff;
|
|
892
903
|
private createCodeDiffRootError;
|
|
893
904
|
private executeUnifiedSearch;
|
|
@@ -1112,7 +1123,7 @@ interface GrepResult {
|
|
|
1112
1123
|
totalMatches: number;
|
|
1113
1124
|
}
|
|
1114
1125
|
interface GrepService {
|
|
1115
|
-
grep(params: GrepParams): Promise<GrepResult>;
|
|
1126
|
+
grep(params: GrepParams, options?: ServiceRequestOptions): Promise<GrepResult>;
|
|
1116
1127
|
}
|
|
1117
1128
|
interface GrepServiceRuntime {
|
|
1118
1129
|
clientHeaders?: ClientHeaderBuilder;
|
|
@@ -1149,7 +1160,7 @@ declare class GrepServiceImpl implements GrepService {
|
|
|
1149
1160
|
private readonly fetchFn;
|
|
1150
1161
|
private readonly runtime;
|
|
1151
1162
|
constructor(endpointUrl: string, tokenProvider: TokenProvider, fetchFn?: typeof fetch, runtime?: GrepServiceRuntime);
|
|
1152
|
-
grep(params: GrepParams): Promise<GrepResult>;
|
|
1163
|
+
grep(params: GrepParams, options?: ServiceRequestOptions): Promise<GrepResult>;
|
|
1153
1164
|
private executeGrep;
|
|
1154
1165
|
}
|
|
1155
1166
|
type ListFileIntent = "PRODUCTION" | "TEST" | "BENCHMARK" | "EXAMPLE" | "GENERATED" | "FIXTURE" | "BUILD" | "VENDOR";
|
|
@@ -1268,7 +1279,7 @@ interface ListResult {
|
|
|
1268
1279
|
preparation: ListSitePreparation | null;
|
|
1269
1280
|
}
|
|
1270
1281
|
interface ListService {
|
|
1271
|
-
list(params: ListParams): Promise<ListResult>;
|
|
1282
|
+
list(params: ListParams, options?: ServiceRequestOptions): Promise<ListResult>;
|
|
1272
1283
|
}
|
|
1273
1284
|
interface ListServiceRuntime {
|
|
1274
1285
|
clientHeaders?: ClientHeaderBuilder;
|
|
@@ -1316,7 +1327,7 @@ declare class ListServiceImpl implements ListService {
|
|
|
1316
1327
|
private readonly fetchFn;
|
|
1317
1328
|
private readonly runtime;
|
|
1318
1329
|
constructor(endpointUrl: string, tokenProvider: TokenProvider, fetchFn?: typeof fetch, runtime?: ListServiceRuntime);
|
|
1319
|
-
list(params: ListParams): Promise<ListResult>;
|
|
1330
|
+
list(params: ListParams, options?: ServiceRequestOptions): Promise<ListResult>;
|
|
1320
1331
|
private executeList;
|
|
1321
1332
|
}
|
|
1322
1333
|
interface PackageSummaryParams {
|
|
@@ -2080,14 +2091,14 @@ interface PackageDocResult {
|
|
|
2080
2091
|
page?: PackageDocPage;
|
|
2081
2092
|
}
|
|
2082
2093
|
interface PackageIntelligenceService {
|
|
2083
|
-
packageSummary(params: PackageSummaryParams): Promise<PackageSummary>;
|
|
2084
|
-
packageVulnerabilities(params: PackageVulnerabilitiesParams): Promise<VulnerabilityReport>;
|
|
2085
|
-
packageDependencies(params: PackageDependenciesParams): Promise<DependencyReport>;
|
|
2086
|
-
packageUpgradeDependencyProbe(params: PackageUpgradeDependencyProbeParams): Promise<DependencyReport>;
|
|
2087
|
-
packageUpgradeReview(params: PackageUpgradeReviewParams): Promise<PackageUpgradeReviewResponse>;
|
|
2088
|
-
packageChangelog(params: PackageChangelogParams): Promise<ChangelogReport>;
|
|
2089
|
-
listPackageDocs(params: ListPackageDocsParams): Promise<PackageDocsList>;
|
|
2090
|
-
readPackageDoc(params: ReadPackageDocParams): Promise<PackageDocResult>;
|
|
2094
|
+
packageSummary(params: PackageSummaryParams, options?: ServiceRequestOptions): Promise<PackageSummary>;
|
|
2095
|
+
packageVulnerabilities(params: PackageVulnerabilitiesParams, options?: ServiceRequestOptions): Promise<VulnerabilityReport>;
|
|
2096
|
+
packageDependencies(params: PackageDependenciesParams, options?: ServiceRequestOptions): Promise<DependencyReport>;
|
|
2097
|
+
packageUpgradeDependencyProbe(params: PackageUpgradeDependencyProbeParams, options?: ServiceRequestOptions): Promise<DependencyReport>;
|
|
2098
|
+
packageUpgradeReview(params: PackageUpgradeReviewParams, options?: ServiceRequestOptions): Promise<PackageUpgradeReviewResponse>;
|
|
2099
|
+
packageChangelog(params: PackageChangelogParams, options?: ServiceRequestOptions): Promise<ChangelogReport>;
|
|
2100
|
+
listPackageDocs(params: ListPackageDocsParams, options?: ServiceRequestOptions): Promise<PackageDocsList>;
|
|
2101
|
+
readPackageDoc(params: ReadPackageDocParams, options?: ServiceRequestOptions): Promise<PackageDocResult>;
|
|
2091
2102
|
}
|
|
2092
2103
|
declare class PackageIntelligenceServiceImpl implements PackageIntelligenceService {
|
|
2093
2104
|
private readonly endpointUrl;
|
|
@@ -2100,21 +2111,21 @@ declare class PackageIntelligenceServiceImpl implements PackageIntelligenceServi
|
|
|
2100
2111
|
clientVersion?: string;
|
|
2101
2112
|
diagnostics?: ServiceDiagnostics;
|
|
2102
2113
|
});
|
|
2103
|
-
packageSummary(params: PackageSummaryParams): Promise<PackageSummary>;
|
|
2114
|
+
packageSummary(params: PackageSummaryParams, options?: ServiceRequestOptions): Promise<PackageSummary>;
|
|
2104
2115
|
private executePackageSummary;
|
|
2105
2116
|
private createHttpError;
|
|
2106
2117
|
private createTransportError;
|
|
2107
2118
|
private createGraphQLError;
|
|
2108
2119
|
private normalise;
|
|
2109
|
-
packageVulnerabilities(params: PackageVulnerabilitiesParams): Promise<VulnerabilityReport>;
|
|
2120
|
+
packageVulnerabilities(params: PackageVulnerabilitiesParams, options?: ServiceRequestOptions): Promise<VulnerabilityReport>;
|
|
2110
2121
|
private executePackageVulnerabilities;
|
|
2111
2122
|
private fetchPackageVulnerabilitiesPage;
|
|
2112
2123
|
private normaliseVulnerabilityReport;
|
|
2113
2124
|
private fetchTransitiveVulnerabilityAudit;
|
|
2114
2125
|
private normaliseTransitiveVulnerabilityAudit;
|
|
2115
|
-
packageDependencies(params: PackageDependenciesParams): Promise<DependencyReport>;
|
|
2116
|
-
packageUpgradeDependencyProbe(params: PackageUpgradeDependencyProbeParams): Promise<DependencyReport>;
|
|
2117
|
-
packageUpgradeReview(params: PackageUpgradeReviewParams): Promise<PackageUpgradeReviewResponse>;
|
|
2126
|
+
packageDependencies(params: PackageDependenciesParams, options?: ServiceRequestOptions): Promise<DependencyReport>;
|
|
2127
|
+
packageUpgradeDependencyProbe(params: PackageUpgradeDependencyProbeParams, options?: ServiceRequestOptions): Promise<DependencyReport>;
|
|
2128
|
+
packageUpgradeReview(params: PackageUpgradeReviewParams, options?: ServiceRequestOptions): Promise<PackageUpgradeReviewResponse>;
|
|
2118
2129
|
private executePackageUpgradeReview;
|
|
2119
2130
|
private fetchUpgradeStatementPage;
|
|
2120
2131
|
private executePackageUpgradeDependencyProbe;
|
|
@@ -2124,13 +2135,13 @@ declare class PackageIntelligenceServiceImpl implements PackageIntelligenceServi
|
|
|
2124
2135
|
private normaliseVulnerabilitySummaryDetail;
|
|
2125
2136
|
private normaliseTransitiveAuditAdvisory;
|
|
2126
2137
|
private normaliseDependencyIssuesSummary;
|
|
2127
|
-
packageChangelog(params: PackageChangelogParams): Promise<ChangelogReport>;
|
|
2138
|
+
packageChangelog(params: PackageChangelogParams, options?: ServiceRequestOptions): Promise<ChangelogReport>;
|
|
2128
2139
|
private executePackageChangelog;
|
|
2129
2140
|
private fetchPackageChangelogPage;
|
|
2130
|
-
listPackageDocs(params: ListPackageDocsParams): Promise<PackageDocsList>;
|
|
2141
|
+
listPackageDocs(params: ListPackageDocsParams, options?: ServiceRequestOptions): Promise<PackageDocsList>;
|
|
2131
2142
|
private executeListPackageDocs;
|
|
2132
2143
|
private normalisePackageDocsList;
|
|
2133
|
-
readPackageDoc(params: ReadPackageDocParams): Promise<PackageDocResult>;
|
|
2144
|
+
readPackageDoc(params: ReadPackageDocParams, options?: ServiceRequestOptions): Promise<PackageDocResult>;
|
|
2134
2145
|
private executeReadPackageDoc;
|
|
2135
2146
|
}
|
|
2136
2147
|
interface ReadParams {
|
|
@@ -2182,7 +2193,7 @@ interface ReadSymbolResolutionResult {
|
|
|
2182
2193
|
}
|
|
2183
2194
|
type ReadResult = ReadCodeResult | ReadDocsResult | ReadSymbolResolutionResult;
|
|
2184
2195
|
interface ReadService {
|
|
2185
|
-
read(params: ReadParams): Promise<ReadResult>;
|
|
2196
|
+
read(params: ReadParams, options?: ServiceRequestOptions): Promise<ReadResult>;
|
|
2186
2197
|
}
|
|
2187
2198
|
interface ReadServiceRuntime {
|
|
2188
2199
|
clientHeaders?: ClientHeaderBuilder;
|
|
@@ -2197,7 +2208,7 @@ declare class ReadServiceImpl implements ReadService {
|
|
|
2197
2208
|
private readonly fetchFn;
|
|
2198
2209
|
private readonly runtime;
|
|
2199
2210
|
constructor(endpointUrl: string, tokenProvider: TokenProvider, fetchFn?: typeof fetch, runtime?: ReadServiceRuntime);
|
|
2200
|
-
read(params: ReadParams): Promise<ReadResult>;
|
|
2211
|
+
read(params: ReadParams, options?: ServiceRequestOptions): Promise<ReadResult>;
|
|
2201
2212
|
private executeRead;
|
|
2202
2213
|
}
|
|
2203
2214
|
/**
|
|
@@ -2296,7 +2307,7 @@ interface ResolveTargetResult {
|
|
|
2296
2307
|
ambiguousReason: string;
|
|
2297
2308
|
}
|
|
2298
2309
|
interface ResolveTargetService {
|
|
2299
|
-
resolveTarget(params: ResolveTargetParams): Promise<ResolveTargetResult>;
|
|
2310
|
+
resolveTarget(params: ResolveTargetParams, options?: ServiceRequestOptions): Promise<ResolveTargetResult>;
|
|
2300
2311
|
}
|
|
2301
2312
|
declare class ResolveTargetServiceImpl implements ResolveTargetService {
|
|
2302
2313
|
private readonly endpointUrl;
|
|
@@ -2309,7 +2320,7 @@ declare class ResolveTargetServiceImpl implements ResolveTargetService {
|
|
|
2309
2320
|
clientVersion?: string;
|
|
2310
2321
|
diagnostics?: ServiceDiagnostics;
|
|
2311
2322
|
});
|
|
2312
|
-
resolveTarget(params: ResolveTargetParams): Promise<ResolveTargetResult>;
|
|
2323
|
+
resolveTarget(params: ResolveTargetParams, options?: ServiceRequestOptions): Promise<ResolveTargetResult>;
|
|
2313
2324
|
private executeResolveTarget;
|
|
2314
2325
|
}
|
|
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 };
|
|
2326
|
+
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, ServiceRequestOptions, 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-a1w4dxpc.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-j6q0y6f2.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
|
@@ -85,6 +85,17 @@ interface ReadTarget {
|
|
|
85
85
|
endLine?: number;
|
|
86
86
|
}
|
|
87
87
|
/**
|
|
88
|
+
* Optional per-call controls shared by network-backed service methods.
|
|
89
|
+
*
|
|
90
|
+
* `signal` is the caller's cancellation signal, such as an MCP request
|
|
91
|
+
* cancellation. Services combine it with their own request deadline: a caller
|
|
92
|
+
* abort rejects with the signal's reason and is never retried, while an
|
|
93
|
+
* internal deadline keeps each service's timeout error mapping.
|
|
94
|
+
*/
|
|
95
|
+
interface ServiceRequestOptions {
|
|
96
|
+
signal?: AbortSignal;
|
|
97
|
+
}
|
|
98
|
+
/**
|
|
88
99
|
* Back-compat alias — the canonical registry union now lives in
|
|
89
100
|
* `src/shared/pkgseer-registry.ts`. Re-exported here so existing
|
|
90
101
|
* consumers of `CodeNavigationRegistry` compile unchanged.
|
|
@@ -723,7 +734,7 @@ interface CodeNavigationService {
|
|
|
723
734
|
}
|
|
724
735
|
/** Additive client capability for the unpromoted CodeDiff surface. */
|
|
725
736
|
interface CodeDiffService {
|
|
726
|
-
codeDiff(params: CodeDiffParams): Promise<CodeDiffResult>;
|
|
737
|
+
codeDiff(params: CodeDiffParams, options?: ServiceRequestOptions): Promise<CodeDiffResult>;
|
|
727
738
|
}
|
|
728
739
|
/**
|
|
729
740
|
* Parameters for search API call.
|
|
@@ -871,7 +882,7 @@ interface GrepResult {
|
|
|
871
882
|
totalMatches: number;
|
|
872
883
|
}
|
|
873
884
|
interface GrepService {
|
|
874
|
-
grep(params: GrepParams): Promise<GrepResult>;
|
|
885
|
+
grep(params: GrepParams, options?: ServiceRequestOptions): Promise<GrepResult>;
|
|
875
886
|
}
|
|
876
887
|
type ListFileIntent = "PRODUCTION" | "TEST" | "BENCHMARK" | "EXAMPLE" | "GENERATED" | "FIXTURE" | "BUILD" | "VENDOR";
|
|
877
888
|
interface ListParams {
|
|
@@ -988,7 +999,7 @@ interface ListResult {
|
|
|
988
999
|
preparation: ListSitePreparation | null;
|
|
989
1000
|
}
|
|
990
1001
|
interface ListService {
|
|
991
|
-
list(params: ListParams): Promise<ListResult>;
|
|
1002
|
+
list(params: ListParams, options?: ServiceRequestOptions): Promise<ListResult>;
|
|
992
1003
|
}
|
|
993
1004
|
interface PackageSummaryParams {
|
|
994
1005
|
registry: PkgseerRegistry;
|
|
@@ -1751,14 +1762,14 @@ interface PackageDocResult {
|
|
|
1751
1762
|
page?: PackageDocPage;
|
|
1752
1763
|
}
|
|
1753
1764
|
interface PackageIntelligenceService {
|
|
1754
|
-
packageSummary(params: PackageSummaryParams): Promise<PackageSummary>;
|
|
1755
|
-
packageVulnerabilities(params: PackageVulnerabilitiesParams): Promise<VulnerabilityReport>;
|
|
1756
|
-
packageDependencies(params: PackageDependenciesParams): Promise<DependencyReport>;
|
|
1757
|
-
packageUpgradeDependencyProbe(params: PackageUpgradeDependencyProbeParams): Promise<DependencyReport>;
|
|
1758
|
-
packageUpgradeReview(params: PackageUpgradeReviewParams): Promise<PackageUpgradeReviewResponse>;
|
|
1759
|
-
packageChangelog(params: PackageChangelogParams): Promise<ChangelogReport>;
|
|
1760
|
-
listPackageDocs(params: ListPackageDocsParams): Promise<PackageDocsList>;
|
|
1761
|
-
readPackageDoc(params: ReadPackageDocParams): Promise<PackageDocResult>;
|
|
1765
|
+
packageSummary(params: PackageSummaryParams, options?: ServiceRequestOptions): Promise<PackageSummary>;
|
|
1766
|
+
packageVulnerabilities(params: PackageVulnerabilitiesParams, options?: ServiceRequestOptions): Promise<VulnerabilityReport>;
|
|
1767
|
+
packageDependencies(params: PackageDependenciesParams, options?: ServiceRequestOptions): Promise<DependencyReport>;
|
|
1768
|
+
packageUpgradeDependencyProbe(params: PackageUpgradeDependencyProbeParams, options?: ServiceRequestOptions): Promise<DependencyReport>;
|
|
1769
|
+
packageUpgradeReview(params: PackageUpgradeReviewParams, options?: ServiceRequestOptions): Promise<PackageUpgradeReviewResponse>;
|
|
1770
|
+
packageChangelog(params: PackageChangelogParams, options?: ServiceRequestOptions): Promise<ChangelogReport>;
|
|
1771
|
+
listPackageDocs(params: ListPackageDocsParams, options?: ServiceRequestOptions): Promise<PackageDocsList>;
|
|
1772
|
+
readPackageDoc(params: ReadPackageDocParams, options?: ServiceRequestOptions): Promise<PackageDocResult>;
|
|
1762
1773
|
}
|
|
1763
1774
|
interface ReadParams {
|
|
1764
1775
|
target: string;
|
|
@@ -1809,7 +1820,7 @@ interface ReadSymbolResolutionResult {
|
|
|
1809
1820
|
}
|
|
1810
1821
|
type ReadResult = ReadCodeResult | ReadDocsResult | ReadSymbolResolutionResult;
|
|
1811
1822
|
interface ReadService {
|
|
1812
|
-
read(params: ReadParams): Promise<ReadResult>;
|
|
1823
|
+
read(params: ReadParams, options?: ServiceRequestOptions): Promise<ReadResult>;
|
|
1813
1824
|
}
|
|
1814
1825
|
type ResolveTargetKind = "PACKAGE" | "REPOSITORY" | "SITE";
|
|
1815
1826
|
type KnownLatestVersionMaliciousStatus = "NOT_APPLICABLE" | "CLEAR" | "AFFECTED" | "UNKNOWN";
|
|
@@ -1885,7 +1896,7 @@ interface ResolveTargetResult {
|
|
|
1885
1896
|
ambiguousReason: string;
|
|
1886
1897
|
}
|
|
1887
1898
|
interface ResolveTargetService {
|
|
1888
|
-
resolveTarget(params: ResolveTargetParams): Promise<ResolveTargetResult>;
|
|
1899
|
+
resolveTarget(params: ResolveTargetParams, options?: ServiceRequestOptions): Promise<ResolveTargetResult>;
|
|
1889
1900
|
}
|
|
1890
1901
|
import { z as z3 } from "zod";
|
|
1891
1902
|
/** Annotation fields required by OpenAI's MCP marketplace validation. */
|