@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 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-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};
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. */