@githits/mcp 0.6.2 → 0.6.4

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;

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-179kkbsr.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

@@ -16,7 +16,6 @@ interface BuildMcpInstructionsOptions {
 }
 declare function buildMcpInstructions(options?: BuildMcpInstructionsOptions): string;
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { ToolAnnotations as ToolAnnotations2 } from "@modelcontextprotocol/sdk/types.js";
 /**
 * Registry taxonomy shared by code-navigation and package-intelligence
 * services. Single source of truth for:
@@ -62,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;
@@ -76,6 +79,7 @@ interface TargetResolutionIdentity {
 	repoUrl?: string;
 	gitRef?: string;
 	commitSha?: string;
+	site?: string;
 }
 type AvailableRef = AvailableVersion;
 type SuggestedRef = AvailableVersion;
@@ -94,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;
@@ -104,7 +130,7 @@ interface UnifiedSearchFilters {
 	pathPrefix?: string;
 }
 interface UnifiedSearchParams {
-	targets: CodeNavigationTarget[];
+	targets: UnifiedSearchTarget[];
 	query: string;
 	sources?: UnifiedSearchSource[];
 	filters?: UnifiedSearchFilters;
@@ -173,6 +199,7 @@ interface UnifiedSearchSourceStatus {
 	ignoredQueryFeatures: string[];
 	incompatibleQueryFeatures: string[];
 	note?: string;
+	coverage?: DocCoverage;
 }
 interface UnifiedSearchProgressTarget {
 	requested?: string;
@@ -185,6 +212,7 @@ interface UnifiedSearchProgressTarget {
 	availableVersions?: AvailableVersion[];
 	availableRefs?: AvailableRef[];
 	suggestedRefs?: SuggestedRef[];
+	coverage?: DocCoverage;
 }
 interface UnifiedSearchRequestedTarget {
 	registry?: CodeNavigationRegistry;
@@ -192,6 +220,7 @@ interface UnifiedSearchRequestedTarget {
 	version?: string;
 	repoUrl?: string;
 	gitRef?: string;
+	site?: string;
 }
 interface UnifiedSearchResult {
 	query: string;
@@ -1052,7 +1081,14 @@ interface PackageIntelligenceService {
 	listPackageDocs(params: ListPackageDocsParams): Promise<PackageDocsList>;
 	readPackageDoc(params: ReadPackageDocParams): Promise<PackageDocResult>;
 }
+import { ToolAnnotations } from "@modelcontextprotocol/sdk/types.js";
 import { z } from "zod";
+/** Annotation fields required by OpenAI's MCP marketplace validation. */
+interface CompleteToolAnnotations extends ToolAnnotations {
+	readOnlyHint: boolean;
+	openWorldHint: boolean;
+	destructiveHint: boolean;
+}
 /**
 * Standard result type for all MCP tools
 */
@@ -1066,7 +1102,7 @@ type ToolResult = {
 /**
 * Zod raw shape type (what MCP SDK expects)
 */
-type ZodRawShape = {
+type ZodRawShape2 = {
 	[k: string]: z.ZodTypeAny;
 };
 interface McpAuthActionContext {
@@ -1103,11 +1139,11 @@ 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;
-	annotations?: ToolAnnotations2;
+	annotations: CompleteToolAnnotations;
 }
 declare function getMcpToolDescriptors(): McpToolDescriptor[];
 declare function registerMcpTools<TExtra = unknown>(server: McpServer, options: {