@githits/mcp 0.37.0 → 0.38.1

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
@@ -129,12 +129,17 @@ error result.
129
129
 
130
130
  An injected browser service should throw one of the exported neutral error
131
131
  constructors when it wants `get_example` to return a structured
132
- `AUTH_REQUIRED`, `RATE_LIMITED`, `TIMEOUT`, or `TERMS_ACCEPTANCE_REQUIRED`
132
+ `AUTH_REQUIRED`, `REAUTH_REQUIRED`, `RATE_LIMITED`, `TIMEOUT`, or `TERMS_ACCEPTANCE_REQUIRED`
133
133
  `ToolResult`. This is an explicit thrown-error contract, not automatic HTTP
134
134
  response classification. Callable authentication remediation is host-neutral:
135
135
  `Authenticate with GitHits, then retry.` Terms errors use the canonical
136
136
  `acceptanceUrl` action. Other errors remain `UNKNOWN`.
137
137
 
138
+ `ProviderReauthenticationRequiredError` is exported from `/tools` and `/client`.
139
+ Example search and Research map it to `REAUTH_REQUIRED` with `retryable: false`.
140
+ `details.action` provides sign-in guidance; `details.reauthUrl` contains a validated
141
+ sign-in link when available. Complete sign-in before retrying the request.
142
+
138
143
  A frontend can add a small registration adapter for its WebMCP host API. The
139
144
  adapter owns the host-specific registration call and passes its signal through;
140
145
  the callable surface is not a generic protocol-conversion layer:
