@githits/mcp 0.38.0 → 0.39.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/dist/client.d.ts CHANGED
@@ -28,20 +28,6 @@ interface CreateClientHeaderBuilderOptions {
28
28
  */
29
29
  declare function createClientHeaderBuilder(options: CreateClientHeaderBuilderOptions): ClientHeaderBuilder;
30
30
  /**
31
- * Optional per-call progress correlation for backend requests.
32
- *
33
- * Progress is best effort: the HTTP result stays authoritative. The backend
34
- * validates progress headers before admission, accounting and execution, so a
35
- * rejection carrying `X-GitHits-Progress-Error` means nothing ran and the same
36
- * request is safe to resend once without the progress headers.
37
- */
38
- interface ProgressRequest {
39
- /** Correlation headers merged after client headers and before auth. */
40
- readonly headers: Readonly<Record<string, string>>;
41
- /** Reports a pre-execution progress rejection; the call is then resent without progress. */
42
- rejected(code: string): void;
43
- }
44
- /**
45
31
  * Host-supplied diagnostics for transport-neutral service clients.
46
32
  *
47
33
  * Implementations may record operation timings or debug events in whatever
@@ -63,6 +49,17 @@ interface ServiceDiagnostics {
63
49
  isEnabled(area: string): boolean;
64
50
  debug(area: string, event: Record<string, unknown>): void;
65
51
  }
52
+ /**
53
+ * Optional per-call controls shared by network-backed service methods.
54
+ *
55
+ * `signal` is the caller's cancellation signal, such as an MCP request
56
+ * cancellation. Services combine it with their own request deadline: a caller
57
+ * abort rejects with the signal's reason and is never retried, while an
58
+ * internal deadline keeps each service's timeout error mapping.
59
+ */
60
+ interface ServiceRequestOptions {
61
+ signal?: AbortSignal;
62
+ }
66
63
  interface TokenProvider {
67
64
  /** Get a valid token, refreshing proactively or reactively as needed. */
68
65
  getToken(): Promise<string | undefined>;
@@ -70,6 +67,20 @@ interface TokenProvider {
70
67
  forceRefresh(): Promise<string | undefined>;
71
68
  }
72
69
  declare function createStaticTokenProvider(token: string): TokenProvider;
70
+ /**
71
+ * Optional per-call progress correlation for backend requests.
72
+ *
73
+ * Progress is best effort: the HTTP result stays authoritative. The backend
74
+ * validates progress headers before admission, accounting and execution, so a
75
+ * rejection carrying `X-GitHits-Progress-Error` means nothing ran and the same
76
+ * request is safe to resend once without the progress headers.
77
+ */
78
+ interface ProgressRequest {
79
+ /** Correlation headers merged after client headers and before auth. */
80
+ readonly headers: Readonly<Record<string, string>>;
81
+ /** Reports a pre-execution progress rejection; the call is then resent without progress. */
82
+ rejected(code: string): void;
83
+ }
73
84
  declare const AGENTIC_ASK_REQUEST_TIMEOUT_MS = 21e4;
74
85
  interface AgenticAskQuestion {
75
86
  question: string;
@@ -185,17 +196,6 @@ interface ReadTarget {
185
196
  startLine?: number;
186
197
  endLine?: number;
187
198
  }
188
- /**
189
- * Optional per-call controls shared by network-backed service methods.
190
- *
191
- * `signal` is the caller's cancellation signal, such as an MCP request
192
- * cancellation. Services combine it with their own request deadline: a caller
193
- * abort rejects with the signal's reason and is never retried, while an
194
- * internal deadline keeps each service's timeout error mapping.
195
- */
196
- interface ServiceRequestOptions {
197
- signal?: AbortSignal;
198
- }
199
199
  /** Nullable registry-version association carried by public error inventories. */
200
200
  interface RecoveryRef {
201
201
  ref: string;
@@ -1390,11 +1390,22 @@ interface RegistryRepository {
1390
1390
  name: string;
1391
1391
  url: string;
1392
1392
  }
1393
+ /** Why the registry pointer is excluded from default release selection. */
1394
+ type RegistryLatestDifferenceReason = "DEPRECATED" | "YANKED" | "NO_FILES" | "UNLISTED" | "PRERELEASE_EXCLUDED";
1395
+ interface RegistryLatestDifference {
1396
+ version: string;
1397
+ reason: RegistryLatestDifferenceReason;
1398
+ }
1393
1399
  interface PackageIdentity {
1394
1400
  name: string;
1395
1401
  registry?: string;
1396
1402
  description?: string;
1397
- latestVersion: string;
1403
+ /** Release selected for this overview; absent when no release is selected. */
1404
+ version?: string;
1405
+ publishedAt?: string;
1406
+ registryLatestDifference?: RegistryLatestDifference;
1407
+ /** Registry pointer, which may differ from the selected release. */
1408
+ latestVersion?: string;
1398
1409
  latestVersionPublishedAt?: string;
1399
1410
  homepage?: string;
1400
1411
  repositoryUrl?: string;
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-3rrwegcq.js";import{ProviderReauthenticationRequiredError2,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-99jxrjze.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,ProviderReauthenticationRequiredError2 as ProviderReauthenticationRequiredError,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-54mxpkxp.js";import{ProviderReauthenticationRequiredError2,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-yv5er0y7.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,ProviderReauthenticationRequiredError2 as ProviderReauthenticationRequiredError,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
@@ -20,6 +20,17 @@ declare function buildMcpQuickStart(options?: BuildMcpQuickStartOptions): string
20
20
  declare function buildMcpInstructions(options?: BuildMcpInstructionsOptions): string;
21
21
  import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
22
22
  /**
23
+ * Optional per-call controls shared by network-backed service methods.
24
+ *
25
+ * `signal` is the caller's cancellation signal, such as an MCP request
26
+ * cancellation. Services combine it with their own request deadline: a caller
27
+ * abort rejects with the signal's reason and is never retried, while an
28
+ * internal deadline keeps each service's timeout error mapping.
29
+ */
30
+ interface ServiceRequestOptions {
31
+ signal?: AbortSignal;
32
+ }
33
+ /**
23
34
  * Optional per-call progress correlation for backend requests.
24
35
  *
25
36
  * Progress is best effort: the HTTP result stays authoritative. The backend
@@ -102,17 +113,6 @@ interface ReadTarget {
102
113
  endLine?: number;
103
114
  }
104
115
  /**
105
- * Optional per-call controls shared by network-backed service methods.
106
- *
107
- * `signal` is the caller's cancellation signal, such as an MCP request
108
- * cancellation. Services combine it with their own request deadline: a caller
109
- * abort rejects with the signal's reason and is never retried, while an
110
- * internal deadline keeps each service's timeout error mapping.
111
- */
112
- interface ServiceRequestOptions {
113
- signal?: AbortSignal;
114
- }
115
- /**
116
116
  * Back-compat alias — the canonical registry union now lives in
117
117
  * `src/shared/pkgseer-registry.ts`. Re-exported here so existing
118
118
  * consumers of `CodeNavigationRegistry` compile unchanged.
@@ -1061,11 +1061,22 @@ interface RegistryRepository {
1061
1061
  name: string;
1062
1062
  url: string;
1063
1063
  }
1064
+ /** Why the registry pointer is excluded from default release selection. */
1065
+ type RegistryLatestDifferenceReason = "DEPRECATED" | "YANKED" | "NO_FILES" | "UNLISTED" | "PRERELEASE_EXCLUDED";
1066
+ interface RegistryLatestDifference {
1067
+ version: string;
1068
+ reason: RegistryLatestDifferenceReason;
1069
+ }
1064
1070
  interface PackageIdentity {
1065
1071
  name: string;
1066
1072
  registry?: string;
1067
1073
  description?: string;
1068
- latestVersion: string;
1074
+ /** Release selected for this overview; absent when no release is selected. */
1075
+ version?: string;
1076
+ publishedAt?: string;
1077
+ registryLatestDifference?: RegistryLatestDifference;
1078
+ /** Registry pointer, which may differ from the selected release. */
1079
+ latestVersion?: string;
1069
1080
  latestVersionPublishedAt?: string;
1070
1081
  homepage?: string;
1071
1082
  repositoryUrl?: string;