@githits/mcp 0.9.2 → 0.10.1

package/dist/client.d.ts

@@ -136,15 +136,15 @@ interface TargetResolution {
 }
 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;
+type KnownUnifiedSearchSessionStatus = "PENDING" | "INDEXING" | "SEARCHING" | "COMPLETED" | "DEFERRED" | "TIMEOUT" | "FAILED";
 /**
-* 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.
+* Backend-owned search-session status. Known values have explicit client
+* behavior; future values remain readable instead of invalidating the whole
+* response.
 */
+type UnifiedSearchSessionStatus = KnownUnifiedSearchSessionStatus | (string & {});
+type CodeIndexState = "CURRENT" | "INDEXED" | "INDEXING" | "PROVISIONAL" | "STALE" | "FAILED" | "MISSING" | string;
+/** Coverage state of the selected published documentation corpus. */
 type DocCoverageState = "NONE" | "PARTIAL" | "CAPPED" | "COMPLETE" | string;
 /**
 * Coverage metadata for crawled documentation site data. Present on docs
@@ -154,10 +154,10 @@ interface DocCoverage {
 	coverageState: DocCoverageState;
 	coverageReason?: string;
 	pagesCrawled?: number;
-	frontierRemaining?: number;
+	frontierRemaining?: number | null;
 	artifactOverflowPageCount?: number;
 	estimatedTotalPages?: number;
-	/** Backend-owned note suitable for CLI/MCP rendering. Preferred over client wording. */
+	/** Backend-owned coverage note retained for structured callers. */
 	note?: string;
 }
 type DiscoveryRequestedRefKind = "OMITTED_VERSION" | "LATEST_VERSION" | "EXACT_VERSION" | "DEFAULT_BRANCH" | "HEAD" | "BRANCH" | "SHA";