package/dist/client.d.ts CHANGED
@@ -131,7 +131,7 @@ declare class AgenticAskServiceImpl implements AgenticAskService {
131
131
  * Back-compat: `src/shared/code-navigation.ts` re-exports these under
132
132
  * the existing `CodeNavigationRegistry*` names.
133
133
  */
134
- declare const PKGSEER_REGISTRY_ARGS: readonly ["npm", "pypi", "hex", "crates", "nuget", "maven", "zig", "vcpkg", "packagist", "rubygems", "go", "swift"];
134
+ declare const PKGSEER_REGISTRY_ARGS: readonly ["npm", "pypi", "hex", "crates", "nuget", "maven", "zig", "vcpkg", "packagist", "rubygems", "go", "swift", "pub"];
135
135
  type PkgseerRegistryArg = (typeof PKGSEER_REGISTRY_ARGS)[number];
136
136
  declare const registryMap: {
137
137
  readonly npm: "NPM";
@@ -146,6 +146,7 @@ declare const registryMap: {
146
146
  readonly rubygems: "RUBYGEMS";
147
147
  readonly go: "GO";
148
148
  readonly swift: "SWIFT";
149
+ readonly pub: "PUB";
149
150
  };
150
151
  type PkgseerRegistry = (typeof registryMap)[keyof typeof registryMap];
151
152
  declare const PKGSEER_REGISTRY_LIST: string;
@@ -1749,7 +1750,8 @@ interface DirectDependency {
1749
1750
  /**
1750
1751
  * Node in a typed dependency graph. Mirrors `DependencyGraphNode`.
1751
1752
  * `registry` is a lowercase string: `"npm"`, `"pypi"`, …, or
1752
- * `"synthetic"` for manifest / project root nodes. `version` is null
1753
+ * `"flutter_sdk"` for SDK nodes, or `"synthetic"` for project root nodes.
1754
+ * These graph namespaces are not package registry inputs. `version` is null
1753
1755
  * for synthetic roots.
1754
1756
  */
1755
1757
  interface DependencyGraphNode {
@@ -2025,6 +2027,14 @@ interface ChangelogStatementContext {
2025
2027
  textTruncated: boolean;
2026
2028
  fullText?: string;
2027
2029
  }
2030
+ interface ChangelogStatementCommit {
2031
+ sha: string;
2032
+ url: string | null;
2033
+ }
2034
+ interface ChangelogStatementGeneration {
2035
+ status: "GENERATED" | "PENDING" | "NOT_GENERATED";
2036
+ reason: string | null;
2037
+ }
2028
2038
  interface ChangelogStatement {
2029
2039
  version: string;
2030
2040
  position: number;
@@ -2033,6 +2043,7 @@ interface ChangelogStatement {
2033
2043
  heading?: string;
2034
2044
  source?: string;
2035
2045
  url?: string;
2046
+ commits?: ChangelogStatementCommit[];
2036
2047
  text: string;
2037
2048
  textTruncated: boolean;
2038
2049
  fullText?: string;
@@ -2048,6 +2059,7 @@ interface ChangelogStatementCoverage {
2048
2059
  statementsNotAssessed: number;
2049
2060
  statementsNoImpact: number;
2050
2061
  statementsUnclassified: number;
2062
+ generation?: ChangelogStatementGeneration;
2051
2063
  }
2052
2064
  interface ChangelogStatements {
2053
2065
  totalCount: number;
@@ -2324,6 +2336,7 @@ interface ResolveTargetParams {
2324
2336
  interface ResolveTargetReference {
2325
2337
  kind: string;
2326
2338
  canonicalKey: string;
2339
+ searchTarget: string;
2327
2340
  confidence: string;
2328
2341
  }
2329
2342
  interface ResolveTargetMatch {
@@ -2336,6 +2349,7 @@ interface ResolveTargetMatch {
2336
2349
  interface ResolveTargetTarget {
2337
2350
  kind: string;
2338
2351
  canonicalKey: string;
2352
+ searchTarget: string;
2339
2353
  displayName?: string;
2340
2354
  description?: string;
2341
2355
  registry?: string;
@@ -2383,4 +2397,10 @@ declare class ResolveTargetServiceImpl implements ResolveTargetService {
2383
2397
  resolveTarget(params: ResolveTargetParams, options?: ServiceRequestOptions): Promise<ResolveTargetResult>;
2384
2398
  private executeResolveTarget;
2385
2399
  }
2386
- 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, GrepInputTargetResolution, GrepLineSlice, GrepNetworkError, GrepParams, GrepPathSelector, GrepPathSuggestion, GrepPathWarning, 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, RegistryRepository, ResolveTargetKind, ResolveTargetLatestVersionMaliciousAdvisory, ResolveTargetLatestVersionMaliciousEvidence, ResolveTargetMatch, ResolveTargetParams, ResolveTargetReference, ResolveTargetResult, ResolveTargetService, ResolveTargetServiceImpl, ResolveTargetTarget, ServiceDiagnostics, ServiceRequestOptions, SessionIdConfigError, TokenProvider, createClientHeaderBuilder, createStaticTokenProvider, getApiUrl, getCodeNavigationUrl, getEnvApiToken, getEnvSessionId, getMcpUrl, toPkgseerRegistry, toPkgseerRegistryLowercase };
2400
+ /** Provider sign-in is separate from refreshing the GitHits session. */
2401
+ declare class ProviderReauthenticationRequiredError extends Error {
2402
+ readonly code = "REAUTH_REQUIRED";
2403
+ readonly reauthUrl: string | undefined;
2404
+ constructor(reauthUrl?: string);
2405
+ }
2406
+ 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, GrepInputTargetResolution, GrepLineSlice, GrepNetworkError, GrepParams, GrepPathSelector, GrepPathSuggestion, GrepPathWarning, 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, ProviderReauthenticationRequiredError, RawCodeDiff, RawCodeDiffContentCoverage, RawCodeDiffContentFailure, RawCodeDiffFile, RawCodeDiffFileContentStatus, RawCodeDiffFileStatus, RawCodeDiffPathEncoding, RawCodeDiffScope, RawCodeDiffScopeStatus, RawCodeDiffSummary, ReadCodeResult, ReadDocsResult, ReadParams, ReadResult, ReadService, ReadServiceImpl, ReadSymbolResolutionResult, ReadTarget, RefreshingGitHitsService, RegistryRepository, 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-07swxbg6.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-jh5qg990.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-rk9w8cvk.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-rxe14jq0.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
@@ -74,6 +74,7 @@ declare const registryMap: {
74
74
  readonly rubygems: "RUBYGEMS";
75
75
  readonly go: "GO";
76
76
  readonly swift: "SWIFT";
77
+ readonly pub: "PUB";
77
78
  };
78
79
  type PkgseerRegistry = (typeof registryMap)[keyof typeof registryMap];
79
80
  interface IndexingDurationEstimate {
@@ -1420,7 +1421,8 @@ interface DirectDependency {
1420
1421
  /**
1421
1422
  * Node in a typed dependency graph. Mirrors `DependencyGraphNode`.
1422
1423
  * `registry` is a lowercase string: `"npm"`, `"pypi"`, …, or
1423
- * `"synthetic"` for manifest / project root nodes. `version` is null
1424
+ * `"flutter_sdk"` for SDK nodes, or `"synthetic"` for project root nodes.
1425
+ * These graph namespaces are not package registry inputs. `version` is null
1424
1426
  * for synthetic roots.
1425
1427
  */
1426
1428
  interface DependencyGraphNode {
@@ -1696,6 +1698,14 @@ interface ChangelogStatementContext {
1696
1698
  textTruncated: boolean;
1697
1699
  fullText?: string;
1698
1700
  }
1701
+ interface ChangelogStatementCommit {
1702
+ sha: string;
1703
+ url: string | null;
1704
+ }
1705
+ interface ChangelogStatementGeneration {
1706
+ status: "GENERATED" | "PENDING" | "NOT_GENERATED";
1707
+ reason: string | null;
1708
+ }
1699
1709
  interface ChangelogStatement {
1700
1710
  version: string;
1701
1711
  position: number;
@@ -1704,6 +1714,7 @@ interface ChangelogStatement {
1704
1714
  heading?: string;
1705
1715
  source?: string;
1706
1716
  url?: string;
1717
+ commits?: ChangelogStatementCommit[];
1707
1718
  text: string;
1708
1719
  textTruncated: boolean;
1709
1720
  fullText?: string;
@@ -1719,6 +1730,7 @@ interface ChangelogStatementCoverage {
1719
1730
  statementsNotAssessed: number;
1720
1731
  statementsNoImpact: number;
1721
1732
  statementsUnclassified: number;
1733
+ generation?: ChangelogStatementGeneration;
1722
1734
  }
1723
1735
  interface ChangelogStatements {
1724
1736
  totalCount: number;
@@ -1913,6 +1925,7 @@ interface ResolveTargetParams {
1913
1925
  interface ResolveTargetReference {
1914
1926
  kind: string;
1915
1927
  canonicalKey: string;
1928
+ searchTarget: string;
1916
1929
  confidence: string;
1917
1930
  }
1918
1931
  interface ResolveTargetMatch {
@@ -1925,6 +1938,7 @@ interface ResolveTargetMatch {
1925
1938
  interface ResolveTargetTarget {
1926
1939
  kind: string;
1927
1940
  canonicalKey: string;
1941
+ searchTarget: string;
1928
1942
  displayName?: string;
1929
1943
  description?: string;
1930
1944
  registry?: string;