@githits/mcp 0.6.3 → 0.9.0

package/dist/client.d.ts

@@ -87,6 +87,10 @@ interface CodeNavigationTarget {
 	repoUrl?: string;
 	gitRef?: string;
 }
+interface UnifiedSearchTarget extends CodeNavigationTarget {
+	/** Standalone documentation site target, canonicalized as `site:<host[/path]>`. */
+	site?: string;
+}
 interface IndexResolution {
 	requestedVersion?: string;
 	requestedRef?: string;
@@ -101,6 +105,7 @@ interface TargetResolutionIdentity {
 	repoUrl?: string;
 	gitRef?: string;
 	commitSha?: string;
+	site?: string;
 }
 type AvailableRef = AvailableVersion;
 type SuggestedRef = AvailableVersion;
@@ -119,8 +124,30 @@ type UnifiedSearchSource = "AUTO" | "DOCS" | "CODE" | "SYMBOL";
 type UnifiedSearchResultType = "DOCUMENTATION_PAGE" | "REPOSITORY_SYMBOL" | "REPOSITORY_CODE" | "REPOSITORY_DOC";
 type UnifiedSearchSessionStatus = "PENDING" | "INDEXING" | "SEARCHING" | "COMPLETED" | "TIMEOUT" | "FAILED";
 type CodeIndexState = "CURRENT" | "INDEXED" | "INDEXING" | "STALE" | "FAILED" | "MISSING" | string;
+/**
+* Coverage lifecycle for crawled documentation site data.
+*
+* `PARTIAL` is transient (a crawl is still running, so retrying later can
+* return more); `CAPPED` is terminal (a crawl limit stopped indexing, so
+* retrying will not help). Both mean served evidence may be incomplete.
+*/
+type DocCoverageState = "NONE" | "PARTIAL" | "CAPPED" | "COMPLETE" | string;
+/**
+* Coverage metadata for crawled documentation site data. Present on docs
+* source status and progress targets when the backend has crawl metadata.
+*/
+interface DocCoverage {
+	coverageState: DocCoverageState;
+	coverageReason?: string;
+	pagesCrawled?: number;
+	frontierRemaining?: number;
+	artifactOverflowPageCount?: number;
+	estimatedTotalPages?: number;
+	/** Backend-owned note suitable for CLI/MCP rendering. Preferred over client wording. */
+	note?: string;
+}
 type DiscoveryRequestedRefKind = "OMITTED_VERSION" | "LATEST_VERSION" | "EXACT_VERSION" | "DEFAULT_BRANCH" | "HEAD" | "BRANCH" | "SHA";
-type DiscoveryTargetMode = "PACKAGES" | "REPO" | "MIXED";
+type DiscoveryTargetMode = "PACKAGES" | "REPO" | "MIXED" | "SITES" | "SITE";
 interface UnifiedSearchFilters {
 	fileIntent?: FileIntent;
 	kind?: SymbolKind;
@@ -129,7 +156,7 @@ interface UnifiedSearchFilters {
 	pathPrefix?: string;
 }
 interface UnifiedSearchParams {
-	targets: CodeNavigationTarget[];
+	targets: UnifiedSearchTarget[];
 	query: string;
 	sources?: UnifiedSearchSource[];
 	filters?: UnifiedSearchFilters;
@@ -198,6 +225,7 @@ interface UnifiedSearchSourceStatus {
 	ignoredQueryFeatures: string[];
 	incompatibleQueryFeatures: string[];
 	note?: string;
+	coverage?: DocCoverage;
 }
 interface UnifiedSearchProgressTarget {
 	requested?: string;
@@ -210,6 +238,7 @@ interface UnifiedSearchProgressTarget {
 	availableVersions?: AvailableVersion[];
 	availableRefs?: AvailableRef[];
 	suggestedRefs?: SuggestedRef[];
+	coverage?: DocCoverage;
 }
 interface UnifiedSearchRequestedTarget {
 	registry?: CodeNavigationRegistry;
@@ -217,6 +246,7 @@ interface UnifiedSearchRequestedTarget {
 	version?: string;
 	repoUrl?: string;
 	gitRef?: string;
+	site?: string;
 }
 interface UnifiedSearchResult {
 	query: string;
@@ -394,7 +424,7 @@ interface GrepRepoResult {
 }
 interface CodeNavigationService {
 	search(params: UnifiedSearchParams): Promise<UnifiedSearchOutcome>;
-	searchStatus(searchRef: string): Promise<UnifiedSearchOutcome>;
+	searchStatus(searchRef: string, waitTimeoutMs?: number): Promise<UnifiedSearchOutcome>;
 	listFiles(params: ListFilesParams): Promise<ListFilesResult>;
 	readFile(params: ReadFileParams): Promise<ReadFileResult>;
 	grepRepo(params: GrepRepoParams): Promise<GrepRepoResult>;
@@ -411,13 +441,12 @@ declare class CodeNavigationServiceImpl implements CodeNavigationService {
 	});
 	private postGraphqlWithTargetResolutionFallback;
 	search(params: UnifiedSearchParams): Promise<UnifiedSearchOutcome>;
-	searchStatus(searchRef: string): Promise<UnifiedSearchOutcome>;
+	searchStatus(searchRef: string, waitTimeoutMs?: number): Promise<UnifiedSearchOutcome>;
 	private executeUnifiedSearch;
 	private executeUnifiedSearchStatus;
 	private createHttpError;
 	private createTransportError;
 	private createGraphQLError;
-	private createIndexingMessage;
 	private normaliseUnifiedSearchOutcome;
 	private normaliseUnifiedSearchResult;
 	private normaliseUnifiedSearchProgress;

package/dist/client.js

@@ -1 +1 @@
-import{CodeNavigationServiceImpl,DEFAULT_API_URL,DEFAULT_CODE_NAV_URL,DEFAULT_MCP_URL,GitHitsServiceImpl,PKGSEER_REGISTRY_LIST,PackageIntelligenceServiceImpl,RefreshingGitHitsService,createClientHeaderBuilder,createStaticTokenProvider,endTelemetrySpan,flushTelemetry,getApiUrl,getCodeNavigationUrl,getEnvApiToken,getMcpUrl,startTelemetrySpan,toPkgseerRegistry,toPkgseerRegistryLowercase,withTelemetrySpan}from"./shared/chunk-q54qd0qb.js";export{withTelemetrySpan,toPkgseerRegistryLowercase,toPkgseerRegistry,startTelemetrySpan,getMcpUrl,getEnvApiToken,getCodeNavigationUrl,getApiUrl,flushTelemetry,endTelemetrySpan,createStaticTokenProvider,createClientHeaderBuilder,RefreshingGitHitsService,PackageIntelligenceServiceImpl,PKGSEER_REGISTRY_LIST,GitHitsServiceImpl,DEFAULT_MCP_URL,DEFAULT_CODE_NAV_URL,DEFAULT_API_URL,CodeNavigationServiceImpl};
+import{CodeNavigationServiceImpl,DEFAULT_API_URL,DEFAULT_CODE_NAV_URL,DEFAULT_MCP_URL,GitHitsServiceImpl,PKGSEER_REGISTRY_LIST,PackageIntelligenceServiceImpl,RefreshingGitHitsService,createClientHeaderBuilder,createStaticTokenProvider,endTelemetrySpan,flushTelemetry,getApiUrl,getCodeNavigationUrl,getEnvApiToken,getMcpUrl,startTelemetrySpan,toPkgseerRegistry,toPkgseerRegistryLowercase,withTelemetrySpan}from"./shared/chunk-k30yatty.js";export{withTelemetrySpan,toPkgseerRegistryLowercase,toPkgseerRegistry,startTelemetrySpan,getMcpUrl,getEnvApiToken,getCodeNavigationUrl,getApiUrl,flushTelemetry,endTelemetrySpan,createStaticTokenProvider,createClientHeaderBuilder,RefreshingGitHitsService,PackageIntelligenceServiceImpl,PKGSEER_REGISTRY_LIST,GitHitsServiceImpl,DEFAULT_MCP_URL,DEFAULT_CODE_NAV_URL,DEFAULT_API_URL,CodeNavigationServiceImpl};

package/dist/index.d.ts

@@ -61,6 +61,10 @@ interface CodeNavigationTarget {
 	repoUrl?: string;
 	gitRef?: string;
 }
+interface UnifiedSearchTarget extends CodeNavigationTarget {
+	/** Standalone documentation site target, canonicalized as `site:<host[/path]>`. */
+	site?: string;
+}
 interface IndexResolution {
 	requestedVersion?: string;
 	requestedRef?: string;
@@ -75,6 +79,7 @@ interface TargetResolutionIdentity {
 	repoUrl?: string;
 	gitRef?: string;
 	commitSha?: string;
+	site?: string;
 }
 type AvailableRef = AvailableVersion;
 type SuggestedRef = AvailableVersion;
@@ -93,8 +98,30 @@ type UnifiedSearchSource = "AUTO" | "DOCS" | "CODE" | "SYMBOL";
 type UnifiedSearchResultType = "DOCUMENTATION_PAGE" | "REPOSITORY_SYMBOL" | "REPOSITORY_CODE" | "REPOSITORY_DOC";
 type UnifiedSearchSessionStatus = "PENDING" | "INDEXING" | "SEARCHING" | "COMPLETED" | "TIMEOUT" | "FAILED";
 type CodeIndexState = "CURRENT" | "INDEXED" | "INDEXING" | "STALE" | "FAILED" | "MISSING" | string;
+/**
+* Coverage lifecycle for crawled documentation site data.
+*
+* `PARTIAL` is transient (a crawl is still running, so retrying later can
+* return more); `CAPPED` is terminal (a crawl limit stopped indexing, so
+* retrying will not help). Both mean served evidence may be incomplete.
+*/
+type DocCoverageState = "NONE" | "PARTIAL" | "CAPPED" | "COMPLETE" | string;
+/**
+* Coverage metadata for crawled documentation site data. Present on docs
+* source status and progress targets when the backend has crawl metadata.
+*/
+interface DocCoverage {
+	coverageState: DocCoverageState;
+	coverageReason?: string;
+	pagesCrawled?: number;
+	frontierRemaining?: number;
+	artifactOverflowPageCount?: number;
+	estimatedTotalPages?: number;
+	/** Backend-owned note suitable for CLI/MCP rendering. Preferred over client wording. */
+	note?: string;
+}
 type DiscoveryRequestedRefKind = "OMITTED_VERSION" | "LATEST_VERSION" | "EXACT_VERSION" | "DEFAULT_BRANCH" | "HEAD" | "BRANCH" | "SHA";
-type DiscoveryTargetMode = "PACKAGES" | "REPO" | "MIXED";
+type DiscoveryTargetMode = "PACKAGES" | "REPO" | "MIXED" | "SITES" | "SITE";
 interface UnifiedSearchFilters {
 	fileIntent?: FileIntent;
 	kind?: SymbolKind;
@@ -103,7 +130,7 @@ interface UnifiedSearchFilters {
 	pathPrefix?: string;
 }
 interface UnifiedSearchParams {
-	targets: CodeNavigationTarget[];
+	targets: UnifiedSearchTarget[];
 	query: string;
 	sources?: UnifiedSearchSource[];
 	filters?: UnifiedSearchFilters;
@@ -172,6 +199,7 @@ interface UnifiedSearchSourceStatus {
 	ignoredQueryFeatures: string[];
 	incompatibleQueryFeatures: string[];
 	note?: string;
+	coverage?: DocCoverage;
 }
 interface UnifiedSearchProgressTarget {
 	requested?: string;
@@ -184,6 +212,7 @@ interface UnifiedSearchProgressTarget {
 	availableVersions?: AvailableVersion[];
 	availableRefs?: AvailableRef[];
 	suggestedRefs?: SuggestedRef[];
+	coverage?: DocCoverage;
 }
 interface UnifiedSearchRequestedTarget {
 	registry?: CodeNavigationRegistry;
@@ -191,6 +220,7 @@ interface UnifiedSearchRequestedTarget {
 	version?: string;
 	repoUrl?: string;
 	gitRef?: string;
+	site?: string;
 }
 interface UnifiedSearchResult {
 	query: string;
@@ -368,7 +398,7 @@ interface GrepRepoResult {
 }
 interface CodeNavigationService {
 	search(params: UnifiedSearchParams): Promise<UnifiedSearchOutcome>;
-	searchStatus(searchRef: string): Promise<UnifiedSearchOutcome>;
+	searchStatus(searchRef: string, waitTimeoutMs?: number): Promise<UnifiedSearchOutcome>;
 	listFiles(params: ListFilesParams): Promise<ListFilesResult>;
 	readFile(params: ReadFileParams): Promise<ReadFileResult>;
 	grepRepo(params: GrepRepoParams): Promise<GrepRepoResult>;
@@ -1072,7 +1102,7 @@ type ToolResult = {
 /**
 * Zod raw shape type (what MCP SDK expects)
 */
-type ZodRawShape = {
+type ZodRawShape2 = {
 	[k: string]: z.ZodTypeAny;
 };
 interface McpAuthActionContext {
@@ -1109,7 +1139,7 @@ interface CreateMcpServerOptions<TExtra = unknown> {
 	instructionOptions?: Parameters<typeof buildMcpInstructions>[0];
 	traceTool?: McpToolExecutionHook;
 }
-interface McpToolDescriptor<TSchema extends ZodRawShape = ZodRawShape> {
+interface McpToolDescriptor<TSchema extends ZodRawShape2 = ZodRawShape2> {
 	name: string;
 	description: string;
 	schema: TSchema;