@@ -242,6 +242,22 @@ interface UnifiedSearchSourceStatus {
 	suggestedSiteTargetsTruncated: boolean;
 	note?: string;
 	coverage?: DocCoverage;
+	contributors?: UnifiedSearchDocumentationContributor[];
+}
+type UnifiedSearchDocumentationContributorKind = "REPOSITORY_DOCS" | "DOCPACK";
+type UnifiedSearchDocumentationContributorState = "SEARCHED" | "READY" | "PENDING" | "UNAVAILABLE";
+type UnifiedSearchDocumentationFreshness = "CURRENT" | "PROVISIONAL" | "STALE";
+/** One physical documentation corpus disclosed for a DOCS source row. */
+interface UnifiedSearchDocumentationContributor {
+	kind: UnifiedSearchDocumentationContributorKind;
+	state: UnifiedSearchDocumentationContributorState;
+	freshness?: UnifiedSearchDocumentationFreshness;
+	resultCount: number;
+	repositoryUrl?: string;
+	commitSha?: string;
+	siteKey?: string;
+	siteUrl?: string;
+	coverage?: DocCoverage;
 }
 interface UnifiedSearchProgressTarget {
 	requested?: string;
@@ -272,6 +288,7 @@ interface UnifiedSearchResult {
 	page: UnifiedSearchPageInfo;
 	partialResults: boolean;
 	sourceStatus: UnifiedSearchSourceStatus[];
+	evidenceNotice?: string;
 }
 interface UnifiedSearchProgress {
 	searchRef: string;
@@ -367,8 +384,10 @@ interface ReadFileResult {
 	availableVersions?: AvailableVersion[];
 }
 /**
-* A package target for CodeDiff. Version resolution belongs to the
-* comparison endpoints, so this target intentionally has no version field.
+* A package-addressing target for a repository-wide CodeDiff. Version
+* resolution belongs to the comparison endpoints, so this target
+* intentionally has no version field. Package addressing resolves repository
+* identity and commits; it does not narrow raw file results to a package path.
 * Target selection uses own-key presence; a `repoUrl` key rejects this shape
 * even when its value is `undefined`.
 */
@@ -402,6 +421,11 @@ interface CodeDiffParams {
 }
 type CodeDiffRefKind = "SHA" | "TAG" | "BRANCH" | "HEAD" | "UNKNOWN";
 type CodeDiffVersionSource = "REGISTRY" | "GIT_HEAD" | "TAG" | "RELEASE";
+/**
+* Effective raw inventory scope. Current successful backends return
+* `REPOSITORY`; `PACKAGE` and `UNKNOWN` remain accepted for compatibility with
+* legacy responses.
+*/
 type RawCodeDiffScopeStatus = "PACKAGE" | "REPOSITORY" | "UNKNOWN";
 type RawCodeDiffFileStatus = "ADDED" | "DELETED" | "MODIFIED";
 type RawCodeDiffPathEncoding = "UTF8" | "BYTE_ESCAPED";
@@ -432,10 +456,15 @@ interface RawCodeDiffSummary {
 	unprojectableFiles: number;
 }
 interface RawCodeDiffScope {
+	/** Scope of returned paths and counts, independent of addressing form. */
 	status: RawCodeDiffScopeStatus;
+	/** Legacy package-scope metadata; absent from current repository results. */
 	fromSubpath?: string;
+	/** Legacy package-scope metadata; absent from current repository results. */
 	toSubpath?: string;
+	/** Caller-supplied repository-relative filter, not verified package scope. */
 	pathPrefix?: string;
+	/** Caller-supplied repository-relative filter, not verified package scope. */
 	pathGlob?: string;
 }
 interface RawCodeDiffContentFailure {
@@ -1448,4 +1477,4 @@ declare function withTelemetrySpan<T>(name: string, operation: () => Promise<T>,
 declare function startTelemetrySpan(name: string, attributes?: TelemetryAttributes): TelemetrySpanHandle | undefined;
 declare function endTelemetrySpan(handle: TelemetrySpanHandle | undefined, attributes?: TelemetryAttributes): void;
 declare function flushTelemetry(exitCode?: number): void;
-export { withTelemetrySpan, toPkgseerRegistryLowercase, toPkgseerRegistry, startTelemetrySpan, getMcpUrl, getEnvApiToken, getCodeNavigationUrl, getApiUrl, flushTelemetry, endTelemetrySpan, createStaticTokenProvider, createClientHeaderBuilder, TokenProvider, RefreshingGitHitsService, RawCodeDiffSummary, RawCodeDiffScopeStatus, RawCodeDiffScope, RawCodeDiffPathEncoding, RawCodeDiffFileStatus, RawCodeDiffFileContentStatus, RawCodeDiffFile, RawCodeDiffContentFailure, RawCodeDiffContentCoverage, RawCodeDiff, PackageIntelligenceServiceImpl, PackageIntelligenceService, PKGSEER_REGISTRY_LIST, GitHitsServiceImpl, GitHitsService, DEFAULT_MCP_URL, DEFAULT_CODE_NAV_URL, DEFAULT_API_URL, ContentSafety, ContentModification, CodeNavigationServiceImpl, CodeNavigationService, CodeDiffVersionSource, CodeDiffTarget, CodeDiffService, CodeDiffResult, CodeDiffRepositoryTarget, CodeDiffRefResolution, CodeDiffRefKind, CodeDiffPartialResult, CodeDiffParams, CodeDiffPackageTarget, CodeDiffPackageInfo, CodeDiffOptions, CodeDiffMode, CodeDiffErrorRef, CodeDiffErrorDetails, CodeDiffError, AgentInfo };
+export { AgentInfo, CodeDiffError, CodeDiffErrorDetails, CodeDiffErrorRef, CodeDiffMode, CodeDiffOptions, CodeDiffPackageInfo, CodeDiffPackageTarget, CodeDiffParams, CodeDiffPartialResult, CodeDiffRefKind, CodeDiffRefResolution, CodeDiffRepositoryTarget, CodeDiffResult, CodeDiffService, CodeDiffTarget, CodeDiffVersionSource, CodeNavigationService, CodeNavigationServiceImpl, ContentModification, ContentSafety, DEFAULT_API_URL, DEFAULT_CODE_NAV_URL, DEFAULT_MCP_URL, GitHitsService, GitHitsServiceImpl, PKGSEER_REGISTRY_LIST, PackageIntelligenceService, PackageIntelligenceServiceImpl, RawCodeDiff, RawCodeDiffContentCoverage, RawCodeDiffContentFailure, RawCodeDiffFile, RawCodeDiffFileContentStatus, RawCodeDiffFileStatus, RawCodeDiffPathEncoding, RawCodeDiffScope, RawCodeDiffScopeStatus, RawCodeDiffSummary, RefreshingGitHitsService, TokenProvider, createClientHeaderBuilder, createStaticTokenProvider, endTelemetrySpan, flushTelemetry, getApiUrl, getCodeNavigationUrl, getEnvApiToken, getMcpUrl, startTelemetrySpan, toPkgseerRegistry, toPkgseerRegistryLowercase, withTelemetrySpan };

package/dist/client.js

@@ -1 +1 @@
-import{CodeDiffError,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-0p63psz9.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,CodeDiffError};
+import{CodeDiffError,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-nxdqknc9.js";export{CodeDiffError,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};

package/dist/index.d.ts

@@ -99,15 +99,15 @@ interface TargetResolution {
 }
 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;
+type KnownUnifiedSearchSessionStatus = "PENDING" | "INDEXING" | "SEARCHING" | "COMPLETED" | "DEFERRED" | "TIMEOUT" | "FAILED";
 /**
-* 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.
+* Backend-owned search-session status. Known values have explicit client
+* behavior; future values remain readable instead of invalidating the whole
+* response.
 */
+type UnifiedSearchSessionStatus = KnownUnifiedSearchSessionStatus | (string & {});
+type CodeIndexState = "CURRENT" | "INDEXED" | "INDEXING" | "PROVISIONAL" | "STALE" | "FAILED" | "MISSING" | string;
+/** Coverage state of the selected published documentation corpus. */
 type DocCoverageState = "NONE" | "PARTIAL" | "CAPPED" | "COMPLETE" | string;
 /**
 * Coverage metadata for crawled documentation site data. Present on docs
@@ -117,10 +117,10 @@ interface DocCoverage {
 	coverageState: DocCoverageState;
 	coverageReason?: string;
 	pagesCrawled?: number;
-	frontierRemaining?: number;
+	frontierRemaining?: number | null;
 	artifactOverflowPageCount?: number;
 	estimatedTotalPages?: number;
-	/** Backend-owned note suitable for CLI/MCP rendering. Preferred over client wording. */
+	/** Backend-owned coverage note retained for structured callers. */
 	note?: string;
 }
 type DiscoveryRequestedRefKind = "OMITTED_VERSION" | "LATEST_VERSION" | "EXACT_VERSION" | "DEFAULT_BRANCH" | "HEAD" | "BRANCH" | "SHA";
@@ -205,6 +205,22 @@ interface UnifiedSearchSourceStatus {
 	suggestedSiteTargetsTruncated: boolean;
 	note?: string;
 	coverage?: DocCoverage;
+	contributors?: UnifiedSearchDocumentationContributor[];
+}
+type UnifiedSearchDocumentationContributorKind = "REPOSITORY_DOCS" | "DOCPACK";
+type UnifiedSearchDocumentationContributorState = "SEARCHED" | "READY" | "PENDING" | "UNAVAILABLE";
+type UnifiedSearchDocumentationFreshness = "CURRENT" | "PROVISIONAL" | "STALE";
+/** One physical documentation corpus disclosed for a DOCS source row. */
+interface UnifiedSearchDocumentationContributor {
+	kind: UnifiedSearchDocumentationContributorKind;
+	state: UnifiedSearchDocumentationContributorState;
+	freshness?: UnifiedSearchDocumentationFreshness;
+	resultCount: number;
+	repositoryUrl?: string;
+	commitSha?: string;
+	siteKey?: string;
+	siteUrl?: string;
+	coverage?: DocCoverage;
 }
 interface UnifiedSearchProgressTarget {
 	requested?: string;
@@ -235,6 +251,7 @@ interface UnifiedSearchResult {
 	page: UnifiedSearchPageInfo;
 	partialResults: boolean;
 	sourceStatus: UnifiedSearchSourceStatus[];
+	evidenceNotice?: string;
 }
 interface UnifiedSearchProgress {
 	searchRef: string;
@@ -1133,7 +1150,11 @@ interface McpServerMetadata {
 interface McpRequestContext<TExtra = unknown> {
 	extra: TExtra | undefined;
 }
-type McpToolServicesProvider<TExtra = unknown> = McpToolServices | ((context: McpRequestContext<TExtra>) => McpToolServices | Promise<McpToolServices>);
+type McpToolServicesProviderFor<
+	TServices extends McpToolServices,
+	TExtra = unknown
+> = TServices | ((context: McpRequestContext<TExtra>) => TServices | Promise<TServices>);
+type McpToolServicesProvider<TExtra = unknown> = McpToolServicesProviderFor<McpToolServices, TExtra>;
 /** Wraps one public MCP tool call without receiving arguments or auth data. */
 type McpToolExecutionHook = (toolName: string, runHandler: () => Promise<ToolResult>) => ToolResult | Promise<ToolResult>;
 interface CreateMcpServerOptions<TExtra = unknown> {
@@ -1160,4 +1181,4 @@ declare function registerMcpTools<TExtra = unknown>(server: McpServer, options:
 * Creates the transport-neutral MCP server with injected services.
 */
 declare function createMcpServer<TExtra = unknown>(options: CreateMcpServerOptions<TExtra>): McpServer;
-export { registerMcpTools, getMcpToolDescriptors, createMcpServer, buildMcpInstructions, McpToolServicesProvider, McpToolServices, McpToolExecutionHook, McpToolDescriptor, McpServerMetadata, McpRequestContext, McpAuthActionContext, McpAuthAction, CreateMcpServerOptions, BuildMcpInstructionsOptions };
+export { BuildMcpInstructionsOptions, CreateMcpServerOptions, McpAuthAction, McpAuthActionContext, McpRequestContext, McpServerMetadata, McpToolDescriptor, McpToolExecutionHook, McpToolServices, McpToolServicesProvider, buildMcpInstructions, createMcpServer, getMcpToolDescriptors, registerMcpTools };