@githits/mcp 0.16.0 → 0.16.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/dist/index.d.ts +1 -5
- package/dist/index.js +51 -19
- package/dist/smoke-test.js +1 -1
- package/package.json +1 -1
package/dist/index.d.ts
CHANGED
|
@@ -1,9 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Build the
|
|
3
|
-
*
|
|
4
|
-
* Emits the core block plus the package/code-tools section.
|
|
5
|
-
* Mirrors `getMcpToolDefinitions` so the instructions stay aligned
|
|
6
|
-
* with the registered tool surface.
|
|
2
|
+
* Build the routing guide returned by `quick_start` and embedded in the skill.
|
|
7
3
|
*/
|
|
8
4
|
interface BuildMcpQuickStartOptions {
|
|
9
5
|
/**
|
package/dist/index.js
CHANGED
|
@@ -1,21 +1,53 @@
|
|
|
1
|
-
import{EXTERNAL_CONTENT_POSTURE,PKG_VULNS_GUARDRAIL,PKG_INFO_GUARDRAIL,PKG_CHANGELOG_GUARDRAIL,PKG_UPGRADE_REVIEW_GUARDRAIL,DOCS_GUARDRAIL,CODE_READ_GUARDRAIL,CODE_GREP_GUARDRAIL,SEARCH_GUARDRAIL,mapTermsAcceptanceError,READ_ONLY_TOOL_ANNOTATIONS,textResult,errorResult,withErrorHandling,mcpMappedErrorResult,addLocalMcpAuthAction,throwIfCallerCancellation,createGetExampleTool2}from"./shared/chunk-9kvwrp49.js";import{CLIENT_UPDATE_REQUIRED_REASON,ClientUpdateRequiredError,PackageIntelligenceAccessError,PackageIntelligenceFeatureFlagRequiredError,PackageIntelligenceNetworkError,PackageIntelligenceBackendError,PackageIntelligenceGraphQLError,PackageIntelligenceTargetNotFoundError,PackageIntelligenceValidationError,PackageIntelligenceVersionNotFoundError,MalformedPackageIntelligenceResponseError,PackageIntelligenceChangelogSourceNotFoundError,PKGSEER_REGISTRY_ARGS,PKGSEER_REGISTRY_LIST2,toPkgseerRegistry2,toPkgseerRegistryLowercase2,isKnownPkgseerRegistryArg,GREP_REPO_SYMBOL_FIELDS,CodeNavigationAccessError,CodeNavigationGraphQLError,CodeNavigationIndexingError,CodeNavigationUnresolvableError,MalformedCodeNavigationResponseError,CodeDiffError2,CodeNavigationTargetNotFoundError,CodeNavigationFileNotFoundError,CodeNavigationVersionNotFoundError,CodeNavigationRefNotFoundError,CodeNavigationValidationError,CodeNavigationFeatureFlagRequiredError,CodeNavigationNetworkError,CodeNavigationBackendError}from"./shared/chunk-kpjbjs3v.js";import{AuthenticationError2}from"./shared/chunk-q07qg1z9.js";var
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
`)}function buildMcpInstructions(options={}){return buildMcpQuickStart(options)}import{McpServer}from"@modelcontextprotocol/sdk/server/mcp.js";import{z as z2}from"zod";class AuthRequiredError extends Error{mcpUrl;constructor(message,mcpUrl){super(message);this.name="AuthRequiredError";this.mcpUrl=mcpUrl}}function mapCodeNavigationError(error){return classify(error)}function classify(error){const termsError=mapTermsAcceptanceError(error);if(termsError)return termsError;if(error instanceof ClientUpdateRequiredError){return buildUpdateRequiredError(error.reason,error.currentVersion)}if(error instanceof CodeDiffError2){return classifyCodeDiffError(error)}if(error instanceof CodeNavigationVersionNotFoundError){const details={};preserveBackendMetadata(details,error.metadata);if(error.packageName)details.package=error.packageName;if(error.requestedVersion){details.requestedVersion=error.requestedVersion}if(error.latestIndexed)details.latestIndexed=error.latestIndexed;if(error.availableVersions&&error.availableVersions.length>0){details.availableVersions=error.availableVersions}return{code:"VERSION_NOT_FOUND",message:error.message,retryable:false,details:Object.keys(details).length>0?details:undefined}}if(error instanceof CodeNavigationTargetNotFoundError){const details={};preserveBackendMetadata(details,error.metadata);if(error.availableVersions&&error.availableVersions.length>0){details.availableVersions=error.availableVersions}if(error.repoUrl)details.repoUrl=error.repoUrl;if(error.requestedRef)details.requestedRef=error.requestedRef;return{code:"NOT_FOUND",message:error.message,retryable:false,details:Object.keys(details).length>0?details:undefined}}if(error instanceof CodeNavigationRefNotFoundError){const details={};preserveBackendMetadata(details,error.metadata);if(error.repoUrl)details.repoUrl=error.repoUrl;if(error.requestedRef)details.requestedRef=error.requestedRef;if(error.availableRefs&&error.availableRefs.length>0){details.availableRefs=error.availableRefs}if(error.suggestedRefs&&error.suggestedRefs.length>0){details.suggestedRefs=error.suggestedRefs}return{code:"REF_NOT_FOUND",message:addRefSuggestions(error.message,error.suggestedRefs),retryable:false,details:Object.keys(details).length>0?details:undefined}}if(error instanceof CodeNavigationFileNotFoundError){return{code:"FILE_NOT_FOUND",message:error.message,retryable:false,details:error.filePath?{filePath:error.filePath}:undefined}}if(error instanceof CodeNavigationIndexingError){const details={};if(error.indexingRef)details.indexingRef=error.indexingRef;if(error.availableVersions&&error.availableVersions.length>0){details.availableVersions=error.availableVersions}if(error.availableRefs&&error.availableRefs.length>0){details.availableRefs=error.availableRefs}if(error.targetResolution){details.targetResolution=error.targetResolution}if(error.indexingEstimate){details.indexingEstimate=error.indexingEstimate}if(error.hint)details.hint=error.hint;return{code:"INDEXING",message:error.message,retryable:true,details:Object.keys(details).length>0?details:undefined}}if(error instanceof CodeNavigationUnresolvableError){return{code:"UNRESOLVABLE",message:error.message,retryable:false}}if(error instanceof CodeNavigationAccessError||error instanceof CodeNavigationFeatureFlagRequiredError){return{code:"ACCESS_DENIED",message:error.message,retryable:false}}if(error instanceof AuthenticationError2||error instanceof AuthRequiredError){return{code:"AUTH_REQUIRED",message:error.message,retryable:false,details:{authSource:error instanceof AuthenticationError2?error.source:"local"}}}if(error instanceof CodeNavigationNetworkError){return{code:"NETWORK",message:error.message,retryable:true}}if(error instanceof CodeNavigationValidationError){return{code:"INVALID_ARGUMENT",message:normalizeBackendMessage(error.message),retryable:false}}if(error instanceof CodeNavigationBackendError){return classifyBackendError(error)}if(error instanceof CodeNavigationGraphQLError){return{code:"BACKEND_ERROR",message:error.message,retryable:false,details:error.code?{graphqlCode:error.code}:undefined}}if(error instanceof MalformedCodeNavigationResponseError){return{code:"PROTOCOL_ERROR",message:error.message,retryable:false}}if(isInvalidArgumentError(error)){return{code:"INVALID_ARGUMENT",message:error.message,retryable:false}}if(error instanceof Error){return{code:"UNKNOWN",message:error.message,retryable:false}}return{code:"UNKNOWN",message:"Unknown error",retryable:false}}function classifyCodeDiffError(error){const details={};const source=error.details;if(source?.side!==undefined)details.side=source.side;if(source?.publishedVersions!==undefined){details.publishedVersions=source.publishedVersions}if(source?.publishedVersionsTruncated!==undefined){details.publishedVersionsTruncated=source.publishedVersionsTruncated}if(source?.availableVersions!==undefined){details.availableVersions=source.availableVersions.map((entry)=>({...entry}))}if(source?.registry!==undefined)details.registry=source.registry;if(source?.retryAfterMs!==undefined){details.retryAfterMs=source.retryAfterMs}if(source?.stage!==undefined)details.stage=source.stage;if(source?.limitKind!==undefined)details.limitKind=source.limitKind;if(source?.repoUrl!==undefined)details.repoUrl=source.repoUrl;if(source?.gitRef!==undefined)details.gitRef=source.gitRef;if(source?.availableRefs!==undefined){details.availableRefs=source.availableRefs.map((entry)=>({...entry}))}if(source?.suggestedRefs!==undefined){details.suggestedRefs=source.suggestedRefs.map((entry)=>({...entry}))}if(source?.refKinds!==undefined)details.refKinds=source.refKinds;if(error.partial!==undefined){details.codeDiffResolution={package:error.partial.package,from:error.partial.fromResolution,to:error.partial.toResolution}}const build=(code,defaultRetryable)=>({code,message:error.message,retryable:source?.retryable??defaultRetryable,details:Object.keys(details).length>0?details:undefined});switch(source?.code){case"VALIDATION_ERROR":return build("INVALID_ARGUMENT",false);case"VERSION_NOT_FOUND":return build("VERSION_NOT_FOUND",false);case"REF_NOT_FOUND":case"AMBIGUOUS_REF":return build("REF_NOT_FOUND",false);case"REPOSITORY_NOT_FOUND":case"PACKAGE_NOT_FOUND":return build("NOT_FOUND",false);case"TIMEOUT":return build("TIMEOUT",true);case"RATE_LIMITED":return build("RATE_LIMITED",true);default:return build("BACKEND_ERROR",false)}}function buildUpdateRequiredError(reason=CLIENT_UPDATE_REQUIRED_REASON,currentVersion){return{code:"UPDATE_REQUIRED",message:`Update required: ${reason}`,retryable:false,details:{reason,updateCommand:"npm i -g githits@latest",...currentVersion?{currentVersion}:{}}}}function classifyBackendError(error){const details={};preserveBackendMetadata(details,error.metadata);if(typeof error.status==="number")details.status=error.status;if(error.graphqlCode)details.graphqlCode=error.graphqlCode;const message=normalizeBackendMessage(error.message);const build=(code,defaultRetryable)=>({code,message,retryable:error.retryable??defaultRetryable,details:Object.keys(details).length>0?details:undefined});switch(error.graphqlCode){case"TIMEOUT":return build("TIMEOUT",true);case"RATE_LIMITED":return build("RATE_LIMITED",true);case"REPOSITORY_NOT_FOUND":return build("NOT_FOUND",false);case"REF_NOT_FOUND":return build("REF_NOT_FOUND",false);case"FILE_PATH_EXCLUDED":return build("FILE_PATH_EXCLUDED",false);case"SOURCE_FILE_INVENTORY_UNKNOWN":return build("SOURCE_FILE_INVENTORY_UNKNOWN",false);case"UPSTREAM_ERROR":return build("BACKEND_ERROR",true);default:return build("BACKEND_ERROR",false)}}function preserveBackendMetadata(details,metadata){if(!metadata)return;if(metadata.hint)details.hint=metadata.hint;if(metadata.filePath)details.filePath=metadata.filePath;if(metadata.exclusionReason){details.exclusionReason=metadata.exclusionReason}if(metadata.availableVersions?.length){details.availableVersions=metadata.availableVersions}if(metadata.availableRefs?.length){details.availableRefs=metadata.availableRefs}if(metadata.suggestedRefs?.length){details.suggestedRefs=metadata.suggestedRefs}if(metadata.targetResolution){details.targetResolution=metadata.targetResolution}if(metadata.indexingEstimate){details.indexingEstimate=metadata.indexingEstimate}}function addRefSuggestions(message,refs){if(!refs||refs.length===0||/did you mean/i.test(message)){return message}const suggestions=refs.slice(0,5).map((entry)=>entry.ref).join(", ");return`${message} Did you mean ${suggestions}?`}function normalizeBackendMessage(message){return message.replace(/extractable literal anchor/g,"extractable literal substring").replace(/at least one literal anchor/g,"at least one literal substring").replace(/literal prefix/g,"literal substring")}function isInvalidArgumentError(error){if(!(error instanceof Error))return false;return error.name.startsWith("Invalid")||error.name.startsWith("Unsupported")}function withGrepFileRecovery(mapped){if(isExactPathAuthorityError(mapped)){return withExactPathAuthorityRecovery(mapped,"grep")}if(mapped.code!=="FILE_NOT_FOUND"||mapped.details?.filePath===undefined){return mapped}const prefix=buildContainingPathPrefix(mapped.details.filePath);const listing=prefix===""?"Use `code_files` without `path_prefix`":`Use \`code_files\` with \`path_prefix: ${JSON.stringify(prefix)}\``;return{...mapped,details:{...mapped.details,action:`${listing} to list valid indexed paths, then pass an emitted \`path\` `+"back to `code_grep`."}}}function isExactPathAuthorityError(mapped){return mapped.code==="FILE_PATH_EXCLUDED"||mapped.code==="SOURCE_FILE_INVENTORY_UNKNOWN"}function withExactPathAuthorityRecovery(mapped,command){if(!isExactPathAuthorityError(mapped)||mapped.details?.filePath===undefined){return mapped}const prefix=buildContainingPathPrefix(mapped.details.filePath);const listing=prefix===""?"Use `code_files` without `path_prefix`":`Use \`code_files\` with \`path_prefix: ${JSON.stringify(prefix)}\``;const reason=mapped.code==="FILE_PATH_EXCLUDED"?"This path is excluded from the indexed source.":"The source inventory cannot verify this path.";return{...mapped,details:{...mapped.details,action:`${reason} ${listing} to list indexed paths available to `+`\`code_${command}\`.`}}}function buildContainingPathPrefix(filePath){const trimmed=filePath.trim();const slash=trimmed.lastIndexOf("/");return slash===-1?"":trimmed.slice(0,slash+1)}function buildPathPrefixSuggestion(requestedPath){const trimmed=requestedPath.trim();if(trimmed==="")return"";if(trimmed.endsWith("/"))return trimmed;const slash=trimmed.lastIndexOf("/");const basename=slash===-1?trimmed:trimmed.slice(slash+1);if(!basename.includes("."))return`${trimmed}/`;return slash===-1?"":trimmed.slice(0,slash+1)}function looksLikeMissingFileMessage(message){const lower=message.toLowerCase();return lower.includes("file not found")||lower.includes("path not found")||lower.includes("path doesn't resolve")||lower.includes("path does not resolve")}var DEFAULT_WAIT_TIMEOUT_MS=20000;var MAX_WAIT_TIMEOUT_MS=60000;var MCP_READ_DEFAULT_SPAN=150;var MCP_READ_MAX_SPAN=300;var FILE_INTENT_ALL=Symbol("FILE_INTENT_ALL");var KNOWN_REGISTRIES=PKGSEER_REGISTRY_ARGS;class UnsupportedRegistryError extends Error{attempted;constructor(attempted){super(`Unsupported registry "${attempted}". Supported: ${PKGSEER_REGISTRY_LIST2}.`);this.attempted=attempted;this.name="UnsupportedRegistryError"}}class InvalidPackageSpecError extends Error{constructor(message){super(message);this.name="InvalidPackageSpecError"}}class InvalidArgumentError extends Error{constructor(message){super(message);this.name="InvalidArgumentError"}}function parsePackageSpec(spec){if(!spec||spec.trim()===""){throw new InvalidPackageSpecError("Package spec cannot be empty. Expected <registry>:<name>[@<version>].")}if(!spec.includes(":")){throw new InvalidPackageSpecError(`Package spec "${spec}" is missing a registry prefix. Expected <registry>:<name>[@<version>]. Supported registries: ${PKGSEER_REGISTRY_LIST2}.`)}const colonIndex=spec.indexOf(":");const potentialRegistry=spec.slice(0,colonIndex).toLowerCase();if(!isKnownRegistry(potentialRegistry)){throw new UnsupportedRegistryError(potentialRegistry)}const registry=potentialRegistry;const registryExplicit=true;const rest=spec.slice(colonIndex+1);const atIndex=rest.lastIndexOf("@");if(atIndex>0){const name=rest.slice(0,atIndex);const version=rest.slice(atIndex+1);if(version===""){throw new InvalidPackageSpecError(`Package spec "${spec}" has a trailing "@" with no version. Omit the "@" or add a version.`)}if(name===""){throw new InvalidPackageSpecError(`Package spec "${spec}" has a version but no name.`)}return{registry,registryExplicit,name,version}}if(rest===""){throw new InvalidPackageSpecError(`Package spec "${spec}" is missing a package name after the registry prefix.`)}return{registry,registryExplicit,name:rest}}function isKnownRegistry(value){return KNOWN_REGISTRIES.includes(value)}var PATTERN_MAX=200;var GREP_REPO_CONTEXT_MIN=0;var GREP_REPO_CONTEXT_MAX=10;var LIMIT_MIN=1;var LIMIT_MAX=1000;var LIMIT_DEFAULT=50;var WAIT_MIN=0;var GREP_REPO_SYMBOL_FIELDS_NOTE=`Hydrate these enclosing-symbol fields on each match; omit for no symbol hydration. Valid values: ${GREP_REPO_SYMBOL_FIELDS.join(", ")}.`;var GREP_REPO_PATTERN_NOTE="Text grep over indexed source files. `literal` (default) does substring matching. `regex` uses RE2 syntax (no lookaround, no backreferences); when scoping the whole target with no path, path_prefix, or glob, the regex must include at least one literal substring the index can use for pre-filtering. Pattern max 200 UTF-8 bytes. Matching is ASCII case-insensitive by default: non-ASCII letters match case-sensitively; pass case_sensitive: true for exact casing. When multiple selectors (`path`, `path_prefix`, `globs`) are combined, they are unioned — a file matches if any selector matches. Use `extensions` to intersect further.";function buildGrepRepoParams(input){const pattern=input.pattern??"";if(pattern.length===0||pattern.trim().length===0){throw new InvalidPackageSpecError("`pattern` is required — pass the text to search for. If you are trying to list files or count files in scope, use `code_files` instead.")}if(Buffer.byteLength(pattern,"utf8")>PATTERN_MAX){throw new InvalidPackageSpecError(`\`pattern\` must be ≤ ${PATTERN_MAX} UTF-8 bytes.`)}const path=normalizeOptionalNonEmpty(input.path,"path");const pathPrefix=normalizeOptionalNonEmpty(input.pathPrefix,"path_prefix");const globs=normalizeStringList(input.globs,"globs");const extensions=normalizeExtensions(input.extensions);const contextLines=normalizeOptionalContext(input.contextLines,"context_lines");const contextLinesBefore=normalizeOptionalContext(input.contextLinesBefore,"context_lines_before");const contextLinesAfter=normalizeOptionalContext(input.contextLinesAfter,"context_lines_after");const resolvedBefore=contextLinesBefore??(contextLines!==undefined?contextLines:0);const resolvedAfter=contextLinesAfter??(contextLines!==undefined?contextLines:0);const maxMatches=normalizeMaxMatches(input.maxMatches);const maxMatchesPerFile=normalizeMaxMatchesPerFile(input.maxMatchesPerFile,maxMatches);const waitTimeoutMs=normalizeWaitTimeoutMs(input.waitTimeoutMs);const cursor=normalizeOptionalNonEmpty(input.cursor,"cursor");const symbolFields=normalizeSymbolFields(input.symbolFields);const pathSelectors=buildPathSelectors({path,pathPrefix,globs});const hasPathSelectors=(pathSelectors?.length??0)>0;return{params:{target:input.target,pattern,patternType:input.patternType==="regex"?"REGEX":input.patternType==="literal"?"LITERAL":undefined,caseSensitive:input.caseSensitive,pathSelectors,extensions,excludeDocFiles:input.excludeDocFiles,excludeTestFiles:input.excludeTestFiles,allowUnscoped:hasPathSelectors?undefined:true,contextLinesBefore:resolvedBefore,contextLinesAfter:resolvedAfter,maxMatches,maxMatchesPerFile,cursor,symbolFields:symbolFields.length>0?symbolFields:undefined,waitTimeoutMs},explicit:{path:path!==undefined,pathPrefix:pathPrefix!==undefined,globs:globs.length>0,extensions:extensions.length>0,patternType:input.patternType!==undefined,caseSensitive:input.caseSensitive!==undefined,excludeDocFiles:input.excludeDocFiles!==undefined,excludeTestFiles:input.excludeTestFiles!==undefined,contextLines:input.contextLines!==undefined,contextLinesBefore:input.contextLinesBefore!==undefined,contextLinesAfter:input.contextLinesAfter!==undefined,maxMatches:input.maxMatches!==undefined,maxMatchesPerFile:input.maxMatchesPerFile!==undefined,cursor:cursor!==undefined,symbolFields:symbolFields.length>0}}}function buildPathSelectors(input){const selectors=[];if(input.path)selectors.push({kind:"EXACT",value:input.path});if(input.pathPrefix){selectors.push({kind:"PREFIX",value:input.pathPrefix})}for(const glob of input.globs){selectors.push({kind:"GLOB",value:glob})}return selectors.length>0?selectors:undefined}function normalizeOptionalNonEmpty(value,_field){if(value===undefined)return;const trimmed=value.trim();return trimmed.length>0?trimmed:undefined}function normalizeStringList(values,field){if(!values)return[];const out=[];for(const value of values){const trimmed=value.trim();if(trimmed.length===0){throw new InvalidPackageSpecError(`\`${field}\` entries cannot be empty.`)}out.push(trimmed)}return out}function normalizeSymbolFields(values){const out=normalizeStringList([...values??[]],"symbol_fields");for(const value of out){if(!GREP_REPO_SYMBOL_FIELDS.includes(value)){throw new InvalidPackageSpecError(`\`symbol_fields\` value must be one of: ${GREP_REPO_SYMBOL_FIELDS.join(", ")}. Got: ${value}.`)}}return out}function normalizeExtensions(values){const out=normalizeStringList(values,"extensions");for(const value of out){if(value.startsWith(".")){throw new InvalidPackageSpecError("`extensions` values must not include a leading dot.")}}return out}function normalizeOptionalContext(value,field){if(value===undefined)return;if(!Number.isInteger(value)||value<GREP_REPO_CONTEXT_MIN||value>GREP_REPO_CONTEXT_MAX){throw new InvalidPackageSpecError(`\`${field}\` must be an integer between ${GREP_REPO_CONTEXT_MIN} and ${GREP_REPO_CONTEXT_MAX}. Got ${value}.`)}return value}function normalizeMaxMatches(value){if(value===undefined)return LIMIT_DEFAULT;if(!Number.isInteger(value)||value<LIMIT_MIN||value>LIMIT_MAX){throw new InvalidPackageSpecError(`\`max_matches\` must be an integer between ${LIMIT_MIN} and ${LIMIT_MAX}. Got ${value}.`)}return value}function normalizeMaxMatchesPerFile(value,maxMatches){if(value===undefined)return maxMatches;if(!Number.isInteger(value)||value<0||value>LIMIT_MAX){throw new InvalidPackageSpecError(`\`max_matches_per_file\` must be an integer between 0 and ${LIMIT_MAX}. Got ${value}.`)}return value}function normalizeWaitTimeoutMs(value){if(value===undefined)return DEFAULT_WAIT_TIMEOUT_MS;if(!Number.isInteger(value)||value<WAIT_MIN||value>MAX_WAIT_TIMEOUT_MS){throw new InvalidPackageSpecError(`\`wait_timeout_ms\` must be an integer between ${WAIT_MIN} and ${MAX_WAIT_TIMEOUT_MS}. Got ${value}.`)}return value}var colors={reset:"\x1B[0m",bold:"\x1B[1m",dim:"\x1B[2m",italic:"\x1B[3m",green:"\x1B[32m",yellow:"\x1B[33m",blue:"\x1B[34m",magenta:"\x1B[35m",cyan:"\x1B[36m",red:"\x1B[31m"};function colorize(text,color,useColors){if(!useColors)return text;return`${colors[color]}${text}${colors.reset}`}function highlight(text,useColors){if(!useColors)return text;return`${colors.bold}${colors.cyan}${text}${colors.reset}`}function highlightMatch(text,useColors){if(!useColors)return text;return`${colors.bold}${colors.yellow}${text}${colors.reset}`}function highlightRanges(text,ranges,useColors){if(!useColors||!text||!ranges||ranges.length===0)return text;const normalised=ranges.filter((range)=>Array.isArray(range)&&range.length===2&&Number.isInteger(range[0])&&Number.isInteger(range[1])).map(([start,end])=>{const safeStart=Math.max(0,Math.min(text.length,start));const safeEnd=Math.max(safeStart,Math.min(text.length,end));return[safeStart,safeEnd]}).filter(([start,end])=>end>start).sort((left,right)=>left[0]-right[0]||left[1]-right[1]);if(normalised.length===0)return text;const merged=[];for(const current of normalised){const previous=merged[merged.length-1];if(!previous||current[0]>previous[1]){merged.push(current);continue}merged[merged.length-1]=[previous[0],Math.max(previous[1],current[1])]}let result="";let cursor=0;for(const[start,end]of merged){if(cursor<start)result+=text.slice(cursor,start);result+=highlightMatch(text.slice(start,end),useColors);cursor=end}if(cursor<text.length)result+=text.slice(cursor);return result}function dim(text,useColors){if(!useColors)return text;return`${colors.dim}${text}${colors.reset}`}function shellQuote(value){return`'${value.replaceAll("'",`'"'"'`)}'`}var GITHUB_OWNER_PATTERN=/^[A-Za-z0-9](?:[A-Za-z0-9-]{0,37}[A-Za-z0-9])?$/;var REPO_PATTERN=/^[A-Za-z0-9._-]+$/;function validComponent(value){return value!=="."&&value!==".."&&REPO_PATTERN.test(value)}function validGithubPath(parts){return parts.length===2&&GITHUB_OWNER_PATTERN.test(parts[0])&&validComponent(parts[1])}function validCodebergPath(parts){return parts.length===2&&parts.every((part)=>/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(part))}var GITLAB_TOP_LEVEL_ROUTE=/^(?:-|\.well-known|404\.html|422\.html|500\.html|502\.html|503\.html|admin|api|apple-touch-icon\.png|assets|dashboard|deploy\.html|explore|favicon\.ico|favicon\.png|files|groups|health_check|help|import|jwt|login|oauth|profile|projects|public|robots\.txt|s|search|sitemap|sitemap\.xml|sitemap\.xml\.gz|slash-command-logo\.png|snippets|unsubscribes|uploads|users|v2)$/i;var GITLAB_PROJECT_ROUTE=/^(?:-|badges|blame|blob|builds|commits|create|create_dir|edit|files|find_file|new|preview|raw|refs|tree|update|wikis)$/i;var GITLAB_MULTI_SEGMENT_ROUTE=/(?:^|\/)(?:environments\/folders|gitlab-lfs\/objects|info\/lfs\/objects)(?:\/|$)/i;function validGitlabPath(parts){return parts.length>=2&&parts.every((part)=>/^[A-Za-z0-9_][A-Za-z0-9._-]*$/.test(part))&&!GITLAB_TOP_LEVEL_ROUTE.test(parts[0])&&parts.slice(1).every((part)=>!GITLAB_PROJECT_ROUTE.test(part))&&!GITLAB_MULTI_SEGMENT_ROUTE.test(parts.slice(1).join("/"))}var PROVIDERS=Object.freeze([Object.freeze({prefix:"github:",host:"github.com",name:"GitHub",path:"owner/repo",allowHttp:true,hostShorthand:true,validatePath:validGithubPath}),Object.freeze({prefix:"codeberg:",host:"codeberg.org",name:"Codeberg",path:"owner/repo",allowHttp:false,hostShorthand:false,validatePath:validCodebergPath}),Object.freeze({prefix:"gitlab:",host:"gitlab.com",name:"GitLab",path:"group[/subgroup...]/project",allowHttp:false,hostShorthand:false,validatePath:validGitlabPath})]);var REPOSITORY_TARGET_ERROR="Repository target must be github:owner/repo, codeberg:owner/repo, or gitlab:group[/subgroup...]/project, or an approved full HTTPS URL, with optional #gitRef or @gitRef suffix.";function normaliseRepositoryTargetSpec(spec){const trimmed=spec.trim();const lower=trimmed.toLowerCase();if(lower.startsWith("http://")||lower.startsWith("https://"))return trimmed;for(const provider of PROVIDERS){if(lower.startsWith(provider.prefix))return`https://${provider.host}/${trimmed.slice(provider.prefix.length)}`;if(provider.hostShorthand&&lower.startsWith(`${provider.host}/`))return`https://${trimmed}`}return}function isRepositoryTargetSpec(spec){return normaliseRepositoryTargetSpec(spec)!==undefined}function parseRepositoryTargetSpec(spec){const normalised=normaliseRepositoryTargetSpec(spec);if(!normalised)throw new InvalidArgumentError(REPOSITORY_TARGET_ERROR);const match=/^(https?):\/\/([^/]+)\/(.*)$/i.exec(normalised);if(!match)throw new InvalidArgumentError(REPOSITORY_TARGET_ERROR);const scheme=match[1];const authority=match[2];const rawPath=match[3];if(authority.includes("@"))throw new InvalidArgumentError("Repository URL targets must not include credentials.");if(/[\\?#\s]/.test(authority))throw new InvalidArgumentError(REPOSITORY_TARGET_ERROR);let host;try{host=new URL(`${scheme}://${authority}`).host}catch{throw new InvalidArgumentError(REPOSITORY_TARGET_ERROR)}const provider=PROVIDERS.find((entry)=>entry.host===host);if(!provider)throw new InvalidArgumentError("Repository URL targets must use github.com, codeberg.org, or gitlab.com; unsupported/self-hosted hosts and nondefault ports are not accepted.");const guidance=`Use ${provider.prefix}${provider.path} with optional #gitRef or @gitRef, or https://${provider.host}/${provider.path}.`;if(scheme.toLowerCase()==="http"&&!provider.allowHttp)throw new InvalidArgumentError(`${provider.name} repository URLs require HTTPS. ${guidance}`);if(rawPath.includes("?"))throw new InvalidArgumentError(`Repository URL targets must not include query parameters. ${guidance}`);if(provider.prefix==="github:"&&!GITHUB_OWNER_PATTERN.test(rawPath.split("/")[0]))throw new InvalidArgumentError(`Repository URL targets must use a valid GitHub owner name. ${guidance}`);const hash=rawPath.indexOf("#");const at=rawPath.indexOf("@");if(at!==-1&&hash!==-1&&at<hash)throw new InvalidArgumentError(`Repository URL targets must use only one ref suffix: #gitRef or @gitRef. ${guidance}`);const delimiter=hash!==-1?hash:at;const path=(delimiter===-1?rawPath:rawPath.slice(0,delimiter)).replace(/\/$/,"");const gitRef=delimiter===-1?undefined:rawPath.slice(delimiter+1);if(gitRef===""||gitRef?.includes("#"))throw new InvalidArgumentError(`Repository refs must be nonempty and use only one ref suffix. ${guidance}`);const parts=path.split("/");if(!provider.validatePath(parts)){if(provider.prefix==="github:"&&parts.length===2)throw new InvalidArgumentError(`Repository URL targets must use a valid GitHub repository name. ${guidance}`);throw new InvalidArgumentError(`Repository URL targets must point to ${provider.host}/${provider.path}; pass refs with #gitRef or @gitRef. ${provider.name} web subpaths are not repository targets. ${guidance}`)}const repoUrl=`https://${provider.host}/${path}`;return gitRef===undefined?{repoUrl}:{repoUrl,gitRef}}function formatRepositoryTarget(repoUrl,gitRef){let compact=repoUrl;try{const parsed=parseRepositoryTargetSpec(repoUrl);if(parsed.repoUrl&&parsed.gitRef===undefined){const url=new URL(parsed.repoUrl);const provider=PROVIDERS.find((entry)=>entry.host===url.host);compact=`${provider.prefix}${url.pathname.slice(1)}`}}catch{}return gitRef?`${compact}#${gitRef}`:compact}function formatRepositoryTargetLabel(label,repoUrl){if(isRepositoryTargetSpec(label)){try{const parsed=parseRepositoryTargetSpec(label);return formatRepositoryTarget(parsed.repoUrl,parsed.gitRef)}catch{return}}if(!repoUrl)return;try{const parsed=parseRepositoryTargetSpec(repoUrl);const path=new URL(parsed.repoUrl).pathname.slice(1);if(label===path)return formatRepositoryTarget(parsed.repoUrl);if(label.startsWith(`${path}@`)&&label.length>path.length+1)return formatRepositoryTarget(parsed.repoUrl,label.slice(path.length+1))}catch{return}return}function buildInvalidTargetSpecError(spec,cause){const prefix=cause?`${cause} `:`Target spec "${spec}" is not recognized. `;return new InvalidArgumentError(`${prefix}Expected package target <registry>:<name>[@<version>] (supported registries: ${KNOWN_REGISTRIES.join(", ")}) or repository target github:owner/repo, codeberg:owner/repo, or gitlab:group[/subgroup...]/project with optional #ref or @ref (approved full HTTPS URLs also accepted; GitHub additionally supports github.com/owner/repo and HTTP).`)}function projectTargetResolution(resolution){if(!resolution)return;return{...resolution.requested?{requested:projectIdentity(resolution.requested)}:{},...resolution.resolvedRequested?{resolvedRequested:projectIdentity(resolution.resolvedRequested)}:{},...resolution.served?{served:projectIdentity(resolution.served)}:{},...resolution.freshness?{freshness:resolution.freshness}:{},...resolution.freshnessReason?{freshnessReason:resolution.freshnessReason}:{},...resolution.indexingRef?{indexingRef:resolution.indexingRef}:{},availableVersions:resolution.availableVersions.map(projectArtifact),availableRefs:resolution.availableRefs.map(projectArtifact),suggestedRefs:(resolution.suggestedRefs??[]).map(projectArtifact)}}function buildTargetResolutionNotes(resolution){if(!resolution)return[];const lines=[];const requested=formatTargetResolutionIdentity(resolution.requested);const fresh=formatTargetResolutionIdentity(resolution.resolvedRequested);const served=formatTargetResolutionIdentity(resolution.served);const reason=formatFreshnessReason(resolution.freshnessReason,resolution.freshness);switch(resolution.freshness){case"fallback_recent":{const parts=[reason??"Using recent indexed snapshot"];if(served)parts.push(`served=${served}`);if(fresh&&identitiesMateriallyDiffer(fresh,served)){parts.push(`fresh=${fresh}`)}lines.push(parts.join(" | "));break}case"indexing":{const parts=[reason??"Fresh target is being indexed"];if(served)parts.push(`served=${served}`);if(requested)parts.push(`requested=${requested}`);if(fresh&&identitiesMateriallyDiffer(fresh,served)){parts.push(`fresh=${fresh}`)}if(resolution.indexingRef)parts.push(`indexingRef=${resolution.indexingRef}`);lines.push(parts.join(" | "));break}case"provisional":{const parts=["provisional (still indexing)"];if(reason)parts.push(reason);if(served)parts.push(`served=${served}`);if(resolution.indexingRef)parts.push(`indexingRef=${resolution.indexingRef}`);lines.push(parts.join(" | "));break}case"unavailable":{const parts=[reason??"Target unavailable"];if(requested)parts.push(`requested=${requested}`);lines.push(parts.join(" | "));break}case"current":{return lines}default:{if(resolution.freshness||identitiesDiffer(requested,fresh,served)){const parts=[`target resolution: ${resolution.freshness??"unknown"}`];if(served)parts.push(`served=${served}`);if(requested)parts.push(`requested=${requested}`);if(fresh&&fresh!==served)parts.push(`fresh=${fresh}`);if(reason)parts.push(reason);lines.push(parts.join(" | "))}break}}const candidates=buildRetryCandidateLine(resolution);if(candidates)lines.push(candidates);const suggestions=buildSuggestedRefsLine(resolution);if(suggestions)lines.push(suggestions);return lines}function formatFreshnessReason(reason,freshness){switch(reason){case undefined:case"exact_current":case"exact_provisional":return;case"no_current_fallback":if(freshness==="fallback_recent"){return"Serving an older indexed snapshot; current target is still being indexed"}return"Fresh target is being indexed; no current snapshot is available yet";case"ref_resolution_deferred":return"Using recent indexed snapshot while branch resolution is deferred";case"requested_ref_indexing":return"Requested ref is being indexed";default:return`freshnessReason=${reason}`}}function buildRetryCandidateLine(resolution){if(!resolution)return;const parts=[];if(resolution.availableVersions.length>0){parts.push(`versions=${resolution.availableVersions.map(formatArtifact).join(",")}`)}if(resolution.availableRefs.length>0){parts.push(`refs=${resolution.availableRefs.map(formatArtifact).join(",")}`)}return parts.length>0?`queryable now: ${parts.join(" | ")}`:undefined}function buildSuggestedRefsLine(resolution){const refs=resolution?.suggestedRefs??[];if(refs.length===0)return;return`suggested refs (may need indexing): ${refs.map(formatArtifact).join(",")}`}function buildResolutionFromRetryCandidates(target){if(!target.availableVersions?.length&&!target.availableRefs?.length&&!target.suggestedRefs?.length){return}return{freshness:target.freshness==="CURRENT"?"current":target.freshness==="PROVISIONAL"?"provisional":target.freshness,indexingRef:target.indexingRef,availableVersions:target.availableVersions??[],availableRefs:target.availableRefs??[],suggestedRefs:target.suggestedRefs??[]}}function projectIdentity(identity){const out={};if(identity.kind)out.kind=identity.kind;if(identity.registry)out.registry=identity.registry;if(identity.packageName)out.packageName=identity.packageName;if(identity.version)out.version=identity.version;if(identity.repoUrl)out.repoUrl=identity.repoUrl;if(identity.gitRef)out.gitRef=identity.gitRef;if(identity.commitSha)out.commitSha=identity.commitSha;if(identity.site)out.site=identity.site;return out}function projectArtifact(artifact){return artifact.version?{version:artifact.version,ref:artifact.ref}:{ref:artifact.ref}}function formatTargetResolutionIdentity(identity){if(!identity)return;if(identity.registry&&identity.packageName){const version=identity.version?`@${identity.version}`:"";const commit=identity.commitSha?`#${shortSha(identity.commitSha)}`:"";return`${identity.registry.toLowerCase()}:${identity.packageName}${version}${commit}`}if(identity.repoUrl){const target=formatRepositoryTarget(identity.repoUrl,identity.gitRef);const commit=identity.commitSha?`@${shortSha(identity.commitSha)}`:"";return`${target}${commit}`}if(identity.site)return identity.site;return identity.gitRef??identity.version??identity.commitSha??identity.kind}function formatArtifact(artifact){return artifact.version?`${artifact.version}@${artifact.ref}`:artifact.ref}function identitiesDiffer(requested,fresh,served){if(!served)return Boolean(requested||fresh);return Boolean(requested&&requested!==served||fresh&&fresh!==served)}function identitiesMateriallyDiffer(left,right){if(!left||!right)return Boolean(left||right);return stripShortCommit(left)!==stripShortCommit(right)}function stripShortCommit(value){return value.replace(/[@#][0-9a-f]{7}$/i,"")}function shortSha(value){return/^[0-9a-f]{12,}$/i.test(value)?value.slice(0,7):value}var SEP=" | ";function renderGrepRepoText(envelope){const lines=[];lines.push(buildHeader(envelope));lines.push("");if(envelope.matches.length===0){lines.push("No matches.");for(const note of buildEmptyGrepGuidance(envelope))lines.push(note);return lines.join(`
|
|
15
|
-
|
|
16
|
-
`)}function buildEmptyGrepGuidance(envelope,surface="mcp"){const lines=[formatEmptyGrepFileCounts(envelope)];const served=formatGrepServedTarget(envelope);if(served)lines.push(served);for(const note of buildTargetResolutionNotes(envelope.targetResolution)){lines.push(note)}const skipNotes=[];if(envelope.binaryFilesSkipped){skipNotes.push(`${envelope.binaryFilesSkipped} binary file(s) skipped`)}if(envelope.filesTooLargeSkipped){skipNotes.push(`${envelope.filesTooLargeSkipped} oversized file(s) skipped`)}if(skipNotes.length>0)lines.push(`Note: ${skipNotes.join(", ")}.`);if(envelope.truncatedReason){const reason=formatTruncationReason(envelope.truncatedReason);lines.push(`Truncated: ${reason}. ${formatTruncationAdvice(envelope.truncatedReason,surface)}`)}if(envelope.hasMore&&envelope.nextCursor){lines.push(surface==="cli"?`More matches available — rerun with --cursor ${shellQuote(envelope.nextCursor)}`:`More matches available. Pass cursor=${envelope.nextCursor} for the next page.`)}else if(envelope.hasMore){lines.push("More matches available.")}if(envelope.truncatedReason||envelope.hasMore)return lines;lines.push("Do not repeat this grep unchanged.");if(envelope.filesInScope===0){lines.push(surface==="cli"?"next: loosen the optional path-prefix argument, --path, --glob, --ext, or exclusion flags.":"next: loosen path, path_prefix, globs, extensions, or exclusion filters.");return lines}const pivots=["shorten or change the pattern"];if(envelope.caseSensitive){pivots.push(surface==="cli"?"drop --case-sensitive":"set case_sensitive: false")}pivots.push(surface==="cli"?"use githits search for conceptual intent":"use search for conceptual intent");lines.push(`next: ${pivots.join("; ")}.`);return lines}function formatEmptyGrepFileCounts(envelope){if(envelope.filesInScope===0){return`files scanned: ${envelope.filesScanned} (no files in scope)`}if(envelope.filesScanned<envelope.filesInScope){return`files: ${envelope.filesInScope} in scope | ${envelope.filesScanned} content-scanned after index pruning`}return`files scanned: ${envelope.filesScanned} (full scope)`}function formatTruncationReason(reason){switch(reason){case"deadline":return"time limit reached";case"max_matches":return"match limit reached";case"max_matches_per_file":return"per-file match limit reached";default:return reason}}function formatTruncationAdvice(reason,surface){if(surface==="cli"){switch(reason){case"max_matches":return"Narrow the file selectors or increase --limit.";case"max_matches_per_file":return"Narrow the file selectors or increase --per-file-limit.";default:return"Narrow the file selectors."}}switch(reason){case"max_matches":return"Pass narrower path/path_prefix/globs or increase max_matches.";case"max_matches_per_file":return"Pass narrower path/path_prefix/globs or increase max_matches_per_file.";default:return"Pass narrower path/path_prefix/globs."}}function formatGrepServedTarget(envelope){const resolved=formatTargetResolutionIdentity(envelope.targetResolution?.served);if(resolved){const state=envelope.targetResolution?.freshness;return`target: served=${resolved}${state?` | state=${state}`:""}`}const servedRef=envelope.indexedVersion??envelope.resolution?.resolvedRef??envelope.gitRef;return servedRef?`target: served=${servedRef}`:undefined}function buildHeader(envelope){const parts=[`code_grep${SEP}${envelope.totalMatches} match${envelope.totalMatches===1?"":"es"} in ${envelope.uniqueFilesMatched} file${envelope.uniqueFilesMatched===1?"":"s"}`];parts.push(`pattern=${quote(envelope.pattern)}`);const flags=[];if(envelope.patternType==="regex")flags.push("regex");if(envelope.caseSensitive)flags.push("case-sensitive");if(flags.length>0)parts.push(flags.join(","));return parts.join(SEP)}function buildTrailer(envelope){const lines=[];if(envelope.truncatedReason){lines.push(`Truncated: ${formatTruncationReason(envelope.truncatedReason)}. ${formatTruncationAdvice(envelope.truncatedReason,"mcp")}`)}if(envelope.hasMore&&envelope.nextCursor){lines.push(`More matches available. Pass cursor=${envelope.nextCursor} for the next page.`)}else if(envelope.hasMore){lines.push("More matches available.")}const skipNotes=[];if(envelope.binaryFilesSkipped){skipNotes.push(`${envelope.binaryFilesSkipped} binary file(s) skipped`)}if(envelope.filesTooLargeSkipped){skipNotes.push(`${envelope.filesTooLargeSkipped} oversized file(s) skipped`)}if(skipNotes.length>0){lines.push(`Note: ${skipNotes.join(", ")}.`)}for(const note of buildTargetResolutionNotes(envelope.targetResolution)){lines.push(note)}return lines}function buildRenderBlocks(matches){if(matches.length===0)return[];const linesByFile=new Map;for(const match of matches){let lineMap=linesByFile.get(match.filePath);if(!lineMap){lineMap=new Map;linesByFile.set(match.filePath,lineMap)}const before=match.contextBefore??[];const beforeStart=match.line-before.length;for(let i=0;i<before.length;i+=1){const lineNumber=beforeStart+i;if(!lineMap.has(lineNumber)){lineMap.set(lineNumber,{lineNumber,content:before[i]??"",isMatch:false})}}lineMap.set(match.line,{lineNumber:match.line,content:match.lineContent,isMatch:true});const after=match.contextAfter??[];for(let i=0;i<after.length;i+=1){const lineNumber=match.line+i+1;if(!lineMap.has(lineNumber)){lineMap.set(lineNumber,{lineNumber,content:after[i]??"",isMatch:false})}}}const blocks=[];for(const[filePath,lineMap]of linesByFile){const sorted=[...lineMap.values()].sort((a,b)=>a.lineNumber-b.lineNumber);let current=[];for(const line of sorted){const previous=current[current.length-1];if(!previous||line.lineNumber===previous.lineNumber+1){current.push(line);continue}blocks.push({filePath,lines:current});current=[line]}if(current.length>0){blocks.push({filePath,lines:current})}}return blocks}function groupBlocksByFile(blocks){const map=new Map;for(const block of blocks){const list=map.get(block.filePath)??[];list.push(block);map.set(block.filePath,list)}return map}function blocksHaveContext(blocks){for(const block of blocks){for(const line of block.lines){if(!line.isMatch)return true}}return false}function widestLineNumberInBlock(block){let max=0;for(const line of block.lines){const len=String(line.lineNumber).length;if(len>max)max=len}return max}function countMatchesByFile(matches){const counts=new Map;for(const match of matches){counts.set(match.filePath,(counts.get(match.filePath)??0)+1)}return counts}function renderLine(line,gutterWidth,useContext){const gutter=String(line.lineNumber).padStart(gutterWidth," ");const sep=!useContext||line.isMatch?":":"-";return` ${gutter}${sep} ${line.content}`}function quote(value){return value.includes('"')?`'${value}'`:`"${value}"`}var UTF8_ENCODER=new TextEncoder;function buildGrepRepoSuccessPayload(result,options){const envelope={pattern:options.pattern,matches:result.matches.map(projectMatch),hasMore:result.hasMore,filesScanned:result.filesScanned,filesInScope:result.filesInScope,totalMatches:result.totalMatches,uniqueFilesMatched:result.uniqueFilesMatched};if(options.patternType!=="literal"){envelope.patternType=options.patternType}if(options.caseSensitive)envelope.caseSensitive=true;if(result.binaryFilesSkipped>0){envelope.binaryFilesSkipped=result.binaryFilesSkipped}if(result.filesTooLargeSkipped>0){envelope.filesTooLargeSkipped=result.filesTooLargeSkipped}if(result.truncatedReason&&result.truncatedReason!=="NONE"){envelope.truncatedReason=result.truncatedReason.toLowerCase()}if(options.registry)envelope.registry=options.registry;if(options.name)envelope.name=options.name;if(options.repoUrl)envelope.repoUrl=options.repoUrl;if(options.gitRef)envelope.gitRef=options.gitRef;if(result.nextCursor)envelope.nextCursor=result.nextCursor;if(result.indexedVersion)envelope.indexedVersion=result.indexedVersion;if(result.resolution){envelope.resolution=projectResolution(result.resolution)}const targetResolution=projectTargetResolution(result.targetResolution);if(targetResolution)envelope.targetResolution=targetResolution;const filter=buildFilterBlock(options);if(filter)envelope.filter=filter;return envelope}function projectMatch(match){const projected={filePath:match.filePath,line:match.line,matchStartByte:match.matchStartByte,matchEndByte:match.matchEndByte,lineContent:match.lineContent};if(match.contextBefore&&match.contextBefore.length>0){projected.contextBefore=match.contextBefore}if(match.contextAfter&&match.contextAfter.length>0){projected.contextAfter=match.contextAfter}if(match.fileContentHash)projected.fileContentHash=match.fileContentHash;if(match.fileIntent)projected.fileIntent=match.fileIntent;if(match.symbol)projected.symbol=match.symbol;return projected}function projectResolution(resolution){if(!resolution)return;const out={};if(resolution.requestedVersion)out.requestedVersion=resolution.requestedVersion;if(resolution.requestedRef)out.requestedRef=resolution.requestedRef;if(resolution.resolvedRef)out.resolvedRef=resolution.resolvedRef;if(resolution.commitSha)out.commitSha=resolution.commitSha;return Object.keys(out).length>0?out:undefined}function buildFilterBlock(options){const filter={};if(options.explicit.path&&options.path)filter.path=options.path;if(options.explicit.pathPrefix&&options.pathPrefix){filter.pathPrefix=options.pathPrefix}if(options.explicit.globs&&options.globs&&options.globs.length>0){filter.globs=options.globs}if(options.explicit.extensions&&options.extensions&&options.extensions.length>0){filter.extensions=options.extensions}if(options.explicit.patternType)filter.patternType=options.patternType;if(options.explicit.caseSensitive){filter.caseSensitive=options.caseSensitive}if(options.explicit.excludeDocFiles){filter.excludeDocFiles=options.excludeDocFiles}if(options.explicit.excludeTestFiles){filter.excludeTestFiles=options.excludeTestFiles}if(options.explicit.contextLines&&options.contextLines!==undefined){filter.contextLines=options.contextLines}if(options.explicit.contextLinesBefore){filter.contextLinesBefore=options.contextLinesBefore}if(options.explicit.contextLinesAfter){filter.contextLinesAfter=options.contextLinesAfter}if(options.explicit.maxMatches)filter.maxMatches=options.maxMatches;if(options.explicit.maxMatchesPerFile&&options.maxMatchesPerFile!==undefined){filter.maxMatchesPerFile=options.maxMatchesPerFile}if(options.explicit.cursor&&options.cursor)filter.cursor=options.cursor;if(options.explicit.symbolFields&&options.symbolFields&&options.symbolFields.length>0){filter.symbolFields=options.symbolFields}return Object.keys(filter).length>0?filter:undefined}import{z}from"zod";var symbolKindMap={function:"FUNCTION",method:"METHOD",constructor:"CONSTRUCTOR",getter:"GETTER",setter:"SETTER",operator:"OPERATOR",class:"CLASS",interface:"INTERFACE",trait:"TRAIT",struct:"STRUCT",enum:"ENUM",record:"RECORD",protocol:"PROTOCOL",extension:"EXTENSION",delegate:"DELEGATE",mixin:"MIXIN",actor:"ACTOR",annotation:"ANNOTATION",type:"TYPE",module:"MODULE",namespace:"NAMESPACE",package:"PACKAGE",object:"OBJECT",field:"FIELD",property:"PROPERTY",event:"EVENT",constant:"CONSTANT",doc_section:"DOC_SECTION"};var symbolCategoryMap={callable:"CALLABLE",type:"TYPE",module:"MODULE",data:"DATA",documentation:"DOCUMENTATION"};var fileIntentMap={production:"PRODUCTION",test:"TEST",benchmark:"BENCHMARK",example:"EXAMPLE",generated:"GENERATED",fixture:"FIXTURE",build:"BUILD",vendor:"VENDOR"};function toCodeNavigationRegistry(registry){return toPkgseerRegistry2(registry)}function toSymbolKind(kind){return kind?symbolKindMap[kind]:undefined}function toSymbolCategory(category){return category?symbolCategoryMap[category]:undefined}function toFileIntent(intent){return intent?fileIntentMap[intent]:undefined}function isKnownFileIntent(value){return value in fileIntentMap}function knownFileIntentList(){return Object.keys(fileIntentMap)}function parseCodeNavigationTargetSpec(spec){const trimmed=spec.trim();if(trimmed.length===0){throw new InvalidArgumentError("Target spec cannot be empty.")}if(isRepositoryTargetSpec(trimmed)){return parseRepositoryTargetSpec(trimmed)}let parsed;try{parsed=parsePackageSpec(trimmed)}catch(error){if(error instanceof InvalidPackageSpecError||error instanceof UnsupportedRegistryError){throw buildInvalidTargetSpecError(trimmed,error.message)}throw error}return{registry:toCodeNavigationRegistry(parsed.registry),packageName:parsed.name,version:parsed.version}}var structuredCodeTargetShape={registry:z.enum(PKGSEER_REGISTRY_ARGS).optional().describe(`Package registry (${PKGSEER_REGISTRY_LIST2}). Required for package scope.`),package_name:z.string().max(255).optional().describe("Package name. Required for package scope."),version:z.string().max(100).optional().describe("Package version, e.g. '4.18.2' (defaults to latest). For package scope only."),repo_url:z.string().optional().describe("Full HTTPS repository URL (GitHub, Codeberg, or GitLab). Required for repo scope. Example: https://github.com/expressjs/express"),git_ref:z.string().optional().describe("Git ref - tag, branch, commit, or HEAD. Omit with repo_url to request the backend-resolved default branch.")};var structuredCodeTargetObject=z.object(structuredCodeTargetShape);var structuredCodeTargetSchema=structuredCodeTargetObject.describe("Target: provide registry + package_name (indexed artifact/manifest-root package scope) or repo_url with optional git_ref (public repository scope for the full repository or sibling packages; omitted ref means default branch intent). Swift package targets use swift:github.com/<owner>/<repo> or swift:gitlab.com/<group>/<project>; Zig package targets use zig:gh/<owner>/<repo> or zig:cb/<owner>/<repo>.");var codeTargetSchema=z.union([structuredCodeTargetSchema,z.string().min(1).describe("Compact target string. Package targets inspect an indexed artifact/manifest root: `npm:react@18.2.0` or `npm:react` for latest release; Swift uses `swift:github.com/<owner>/<repo>` or `swift:gitlab.com/<group>/<project>` and Zig uses `zig:gh/<owner>/<repo>` or `zig:cb/<owner>/<repo>`. Use a public repository target for the full repository or sibling packages: `github:facebook/react`, `codeberg:zigil/decimal`, `gitlab:group/subgroup/project`, or approved full HTTPS URLs (GitHub also accepts `github.com/owner/repo` and HTTP), or any repo form with `#HEAD` / `@HEAD` for a git ref. Output uses canonical `provider:path#ref` form. Codeberg requires owner/repo; GitLab allows nested namespaces. Bare owner/repo, self-hosted URLs, web subpaths, credentials, query strings, empty refs, and mixed suffixes are rejected. Refs may contain / and @.")]);function resolveCodeTarget(target){if(typeof target==="string"){try{return parseCodeNavigationTargetSpec(target)}catch(error){return mappedInvalidTargetResult(error)}}const registry=normaliseOptionalValue(target.registry)?.toLowerCase();const packageName=normaliseOptionalValue(target.package_name);const version=normaliseOptionalValue(target.version);const repoUrl=normaliseOptionalValue(target.repo_url);const gitRef=normaliseOptionalValue(target.git_ref);const hasPackageTarget=registry!==undefined||packageName!==undefined;const hasRepoTarget=repoUrl!==undefined||gitRef!==undefined;if(hasPackageTarget&&hasRepoTarget){return invalidTargetResult("Invalid target: provide either registry + package_name or repo_url with optional git_ref, not both.")}if(!hasPackageTarget&&!hasRepoTarget){return invalidTargetResult("Missing target: provide registry + package_name or repo_url.")}if(hasPackageTarget){if(!registry||!packageName){return invalidTargetResult("Incomplete package target: both registry and package_name are required.")}return{registry:toCodeNavigationRegistry(registry),packageName,version}}if(!repoUrl){return invalidTargetResult("Incomplete repository target: repo_url is required.")}return{repoUrl,gitRef}}function normaliseOptionalValue(value){if(value===undefined)return;const trimmed=value.trim();return trimmed.length>0?trimmed:undefined}function mappedInvalidTargetResult(error){const mapped=mapCodeNavigationError(error);return mcpMappedErrorResult(mapped)}function invalidTargetResult(message){return errorResult(JSON.stringify({error:message,code:"INVALID_ARGUMENT",retryable:false}))}var schema={target:codeTargetSchema,pattern:z2.string().optional().describe(GREP_REPO_PATTERN_NOTE),path:z2.string().optional().describe("Exact file path to grep. Shares the same path vocabulary as `code_read`."),path_prefix:z2.string().optional().describe("Literal directory prefix to scope grep, matching `code_files` / `search` naming."),globs:z2.array(z2.string()).optional().describe("Repeatable glob scopes with real glob semantics (e.g. `src/**/*.ts`)."),extensions:z2.array(z2.string()).optional().describe("Extensions to include, without a leading dot."),pattern_type:z2.enum(["literal","regex"]).optional(),case_sensitive:z2.boolean().optional(),exclude_doc_files:z2.boolean().optional(),exclude_test_files:z2.boolean().optional(),context_lines:z2.number().int().min(GREP_REPO_CONTEXT_MIN).max(GREP_REPO_CONTEXT_MAX).optional().describe(`Context lines on both sides of each match (integer ${GREP_REPO_CONTEXT_MIN}-${GREP_REPO_CONTEXT_MAX}). \`context_lines_before\` or \`context_lines_after\` overrides the corresponding side.`),context_lines_before:z2.number().int().min(GREP_REPO_CONTEXT_MIN).max(GREP_REPO_CONTEXT_MAX).optional().describe(`Context lines before each match (integer ${GREP_REPO_CONTEXT_MIN}-${GREP_REPO_CONTEXT_MAX}). Overrides \`context_lines\` for the before side.`),context_lines_after:z2.number().int().min(GREP_REPO_CONTEXT_MIN).max(GREP_REPO_CONTEXT_MAX).optional().describe(`Context lines after each match (integer ${GREP_REPO_CONTEXT_MIN}-${GREP_REPO_CONTEXT_MAX}). Overrides \`context_lines\` for the after side.`),max_matches:z2.number().optional().describe("Maximum total result limit for this page (1-1000, default 50)."),max_matches_per_file:z2.number().optional().describe("Maximum matches from one file on this page (0-1000, 0 = unlimited). Defaults to max_matches, replacing the backend's smaller hidden default; set a lower value when result diversity across files matters."),cursor:z2.string().optional(),symbol_fields:z2.array(z2.enum(GREP_REPO_SYMBOL_FIELDS)).optional().describe(GREP_REPO_SYMBOL_FIELDS_NOTE),wait_timeout_ms:z2.number().optional().describe("Max milliseconds to wait for indexing (0-60000, default 20000). On an `INDEXING` error envelope, use `details.indexingEstimate` when present to decide whether to wait longer, or pass an already-indexed version/ref from `details.availableVersions` / `details.availableRefs`; `suggestedRefs` are fuzzy hints and may need indexing first."),format:z2.enum(["text","json"]).default("text").describe("Use `text` (default) for reading and tool follow-ups; it is token-efficient. Use `json` only to parse responses in code or obtain fields absent from text.")};var DESCRIPTION="Find text, regex, or identifier matches in a public repo or package. Results cover known exact literals, regexes, identifiers, and call sites; they are deterministic and paginated. "+'Use this when you know the pattern (literal by default; pass `pattern_type: "regex"` for RE2). '+"Use `search` for conceptual or open-ended discovery; use `code_read` to inspect a matched file window and `code_files` to enumerate paths. "+"Whole-target grep is the default — narrow with `path`, `path_prefix`, `globs`, or `extensions` to keep responses small. "+"Each match's `filePath` (or text file heading) chains into `code_read.path`; pick a window around `match.line` for `code_read.start_line` / `end_line`. "+"When an exact path returns `FILE_NOT_FOUND`, `FILE_PATH_EXCLUDED`, or `SOURCE_FILE_INVENTORY_UNKNOWN`, follow `details.action` to inspect paths available through `code_files`. "+"When fresh data is not ready within the wait window, responses may include `targetResolution` provenance, `indexingEstimate`, and immediately-queryable alternatives in error details. "+"`availableVersions` and `availableRefs` are already indexed/queryable; `suggestedRefs` are fuzzy ref hints and may need indexing first."+`
|
|
17
|
-
|
|
18
|
-
${CODE_GREP_GUARDRAIL}`;function createGrepRepoTool(service){return{name:"code_grep",description:DESCRIPTION,schema,annotations:READ_ONLY_TOOL_ANNOTATIONS,handler:async(args,context)=>{const target=resolveCodeTarget(args.target);if("content"in target)return target;try{const build=buildGrepRepoParams({target,pattern:args.pattern,path:args.path,pathPrefix:args.path_prefix,globs:args.globs,extensions:args.extensions,patternType:args.pattern_type,caseSensitive:args.case_sensitive,excludeDocFiles:args.exclude_doc_files,excludeTestFiles:args.exclude_test_files,contextLines:args.context_lines,contextLinesBefore:args.context_lines_before,contextLinesAfter:args.context_lines_after,maxMatches:args.max_matches,maxMatchesPerFile:args.max_matches_per_file,cursor:args.cursor,symbolFields:args.symbol_fields,waitTimeoutMs:args.wait_timeout_ms});const result=await service.grepRepo(build.params);const payload=buildGrepRepoSuccessPayload(result,{registry:target.registry?toPkgseerRegistryLowercase2(target.registry):undefined,name:target.packageName,repoUrl:target.repoUrl,gitRef:target.gitRef,pattern:build.params.pattern,patternType:build.params.patternType==="REGEX"?"regex":"literal",caseSensitive:build.params.caseSensitive??false,path:args.path,pathPrefix:args.path_prefix,globs:args.globs,extensions:args.extensions,contextLines:args.context_lines,contextLinesBefore:build.params.contextLinesBefore??0,contextLinesAfter:build.params.contextLinesAfter??0,maxMatches:build.params.maxMatches??50,maxMatchesPerFile:build.params.maxMatchesPerFile,cursor:args.cursor,symbolFields:build.params.symbolFields,excludeDocFiles:build.params.excludeDocFiles,excludeTestFiles:build.params.excludeTestFiles,explicit:build.explicit});if(isTextFormat(args.format)){return textResult(renderGrepRepoText(payload))}return textResult(JSON.stringify(payload))}catch(error){throwIfCallerCancellation(error,context?.signal);const mapped=withGrepFileRecovery(mapCodeNavigationError(error));return mcpMappedErrorResult(mapped,context)}}}}function isTextFormat(format){return format===undefined||format==="text"}import{z as z3}from"zod";var LIMIT_MIN2=1;var LIMIT_MAX2=1000;var LIMIT_DEFAULT2=200;var WAIT_MIN2=0;function buildListFilesParams(input){const limitExplicit=input.limit!==undefined;const limit=normaliseLimit(input.limit);const waitTimeoutMs=normaliseWaitTimeoutMs(input.waitTimeoutMs);const path=normalizeOptionalNonEmpty2(input.path,"path");const pathPrefix=normalisePathPrefix(input.pathPrefix);const globs=normalizeStringList2(input.globs,"globs");const extensions=normalizeExtensions2(input.extensions);const fileTypes=normalizeStringList2(input.fileTypes,"file_types");const languages=normalizeStringList2(input.languages,"languages");const{fileIntent,fileIntentEcho}=normalizeOptionalFileIntent(input.fileIntent,"file_intent");const fileIntents=normalizeFileIntentList(input.fileIntents,"file_intents");const excludeFileIntents=normalizeFileIntentList(input.excludeFileIntents,"exclude_file_intents");if(fileIntent&&fileIntents.length>0){throw new InvalidPackageSpecError("`file_intent` cannot be combined with `file_intents`.")}const pathSelectors=buildPathSelectors2({path,globs});const pathExplicit=path!==undefined;const pathPrefixExplicit=pathPrefix!==undefined;const globsExplicit=globs.length>0;return{params:{target:input.target,pathSelectors,pathPrefix,extensions:extensions.length>0?extensions:undefined,fileTypes:fileTypes.length>0?fileTypes:undefined,languages:languages.length>0?languages:undefined,fileIntent,fileIntents:fileIntents.length>0?fileIntents:undefined,excludeFileIntents:excludeFileIntents.length>0?excludeFileIntents:undefined,excludeDocFiles:input.excludeDocFiles,excludeTestFiles:input.excludeTestFiles,includeHidden:input.includeHidden,limit,waitTimeoutMs},effectiveLimit:limit,limitExplicit,explicit:{path:pathExplicit,pathPrefix:pathPrefixExplicit,globs:globsExplicit,extensions:extensions.length>0,fileTypes:fileTypes.length>0,languages:languages.length>0,fileIntent:fileIntent!==undefined,fileIntents:fileIntents.length>0,excludeFileIntents:excludeFileIntents.length>0,excludeDocFiles:input.excludeDocFiles!==undefined,excludeTestFiles:input.excludeTestFiles!==undefined,includeHidden:input.includeHidden!==undefined,limit:limitExplicit},filterEcho:{path,pathPrefix,globs:globsExplicit?globs:undefined,extensions:extensions.length>0?extensions:undefined,fileTypes:fileTypes.length>0?fileTypes:undefined,languages:languages.length>0?languages:undefined,fileIntent:fileIntentEcho,fileIntents:fileIntents.length>0?fileIntents.map((intent)=>intent.toLowerCase()):undefined,excludeFileIntents:excludeFileIntents.length>0?excludeFileIntents.map((intent)=>intent.toLowerCase()):undefined,excludeDocFiles:input.excludeDocFiles,excludeTestFiles:input.excludeTestFiles,includeHidden:input.includeHidden,limit:limitExplicit?limit:undefined}}}function buildPathSelectors2(input){const selectors=[];if(input.path)selectors.push({kind:"EXACT",value:input.path});for(const glob of input.globs){selectors.push({kind:"GLOB",value:glob})}return selectors.length>0?selectors:undefined}function normalizeOptionalNonEmpty2(raw,_field){if(raw===undefined)return;const trimmed=raw.trim();return trimmed.length>0?trimmed:undefined}function normalizeStringList2(raw,field){if(!raw)return[];const values=[];for(const entry of raw){const trimmed=entry.trim();if(trimmed.length===0){throw new InvalidPackageSpecError(`\`${field}\` entries cannot be empty.`)}values.push(trimmed)}return values}function normalizeExtensions2(raw){const values=normalizeStringList2(raw,"extensions");for(const value of values){if(value.startsWith(".")){throw new InvalidPackageSpecError("`extensions` values must not include a leading dot.")}}return values}function normalizeOptionalFileIntent(raw,field){if(raw===undefined)return{};const trimmed=raw.trim().toLowerCase();if(trimmed.length===0)return{};if(!isKnownFileIntent(trimmed)){throw new InvalidPackageSpecError(`\`${field}\` must be one of: ${knownFileIntentList().join(", ")}. Got ${raw}.`)}return{fileIntent:toFileIntent(trimmed),fileIntentEcho:trimmed}}function normalizeFileIntentList(raw,field){const values=normalizeStringList2(raw,field);const intents=[];for(const value of values){const lower=value.toLowerCase();if(!isKnownFileIntent(lower)){throw new InvalidPackageSpecError(`\`${field}\` values must be one of: ${knownFileIntentList().join(", ")}. Got ${value}.`)}intents.push(toFileIntent(lower))}return intents}function normaliseLimit(raw){if(raw===undefined)return LIMIT_DEFAULT2;if(!Number.isInteger(raw)||raw<LIMIT_MIN2||raw>LIMIT_MAX2){throw new InvalidPackageSpecError(`\`limit\` must be an integer between ${LIMIT_MIN2} and ${LIMIT_MAX2}. Got ${raw}.`)}return raw}function normaliseWaitTimeoutMs(raw){if(raw===undefined)return DEFAULT_WAIT_TIMEOUT_MS;if(!Number.isInteger(raw)||raw<WAIT_MIN2||raw>MAX_WAIT_TIMEOUT_MS){throw new InvalidPackageSpecError(`\`wait_timeout_ms\` must be an integer between ${WAIT_MIN2} and ${MAX_WAIT_TIMEOUT_MS}. Got ${raw}.`)}return raw}function normalisePathPrefix(raw){if(raw===undefined)return;const trimmed=raw.trim();return trimmed.length>0?trimmed:undefined}var getCodePointsLength=(()=>{const SURROGATE_PAIR_RE=/[\uD800-\uDBFF][\uDC00-\uDFFF]/g;return(input)=>{let surrogatePairsNr=0;SURROGATE_PAIR_RE.lastIndex=0;while(SURROGATE_PAIR_RE.test(input)){surrogatePairsNr+=1}return input.length-surrogatePairsNr}})();var isFullWidth=(x)=>{return x===12288||x>=65281&&x<=65376||x>=65504&&x<=65510};var isWideNotCJKTNotEmoji=(x)=>{return x===8987||x===9001||x>=12272&&x<=12287||x>=12289&&x<=12350||x>=12441&&x<=12543||x>=12549&&x<=12591||x>=12593&&x<=12686||x>=12688&&x<=12771||x>=12783&&x<=12830||x>=12832&&x<=12871||x>=12880&&x<=19903||x>=65040&&x<=65049||x>=65072&&x<=65106||x>=65108&&x<=65126||x>=65128&&x<=65131||x>=127488&&x<=127490||x>=127504&&x<=127547||x>=127552&&x<=127560||x>=131072&&x<=196605||x>=196608&&x<=262141};var ANSI_RE=/[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]|\u001b\]8;[^;]*;.*?(?:\u0007|\u001b\u005c)/y;var CONTROL_RE=/[\x00-\x08\x0A-\x1F\x7F-\x9F]{1,1000}/y;var CJKT_WIDE_RE=/(?:(?![\uFF61-\uFF9F\uFF00-\uFFEF])[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}\p{Script=Tangut}]){1,1000}/yu;var TAB_RE=/\t{1,1000}/y;var EMOJI_RE=/[\u{1F1E6}-\u{1F1FF}]{2}|\u{1F3F4}[\u{E0061}-\u{E007A}]{2}[\u{E0030}-\u{E0039}\u{E0061}-\u{E007A}]{1,3}\u{E007F}|(?:\p{Emoji}\uFE0F\u20E3?|\p{Emoji_Modifier_Base}\p{Emoji_Modifier}?|\p{Emoji_Presentation})(?:\u200D(?:\p{Emoji_Modifier_Base}\p{Emoji_Modifier}?|\p{Emoji_Presentation}|\p{Emoji}\uFE0F\u20E3?))*/yu;var LATIN_RE=/(?:[\x20-\x7E\xA0-\xFF](?!\uFE0F)){1,1000}/y;var MODIFIER_RE=/\p{M}+/gu;var NO_TRUNCATION={limit:Infinity,ellipsis:""};var getStringTruncatedWidth=(input,truncationOptions={},widthOptions={})=>{const LIMIT=truncationOptions.limit??Infinity;const ELLIPSIS=truncationOptions.ellipsis??"";const ELLIPSIS_WIDTH=truncationOptions?.ellipsisWidth??(ELLIPSIS?getStringTruncatedWidth(ELLIPSIS,NO_TRUNCATION,widthOptions).width:0);const ANSI_WIDTH=0;const CONTROL_WIDTH=widthOptions.controlWidth??0;const TAB_WIDTH=widthOptions.tabWidth??8;const EMOJI_WIDTH=widthOptions.emojiWidth??2;const FULL_WIDTH_WIDTH=2;const REGULAR_WIDTH=widthOptions.regularWidth??1;const WIDE_WIDTH=widthOptions.wideWidth??FULL_WIDTH_WIDTH;const PARSE_BLOCKS=[[LATIN_RE,REGULAR_WIDTH],[ANSI_RE,ANSI_WIDTH],[CONTROL_RE,CONTROL_WIDTH],[TAB_RE,TAB_WIDTH],[EMOJI_RE,EMOJI_WIDTH],[CJKT_WIDE_RE,WIDE_WIDTH]];let indexPrev=0;let index=0;let length=input.length;let lengthExtra=0;let truncationEnabled=false;let truncationIndex=length;let truncationLimit=Math.max(0,LIMIT-ELLIPSIS_WIDTH);let unmatchedStart=0;let unmatchedEnd=0;let width=0;let widthExtra=0;outer:while(true){if(unmatchedEnd>unmatchedStart||index>=length&&index>indexPrev){const unmatched=input.slice(unmatchedStart,unmatchedEnd)||input.slice(indexPrev,index);lengthExtra=0;for(const char of unmatched.replaceAll(MODIFIER_RE,"")){const codePoint=char.codePointAt(0)||0;if(isFullWidth(codePoint)){widthExtra=FULL_WIDTH_WIDTH}else if(isWideNotCJKTNotEmoji(codePoint)){widthExtra=WIDE_WIDTH}else{widthExtra=REGULAR_WIDTH}if(width+widthExtra>truncationLimit){truncationIndex=Math.min(truncationIndex,Math.max(unmatchedStart,indexPrev)+lengthExtra)}if(width+widthExtra>LIMIT){truncationEnabled=true;break outer}lengthExtra+=char.length;width+=widthExtra}unmatchedStart=unmatchedEnd=0}if(index>=length){break outer}for(let i=0,l=PARSE_BLOCKS.length;i<l;i++){const[BLOCK_RE,BLOCK_WIDTH]=PARSE_BLOCKS[i];BLOCK_RE.lastIndex=index;if(BLOCK_RE.test(input)){lengthExtra=BLOCK_RE===CJKT_WIDE_RE?getCodePointsLength(input.slice(index,BLOCK_RE.lastIndex)):BLOCK_RE===EMOJI_RE?1:BLOCK_RE.lastIndex-index;widthExtra=lengthExtra*BLOCK_WIDTH;if(width+widthExtra>truncationLimit){truncationIndex=Math.min(truncationIndex,index+Math.floor((truncationLimit-width)/BLOCK_WIDTH))}if(width+widthExtra>LIMIT){truncationEnabled=true;break outer}width+=widthExtra;unmatchedStart=indexPrev;unmatchedEnd=index;index=indexPrev=BLOCK_RE.lastIndex;continue outer}}index+=1}return{width:truncationEnabled?truncationLimit:width,index:truncationEnabled?truncationIndex:length,truncated:truncationEnabled,ellipsed:truncationEnabled&&LIMIT>=ELLIPSIS_WIDTH}};var dist_default=getStringTruncatedWidth;var NO_TRUNCATION2={limit:Infinity,ellipsis:"",ellipsisWidth:0};var fastStringWidth=(input,options={})=>{return dist_default(input,NO_TRUNCATION2,options).width};var dist_default2=fastStringWidth;function terminalWidth(text){return dist_default2(text)}function buildListFilesSuccessPayload(result,options){const files=result.files.map((entry)=>projectEntry(entry));const envelope={total:result.total,hasMore:result.hasMore,files};if(options.registry)envelope.registry=options.registry;if(options.name)envelope.name=options.name;if(options.repoUrl)envelope.repoUrl=options.repoUrl;if(options.gitRef)envelope.gitRef=options.gitRef;if(result.indexedVersion)envelope.indexedVersion=result.indexedVersion;if(result.resolution)envelope.resolution=projectResolution2(result.resolution);const targetResolution=projectTargetResolution(result.targetResolution);if(targetResolution)envelope.targetResolution=targetResolution;if(result.hint)envelope.hint=result.hint;const filter=buildFilterBlock2(options);if(filter)envelope.filter=filter;return envelope}function projectEntry(entry){const lean={path:entry.path};if(entry.name!=null)lean.name=entry.name;if(entry.language!=null)lean.language=entry.language;if(entry.fileType!=null)lean.fileType=entry.fileType;if(entry.byteSize!=null)lean.byteSize=entry.byteSize;return lean}function projectResolution2(resolution){if(!resolution)return;const lean={};if(resolution.requestedVersion)lean.requestedVersion=resolution.requestedVersion;if(resolution.requestedRef)lean.requestedRef=resolution.requestedRef;if(resolution.resolvedRef)lean.resolvedRef=resolution.resolvedRef;if(resolution.commitSha)lean.commitSha=resolution.commitSha;return Object.keys(lean).length>0?lean:undefined}function buildFilterBlock2(options){const filter={};if(options.explicit.path&&options.path){filter.path=options.path}if(options.explicit.pathPrefix&&options.pathPrefix){filter.pathPrefix=options.pathPrefix}if(options.explicit.globs&&options.globs&&options.globs.length>0){filter.globs=options.globs}if(options.explicit.extensions&&options.extensions&&options.extensions.length>0){filter.extensions=options.extensions}if(options.explicit.fileTypes&&options.fileTypes&&options.fileTypes.length>0){filter.fileTypes=options.fileTypes}if(options.explicit.languages&&options.languages&&options.languages.length>0){filter.languages=options.languages}if(options.explicit.fileIntent&&options.fileIntent){filter.fileIntent=options.fileIntent}if(options.explicit.fileIntents&&options.fileIntents&&options.fileIntents.length>0){filter.fileIntents=options.fileIntents}if(options.explicit.excludeFileIntents&&options.excludeFileIntents&&options.excludeFileIntents.length>0){filter.excludeFileIntents=options.excludeFileIntents}if(options.explicit.excludeDocFiles){filter.excludeDocFiles=options.excludeDocFiles}if(options.explicit.excludeTestFiles){filter.excludeTestFiles=options.excludeTestFiles}if(options.explicit.includeHidden){filter.includeHidden=options.includeHidden}if(options.explicit.limit&&options.limit!==undefined){filter.limit=options.limit}return Object.keys(filter).length>0?filter:undefined}var SEP2=" | ";function renderListFilesText(envelope){const lines=[];lines.push(buildHeader2(envelope));lines.push("");if(envelope.files.length===0){lines.push(envelope.hint??"No files match the requested filter.");appendTargetResolutionNotes(lines,envelope);return lines.join(`
|
|
1
|
+
import{EXTERNAL_CONTENT_POSTURE,PKG_VULNS_GUARDRAIL,PKG_INFO_GUARDRAIL,PKG_CHANGELOG_GUARDRAIL,PKG_UPGRADE_REVIEW_GUARDRAIL,DOCS_GUARDRAIL,CODE_READ_GUARDRAIL,CODE_GREP_GUARDRAIL,SEARCH_GUARDRAIL,mapTermsAcceptanceError,READ_ONLY_TOOL_ANNOTATIONS,textResult,errorResult,withErrorHandling,mcpMappedErrorResult,addLocalMcpAuthAction,throwIfCallerCancellation,createGetExampleTool2}from"./shared/chunk-9kvwrp49.js";import{CLIENT_UPDATE_REQUIRED_REASON,ClientUpdateRequiredError,PackageIntelligenceAccessError,PackageIntelligenceFeatureFlagRequiredError,PackageIntelligenceNetworkError,PackageIntelligenceBackendError,PackageIntelligenceGraphQLError,PackageIntelligenceTargetNotFoundError,PackageIntelligenceValidationError,PackageIntelligenceVersionNotFoundError,MalformedPackageIntelligenceResponseError,PackageIntelligenceChangelogSourceNotFoundError,PKGSEER_REGISTRY_ARGS,PKGSEER_REGISTRY_LIST2,toPkgseerRegistry2,toPkgseerRegistryLowercase2,isKnownPkgseerRegistryArg,GREP_REPO_SYMBOL_FIELDS,CodeNavigationAccessError,CodeNavigationGraphQLError,CodeNavigationIndexingError,CodeNavigationUnresolvableError,MalformedCodeNavigationResponseError,CodeDiffError2,CodeNavigationTargetNotFoundError,CodeNavigationFileNotFoundError,CodeNavigationVersionNotFoundError,CodeNavigationRefNotFoundError,CodeNavigationValidationError,CodeNavigationFeatureFlagRequiredError,CodeNavigationNetworkError,CodeNavigationBackendError}from"./shared/chunk-kpjbjs3v.js";import{AuthenticationError2}from"./shared/chunk-q07qg1z9.js";var ROUTING_GUIDE=`# GitHits routing guide
|
|
2
|
+
|
|
3
|
+
Choose the route matching the user's question below. Then discover the named
|
|
4
|
+
tool and read its argument description before calling it. This guide supplies
|
|
5
|
+
the routing decision; the selected tool supplies its argument details.
|
|
6
|
+
|
|
7
|
+
| Question | Tool to discover |
|
|
8
|
+
| --- | --- |
|
|
9
|
+
| Find a known literal or regex in a public repository/package | \`code_grep\` |
|
|
10
|
+
| Find relevant source, symbols, tests, or documentation for a topic | \`search\` |
|
|
11
|
+
| List paths or browse a source directory | \`code_files\` |
|
|
12
|
+
| Read a known exact source file or matched lines | \`code_read\` |
|
|
13
|
+
| Browse package documentation pages | \`docs_list\` |
|
|
14
|
+
| Read a documentation page returned by search or docs_list | \`docs_read\` |
|
|
15
|
+
| Assess a package's license, adoption, maintenance, or overall health | \`pkg_info\` |
|
|
16
|
+
| Inspect vulnerabilities in a package or version | \`pkg_vulns\` |
|
|
17
|
+
| Inspect direct dependencies or transitive footprint | \`pkg_deps\` |
|
|
18
|
+
| Find release notes for a package or repository | \`pkg_changelog\` |
|
|
19
|
+
| Compare current and target dependency versions for an upgrade | \`pkg_upgrade_review\` |
|
|
20
|
+
| Find canonical implementation examples across projects | \`get_example\` |
|
|
21
|
+
| Check progress of an earlier search reference | \`search_status\` |
|
|
22
|
+
|
|
23
|
+
Use \`search_language\` only if \`get_example\` needs language disambiguation. For comparative questions, combine
|
|
24
|
+
the relevant package/source route with examples when needed.
|
|
25
|
+
|
|
26
|
+
Scope: public OSS only, never local/private/proprietary source. Package targets
|
|
27
|
+
use \`registry:name[@version]\` and inspect an indexed artifact/manifest root;
|
|
28
|
+
Swift uses \`swift:github.com/<owner>/<repo>\`, Zig \`zig:gh/<owner>/<repo>\`.
|
|
29
|
+
Use public repository targets for full repositories or sibling packages, with
|
|
30
|
+
an explicit provider (such as \`github:owner/repo\`) or supported full URL.
|
|
31
|
+
Never infer a repository provider. Use selected tool descriptions for supported
|
|
32
|
+
target forms and argument details.
|
|
33
|
+
|
|
34
|
+
For a package or site docs topic, use \`search\` with \`source:"docs"\`.
|
|
35
|
+
\`docs_list\` browses package pages, not standalone \`site:\` targets.
|
|
36
|
+
Pass the emitted \`docsReadTarget\` (or historical \`pageId\`) to \`docs_read\`.
|
|
37
|
+
For source evidence, locate paths or matches before reading; never use
|
|
38
|
+
\`code_read\` to list/probe directories.
|
|
39
|
+
|
|
40
|
+
Keep default text for reading and follow-ups. Reuse returned targets, paths,
|
|
41
|
+
page locators, references and line ranges; do not invent them. Read only needed
|
|
42
|
+
lines. Use JSON only for programmatic parsing or required fields missing from
|
|
43
|
+
text. Cite tool-owned provenance, including get_example source references,
|
|
44
|
+
and report coverage, truncation and other evidence limits.`;function buildMcpQuickStart(options={}){const includeExternalContentPosture=options.includeExternalContentPosture??true;return includeExternalContentPosture?`${ROUTING_GUIDE}
|
|
45
|
+
|
|
46
|
+
${EXTERNAL_CONTENT_POSTURE}`:ROUTING_GUIDE}function buildMcpInstructions(options={}){return buildMcpQuickStart(options)}import{McpServer}from"@modelcontextprotocol/sdk/server/mcp.js";import{z as z2}from"zod";class AuthRequiredError extends Error{mcpUrl;constructor(message,mcpUrl){super(message);this.name="AuthRequiredError";this.mcpUrl=mcpUrl}}function mapCodeNavigationError(error){return classify(error)}function classify(error){const termsError=mapTermsAcceptanceError(error);if(termsError)return termsError;if(error instanceof ClientUpdateRequiredError){return buildUpdateRequiredError(error.reason,error.currentVersion)}if(error instanceof CodeDiffError2){return classifyCodeDiffError(error)}if(error instanceof CodeNavigationVersionNotFoundError){const details={};preserveBackendMetadata(details,error.metadata);if(error.packageName)details.package=error.packageName;if(error.requestedVersion){details.requestedVersion=error.requestedVersion}if(error.latestIndexed)details.latestIndexed=error.latestIndexed;if(error.availableVersions&&error.availableVersions.length>0){details.availableVersions=error.availableVersions}return{code:"VERSION_NOT_FOUND",message:error.message,retryable:false,details:Object.keys(details).length>0?details:undefined}}if(error instanceof CodeNavigationTargetNotFoundError){const details={};preserveBackendMetadata(details,error.metadata);if(error.availableVersions&&error.availableVersions.length>0){details.availableVersions=error.availableVersions}if(error.repoUrl)details.repoUrl=error.repoUrl;if(error.requestedRef)details.requestedRef=error.requestedRef;return{code:"NOT_FOUND",message:error.message,retryable:false,details:Object.keys(details).length>0?details:undefined}}if(error instanceof CodeNavigationRefNotFoundError){const details={};preserveBackendMetadata(details,error.metadata);if(error.repoUrl)details.repoUrl=error.repoUrl;if(error.requestedRef)details.requestedRef=error.requestedRef;if(error.availableRefs&&error.availableRefs.length>0){details.availableRefs=error.availableRefs}if(error.suggestedRefs&&error.suggestedRefs.length>0){details.suggestedRefs=error.suggestedRefs}return{code:"REF_NOT_FOUND",message:addRefSuggestions(error.message,error.suggestedRefs),retryable:false,details:Object.keys(details).length>0?details:undefined}}if(error instanceof CodeNavigationFileNotFoundError){return{code:"FILE_NOT_FOUND",message:error.message,retryable:false,details:error.filePath?{filePath:error.filePath}:undefined}}if(error instanceof CodeNavigationIndexingError){const details={};if(error.indexingRef)details.indexingRef=error.indexingRef;if(error.availableVersions&&error.availableVersions.length>0){details.availableVersions=error.availableVersions}if(error.availableRefs&&error.availableRefs.length>0){details.availableRefs=error.availableRefs}if(error.targetResolution){details.targetResolution=error.targetResolution}if(error.indexingEstimate){details.indexingEstimate=error.indexingEstimate}if(error.hint)details.hint=error.hint;return{code:"INDEXING",message:error.message,retryable:true,details:Object.keys(details).length>0?details:undefined}}if(error instanceof CodeNavigationUnresolvableError){return{code:"UNRESOLVABLE",message:error.message,retryable:false}}if(error instanceof CodeNavigationAccessError||error instanceof CodeNavigationFeatureFlagRequiredError){return{code:"ACCESS_DENIED",message:error.message,retryable:false}}if(error instanceof AuthenticationError2||error instanceof AuthRequiredError){return{code:"AUTH_REQUIRED",message:error.message,retryable:false,details:{authSource:error instanceof AuthenticationError2?error.source:"local"}}}if(error instanceof CodeNavigationNetworkError){return{code:"NETWORK",message:error.message,retryable:true}}if(error instanceof CodeNavigationValidationError){return{code:"INVALID_ARGUMENT",message:normalizeBackendMessage(error.message),retryable:false}}if(error instanceof CodeNavigationBackendError){return classifyBackendError(error)}if(error instanceof CodeNavigationGraphQLError){return{code:"BACKEND_ERROR",message:error.message,retryable:false,details:error.code?{graphqlCode:error.code}:undefined}}if(error instanceof MalformedCodeNavigationResponseError){return{code:"PROTOCOL_ERROR",message:error.message,retryable:false}}if(isInvalidArgumentError(error)){return{code:"INVALID_ARGUMENT",message:error.message,retryable:false}}if(error instanceof Error){return{code:"UNKNOWN",message:error.message,retryable:false}}return{code:"UNKNOWN",message:"Unknown error",retryable:false}}function classifyCodeDiffError(error){const details={};const source=error.details;if(source?.side!==undefined)details.side=source.side;if(source?.publishedVersions!==undefined){details.publishedVersions=source.publishedVersions}if(source?.publishedVersionsTruncated!==undefined){details.publishedVersionsTruncated=source.publishedVersionsTruncated}if(source?.availableVersions!==undefined){details.availableVersions=source.availableVersions.map((entry)=>({...entry}))}if(source?.registry!==undefined)details.registry=source.registry;if(source?.retryAfterMs!==undefined){details.retryAfterMs=source.retryAfterMs}if(source?.stage!==undefined)details.stage=source.stage;if(source?.limitKind!==undefined)details.limitKind=source.limitKind;if(source?.repoUrl!==undefined)details.repoUrl=source.repoUrl;if(source?.gitRef!==undefined)details.gitRef=source.gitRef;if(source?.availableRefs!==undefined){details.availableRefs=source.availableRefs.map((entry)=>({...entry}))}if(source?.suggestedRefs!==undefined){details.suggestedRefs=source.suggestedRefs.map((entry)=>({...entry}))}if(source?.refKinds!==undefined)details.refKinds=source.refKinds;if(error.partial!==undefined){details.codeDiffResolution={package:error.partial.package,from:error.partial.fromResolution,to:error.partial.toResolution}}const build=(code,defaultRetryable)=>({code,message:error.message,retryable:source?.retryable??defaultRetryable,details:Object.keys(details).length>0?details:undefined});switch(source?.code){case"VALIDATION_ERROR":return build("INVALID_ARGUMENT",false);case"VERSION_NOT_FOUND":return build("VERSION_NOT_FOUND",false);case"REF_NOT_FOUND":case"AMBIGUOUS_REF":return build("REF_NOT_FOUND",false);case"REPOSITORY_NOT_FOUND":case"PACKAGE_NOT_FOUND":return build("NOT_FOUND",false);case"TIMEOUT":return build("TIMEOUT",true);case"RATE_LIMITED":return build("RATE_LIMITED",true);default:return build("BACKEND_ERROR",false)}}function buildUpdateRequiredError(reason=CLIENT_UPDATE_REQUIRED_REASON,currentVersion){return{code:"UPDATE_REQUIRED",message:`Update required: ${reason}`,retryable:false,details:{reason,updateCommand:"npm i -g githits@latest",...currentVersion?{currentVersion}:{}}}}function classifyBackendError(error){const details={};preserveBackendMetadata(details,error.metadata);if(typeof error.status==="number")details.status=error.status;if(error.graphqlCode)details.graphqlCode=error.graphqlCode;const message=normalizeBackendMessage(error.message);const build=(code,defaultRetryable)=>({code,message,retryable:error.retryable??defaultRetryable,details:Object.keys(details).length>0?details:undefined});switch(error.graphqlCode){case"TIMEOUT":return build("TIMEOUT",true);case"RATE_LIMITED":return build("RATE_LIMITED",true);case"REPOSITORY_NOT_FOUND":return build("NOT_FOUND",false);case"REF_NOT_FOUND":return build("REF_NOT_FOUND",false);case"FILE_PATH_EXCLUDED":return build("FILE_PATH_EXCLUDED",false);case"SOURCE_FILE_INVENTORY_UNKNOWN":return build("SOURCE_FILE_INVENTORY_UNKNOWN",false);case"UPSTREAM_ERROR":return build("BACKEND_ERROR",true);default:return build("BACKEND_ERROR",false)}}function preserveBackendMetadata(details,metadata){if(!metadata)return;if(metadata.hint)details.hint=metadata.hint;if(metadata.filePath)details.filePath=metadata.filePath;if(metadata.exclusionReason){details.exclusionReason=metadata.exclusionReason}if(metadata.availableVersions?.length){details.availableVersions=metadata.availableVersions}if(metadata.availableRefs?.length){details.availableRefs=metadata.availableRefs}if(metadata.suggestedRefs?.length){details.suggestedRefs=metadata.suggestedRefs}if(metadata.targetResolution){details.targetResolution=metadata.targetResolution}if(metadata.indexingEstimate){details.indexingEstimate=metadata.indexingEstimate}}function addRefSuggestions(message,refs){if(!refs||refs.length===0||/did you mean/i.test(message)){return message}const suggestions=refs.slice(0,5).map((entry)=>entry.ref).join(", ");return`${message} Did you mean ${suggestions}?`}function normalizeBackendMessage(message){return message.replace(/extractable literal anchor/g,"extractable literal substring").replace(/at least one literal anchor/g,"at least one literal substring").replace(/literal prefix/g,"literal substring")}function isInvalidArgumentError(error){if(!(error instanceof Error))return false;return error.name.startsWith("Invalid")||error.name.startsWith("Unsupported")}function withGrepFileRecovery(mapped){if(isExactPathAuthorityError(mapped)){return withExactPathAuthorityRecovery(mapped,"grep")}if(mapped.code!=="FILE_NOT_FOUND"||mapped.details?.filePath===undefined){return mapped}const prefix=buildContainingPathPrefix(mapped.details.filePath);const listing=prefix===""?"Use `code_files` without `path_prefix`":`Use \`code_files\` with \`path_prefix: ${JSON.stringify(prefix)}\``;return{...mapped,details:{...mapped.details,action:`${listing} to list valid indexed paths, then pass an emitted \`path\` `+"back to `code_grep`."}}}function isExactPathAuthorityError(mapped){return mapped.code==="FILE_PATH_EXCLUDED"||mapped.code==="SOURCE_FILE_INVENTORY_UNKNOWN"}function withExactPathAuthorityRecovery(mapped,command){if(!isExactPathAuthorityError(mapped)||mapped.details?.filePath===undefined){return mapped}const prefix=buildContainingPathPrefix(mapped.details.filePath);const listing=prefix===""?"Use `code_files` without `path_prefix`":`Use \`code_files\` with \`path_prefix: ${JSON.stringify(prefix)}\``;const reason=mapped.code==="FILE_PATH_EXCLUDED"?"This path is excluded from the indexed source.":"The source inventory cannot verify this path.";return{...mapped,details:{...mapped.details,action:`${reason} ${listing} to list indexed paths available to `+`\`code_${command}\`.`}}}function buildContainingPathPrefix(filePath){const trimmed=filePath.trim();const slash=trimmed.lastIndexOf("/");return slash===-1?"":trimmed.slice(0,slash+1)}function buildPathPrefixSuggestion(requestedPath){const trimmed=requestedPath.trim();if(trimmed==="")return"";if(trimmed.endsWith("/"))return trimmed;const slash=trimmed.lastIndexOf("/");const basename=slash===-1?trimmed:trimmed.slice(slash+1);if(!basename.includes("."))return`${trimmed}/`;return slash===-1?"":trimmed.slice(0,slash+1)}function looksLikeMissingFileMessage(message){const lower=message.toLowerCase();return lower.includes("file not found")||lower.includes("path not found")||lower.includes("path doesn't resolve")||lower.includes("path does not resolve")}var DEFAULT_WAIT_TIMEOUT_MS=20000;var MAX_WAIT_TIMEOUT_MS=60000;var MCP_READ_DEFAULT_SPAN=150;var MCP_READ_MAX_SPAN=300;var FILE_INTENT_ALL=Symbol("FILE_INTENT_ALL");var KNOWN_REGISTRIES=PKGSEER_REGISTRY_ARGS;class UnsupportedRegistryError extends Error{attempted;constructor(attempted){super(`Unsupported registry "${attempted}". Supported: ${PKGSEER_REGISTRY_LIST2}.`);this.attempted=attempted;this.name="UnsupportedRegistryError"}}class InvalidPackageSpecError extends Error{constructor(message){super(message);this.name="InvalidPackageSpecError"}}class InvalidArgumentError extends Error{constructor(message){super(message);this.name="InvalidArgumentError"}}function parsePackageSpec(spec){if(!spec||spec.trim()===""){throw new InvalidPackageSpecError("Package spec cannot be empty. Expected <registry>:<name>[@<version>].")}if(!spec.includes(":")){throw new InvalidPackageSpecError(`Package spec "${spec}" is missing a registry prefix. Expected <registry>:<name>[@<version>]. Supported registries: ${PKGSEER_REGISTRY_LIST2}.`)}const colonIndex=spec.indexOf(":");const potentialRegistry=spec.slice(0,colonIndex).toLowerCase();if(!isKnownRegistry(potentialRegistry)){throw new UnsupportedRegistryError(potentialRegistry)}const registry=potentialRegistry;const registryExplicit=true;const rest=spec.slice(colonIndex+1);const atIndex=rest.lastIndexOf("@");if(atIndex>0){const name=rest.slice(0,atIndex);const version=rest.slice(atIndex+1);if(version===""){throw new InvalidPackageSpecError(`Package spec "${spec}" has a trailing "@" with no version. Omit the "@" or add a version.`)}if(name===""){throw new InvalidPackageSpecError(`Package spec "${spec}" has a version but no name.`)}return{registry,registryExplicit,name,version}}if(rest===""){throw new InvalidPackageSpecError(`Package spec "${spec}" is missing a package name after the registry prefix.`)}return{registry,registryExplicit,name:rest}}function isKnownRegistry(value){return KNOWN_REGISTRIES.includes(value)}var PATTERN_MAX=200;var GREP_REPO_CONTEXT_MIN=0;var GREP_REPO_CONTEXT_MAX=10;var LIMIT_MIN=1;var LIMIT_MAX=1000;var LIMIT_DEFAULT=50;var WAIT_MIN=0;var GREP_REPO_SYMBOL_FIELDS_NOTE=`Hydrate these enclosing-symbol fields on each match; omit for no symbol hydration. Valid values: ${GREP_REPO_SYMBOL_FIELDS.join(", ")}.`;var GREP_REPO_PATTERN_NOTE="Text grep over indexed source files. `literal` (default) does substring matching. `regex` uses RE2 syntax (no lookaround, no backreferences); when scoping the whole target with no path, path_prefix, or glob, the regex must include at least one literal substring the index can use for pre-filtering. Pattern max 200 UTF-8 bytes. Matching is ASCII case-insensitive by default: non-ASCII letters match case-sensitively; pass case_sensitive: true for exact casing. When multiple selectors (`path`, `path_prefix`, `globs`) are combined, they are unioned — a file matches if any selector matches. Use `extensions` to intersect further.";function buildGrepRepoParams(input){const pattern=input.pattern??"";if(pattern.length===0||pattern.trim().length===0){throw new InvalidPackageSpecError("`pattern` is required — pass the text to search for. If you are trying to list files or count files in scope, use `code_files` instead.")}if(Buffer.byteLength(pattern,"utf8")>PATTERN_MAX){throw new InvalidPackageSpecError(`\`pattern\` must be ≤ ${PATTERN_MAX} UTF-8 bytes.`)}const path=normalizeOptionalNonEmpty(input.path,"path");const pathPrefix=normalizeOptionalNonEmpty(input.pathPrefix,"path_prefix");const globs=normalizeStringList(input.globs,"globs");const extensions=normalizeExtensions(input.extensions);const contextLines=normalizeOptionalContext(input.contextLines,"context_lines");const contextLinesBefore=normalizeOptionalContext(input.contextLinesBefore,"context_lines_before");const contextLinesAfter=normalizeOptionalContext(input.contextLinesAfter,"context_lines_after");const resolvedBefore=contextLinesBefore??(contextLines!==undefined?contextLines:0);const resolvedAfter=contextLinesAfter??(contextLines!==undefined?contextLines:0);const maxMatches=normalizeMaxMatches(input.maxMatches);const maxMatchesPerFile=normalizeMaxMatchesPerFile(input.maxMatchesPerFile,maxMatches);const waitTimeoutMs=normalizeWaitTimeoutMs(input.waitTimeoutMs);const cursor=normalizeOptionalNonEmpty(input.cursor,"cursor");const symbolFields=normalizeSymbolFields(input.symbolFields);const pathSelectors=buildPathSelectors({path,pathPrefix,globs});const hasPathSelectors=(pathSelectors?.length??0)>0;const requestedBefore=input.contextLinesBefore??input.contextLines??0;const requestedAfter=input.contextLinesAfter??input.contextLines??0;return{...requestedBefore>resolvedBefore||requestedAfter>resolvedAfter?{contextClamping:{requestedBefore,requestedAfter,effectiveBefore:resolvedBefore,effectiveAfter:resolvedAfter}}:{},params:{target:input.target,pattern,patternType:input.patternType==="regex"?"REGEX":input.patternType==="literal"?"LITERAL":undefined,caseSensitive:input.caseSensitive,pathSelectors,extensions,excludeDocFiles:input.excludeDocFiles,excludeTestFiles:input.excludeTestFiles,allowUnscoped:hasPathSelectors?undefined:true,contextLinesBefore:resolvedBefore,contextLinesAfter:resolvedAfter,maxMatches,maxMatchesPerFile,cursor,symbolFields:symbolFields.length>0?symbolFields:undefined,waitTimeoutMs},explicit:{path:path!==undefined,pathPrefix:pathPrefix!==undefined,globs:globs.length>0,extensions:extensions.length>0,patternType:input.patternType!==undefined,caseSensitive:input.caseSensitive!==undefined,excludeDocFiles:input.excludeDocFiles!==undefined,excludeTestFiles:input.excludeTestFiles!==undefined,contextLines:input.contextLines!==undefined,contextLinesBefore:input.contextLinesBefore!==undefined,contextLinesAfter:input.contextLinesAfter!==undefined,maxMatches:input.maxMatches!==undefined,maxMatchesPerFile:input.maxMatchesPerFile!==undefined,cursor:cursor!==undefined,symbolFields:symbolFields.length>0}}}function buildPathSelectors(input){const selectors=[];if(input.path)selectors.push({kind:"EXACT",value:input.path});if(input.pathPrefix){selectors.push({kind:"PREFIX",value:input.pathPrefix})}for(const glob of input.globs){selectors.push({kind:"GLOB",value:glob})}return selectors.length>0?selectors:undefined}function normalizeOptionalNonEmpty(value,_field){if(value===undefined)return;const trimmed=value.trim();return trimmed.length>0?trimmed:undefined}function normalizeStringList(values,field){if(!values)return[];const out=[];for(const value of values){const trimmed=value.trim();if(trimmed.length===0){throw new InvalidPackageSpecError(`\`${field}\` entries cannot be empty.`)}out.push(trimmed)}return out}function normalizeSymbolFields(values){const out=normalizeStringList([...values??[]],"symbol_fields");for(const value of out){if(!GREP_REPO_SYMBOL_FIELDS.includes(value)){throw new InvalidPackageSpecError(`\`symbol_fields\` value must be one of: ${GREP_REPO_SYMBOL_FIELDS.join(", ")}. Got: ${value}.`)}}return out}function normalizeExtensions(values){const out=normalizeStringList(values,"extensions");for(const value of out){if(value.startsWith(".")){throw new InvalidPackageSpecError("`extensions` values must not include a leading dot.")}}return out}function normalizeOptionalContext(value,field){if(value===undefined)return;if(!Number.isSafeInteger(value)||value<GREP_REPO_CONTEXT_MIN){throw new InvalidPackageSpecError(`\`${field}\` must be a nonnegative safe integer. Got ${value}.`)}return Math.min(value,GREP_REPO_CONTEXT_MAX)}function normalizeMaxMatches(value){if(value===undefined)return LIMIT_DEFAULT;if(!Number.isInteger(value)||value<LIMIT_MIN||value>LIMIT_MAX){throw new InvalidPackageSpecError(`\`max_matches\` must be an integer between ${LIMIT_MIN} and ${LIMIT_MAX}. Got ${value}.`)}return value}function normalizeMaxMatchesPerFile(value,maxMatches){if(value===undefined)return maxMatches;if(!Number.isInteger(value)||value<0||value>LIMIT_MAX){throw new InvalidPackageSpecError(`\`max_matches_per_file\` must be an integer between 0 and ${LIMIT_MAX}. Got ${value}.`)}return value}function normalizeWaitTimeoutMs(value){if(value===undefined)return DEFAULT_WAIT_TIMEOUT_MS;if(!Number.isInteger(value)||value<WAIT_MIN||value>MAX_WAIT_TIMEOUT_MS){throw new InvalidPackageSpecError(`\`wait_timeout_ms\` must be an integer between ${WAIT_MIN} and ${MAX_WAIT_TIMEOUT_MS}. Got ${value}.`)}return value}var colors={reset:"\x1B[0m",bold:"\x1B[1m",dim:"\x1B[2m",italic:"\x1B[3m",green:"\x1B[32m",yellow:"\x1B[33m",blue:"\x1B[34m",magenta:"\x1B[35m",cyan:"\x1B[36m",red:"\x1B[31m"};function colorize(text,color,useColors){if(!useColors)return text;return`${colors[color]}${text}${colors.reset}`}function highlight(text,useColors){if(!useColors)return text;return`${colors.bold}${colors.cyan}${text}${colors.reset}`}function highlightMatch(text,useColors){if(!useColors)return text;return`${colors.bold}${colors.yellow}${text}${colors.reset}`}function highlightRanges(text,ranges,useColors){if(!useColors||!text||!ranges||ranges.length===0)return text;const normalised=ranges.filter((range)=>Array.isArray(range)&&range.length===2&&Number.isInteger(range[0])&&Number.isInteger(range[1])).map(([start,end])=>{const safeStart=Math.max(0,Math.min(text.length,start));const safeEnd=Math.max(safeStart,Math.min(text.length,end));return[safeStart,safeEnd]}).filter(([start,end])=>end>start).sort((left,right)=>left[0]-right[0]||left[1]-right[1]);if(normalised.length===0)return text;const merged=[];for(const current of normalised){const previous=merged[merged.length-1];if(!previous||current[0]>previous[1]){merged.push(current);continue}merged[merged.length-1]=[previous[0],Math.max(previous[1],current[1])]}let result="";let cursor=0;for(const[start,end]of merged){if(cursor<start)result+=text.slice(cursor,start);result+=highlightMatch(text.slice(start,end),useColors);cursor=end}if(cursor<text.length)result+=text.slice(cursor);return result}function dim(text,useColors){if(!useColors)return text;return`${colors.dim}${text}${colors.reset}`}function shellQuote(value){return`'${value.replaceAll("'",`'"'"'`)}'`}var GITHUB_OWNER_PATTERN=/^[A-Za-z0-9](?:[A-Za-z0-9-]{0,37}[A-Za-z0-9])?$/;var REPO_PATTERN=/^[A-Za-z0-9._-]+$/;function validComponent(value){return value!=="."&&value!==".."&&REPO_PATTERN.test(value)}function validGithubPath(parts){return parts.length===2&&GITHUB_OWNER_PATTERN.test(parts[0])&&validComponent(parts[1])}function validCodebergPath(parts){return parts.length===2&&parts.every((part)=>/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(part))}var GITLAB_TOP_LEVEL_ROUTE=/^(?:-|\.well-known|404\.html|422\.html|500\.html|502\.html|503\.html|admin|api|apple-touch-icon\.png|assets|dashboard|deploy\.html|explore|favicon\.ico|favicon\.png|files|groups|health_check|help|import|jwt|login|oauth|profile|projects|public|robots\.txt|s|search|sitemap|sitemap\.xml|sitemap\.xml\.gz|slash-command-logo\.png|snippets|unsubscribes|uploads|users|v2)$/i;var GITLAB_PROJECT_ROUTE=/^(?:-|badges|blame|blob|builds|commits|create|create_dir|edit|files|find_file|new|preview|raw|refs|tree|update|wikis)$/i;var GITLAB_MULTI_SEGMENT_ROUTE=/(?:^|\/)(?:environments\/folders|gitlab-lfs\/objects|info\/lfs\/objects)(?:\/|$)/i;function validGitlabPath(parts){return parts.length>=2&&parts.every((part)=>/^[A-Za-z0-9_][A-Za-z0-9._-]*$/.test(part))&&!GITLAB_TOP_LEVEL_ROUTE.test(parts[0])&&parts.slice(1).every((part)=>!GITLAB_PROJECT_ROUTE.test(part))&&!GITLAB_MULTI_SEGMENT_ROUTE.test(parts.slice(1).join("/"))}var PROVIDERS=Object.freeze([Object.freeze({prefix:"github:",host:"github.com",name:"GitHub",path:"owner/repo",allowHttp:true,hostShorthand:true,validatePath:validGithubPath}),Object.freeze({prefix:"codeberg:",host:"codeberg.org",name:"Codeberg",path:"owner/repo",allowHttp:false,hostShorthand:false,validatePath:validCodebergPath}),Object.freeze({prefix:"gitlab:",host:"gitlab.com",name:"GitLab",path:"group[/subgroup...]/project",allowHttp:false,hostShorthand:false,validatePath:validGitlabPath})]);var REPOSITORY_TARGET_ERROR="Repository target must be github:owner/repo, codeberg:owner/repo, or gitlab:group[/subgroup...]/project, or an approved full HTTPS URL, with optional #gitRef or @gitRef suffix.";function normaliseRepositoryTargetSpec(spec){const trimmed=spec.trim();const lower=trimmed.toLowerCase();if(lower.startsWith("http://")||lower.startsWith("https://"))return trimmed;for(const provider of PROVIDERS){if(lower.startsWith(provider.prefix))return`https://${provider.host}/${trimmed.slice(provider.prefix.length)}`;if(provider.hostShorthand&&lower.startsWith(`${provider.host}/`))return`https://${trimmed}`}return}function isRepositoryTargetSpec(spec){return normaliseRepositoryTargetSpec(spec)!==undefined}function parseRepositoryTargetSpec(spec){const normalised=normaliseRepositoryTargetSpec(spec);if(!normalised)throw new InvalidArgumentError(REPOSITORY_TARGET_ERROR);const match=/^(https?):\/\/([^/]+)\/(.*)$/i.exec(normalised);if(!match)throw new InvalidArgumentError(REPOSITORY_TARGET_ERROR);const scheme=match[1];const authority=match[2];const rawPath=match[3];if(authority.includes("@"))throw new InvalidArgumentError("Repository URL targets must not include credentials.");if(/[\\?#\s]/.test(authority))throw new InvalidArgumentError(REPOSITORY_TARGET_ERROR);let host;try{host=new URL(`${scheme}://${authority}`).host}catch{throw new InvalidArgumentError(REPOSITORY_TARGET_ERROR)}const provider=PROVIDERS.find((entry)=>entry.host===host);if(!provider)throw new InvalidArgumentError("Repository URL targets must use github.com, codeberg.org, or gitlab.com; unsupported/self-hosted hosts and nondefault ports are not accepted.");const guidance=`Use ${provider.prefix}${provider.path} with optional #gitRef or @gitRef, or https://${provider.host}/${provider.path}.`;if(scheme.toLowerCase()==="http"&&!provider.allowHttp)throw new InvalidArgumentError(`${provider.name} repository URLs require HTTPS. ${guidance}`);if(rawPath.includes("?"))throw new InvalidArgumentError(`Repository URL targets must not include query parameters. ${guidance}`);if(provider.prefix==="github:"&&!GITHUB_OWNER_PATTERN.test(rawPath.split("/")[0]))throw new InvalidArgumentError(`Repository URL targets must use a valid GitHub owner name. ${guidance}`);const hash=rawPath.indexOf("#");const at=rawPath.indexOf("@");if(at!==-1&&hash!==-1&&at<hash)throw new InvalidArgumentError(`Repository URL targets must use only one ref suffix: #gitRef or @gitRef. ${guidance}`);const delimiter=hash!==-1?hash:at;const path=(delimiter===-1?rawPath:rawPath.slice(0,delimiter)).replace(/\/$/,"");const gitRef=delimiter===-1?undefined:rawPath.slice(delimiter+1);if(gitRef===""||gitRef?.includes("#"))throw new InvalidArgumentError(`Repository refs must be nonempty and use only one ref suffix. ${guidance}`);const parts=path.split("/");if(!provider.validatePath(parts)){if(provider.prefix==="github:"&&parts.length===2)throw new InvalidArgumentError(`Repository URL targets must use a valid GitHub repository name. ${guidance}`);throw new InvalidArgumentError(`Repository URL targets must point to ${provider.host}/${provider.path}; pass refs with #gitRef or @gitRef. ${provider.name} web subpaths are not repository targets. ${guidance}`)}const repoUrl=`https://${provider.host}/${path}`;return gitRef===undefined?{repoUrl}:{repoUrl,gitRef}}function formatRepositoryTarget(repoUrl,gitRef){let compact=repoUrl;try{const parsed=parseRepositoryTargetSpec(repoUrl);if(parsed.repoUrl&&parsed.gitRef===undefined){const url=new URL(parsed.repoUrl);const provider=PROVIDERS.find((entry)=>entry.host===url.host);compact=`${provider.prefix}${url.pathname.slice(1)}`}}catch{}return gitRef?`${compact}#${gitRef}`:compact}function formatRepositoryTargetLabel(label,repoUrl){if(isRepositoryTargetSpec(label)){try{const parsed=parseRepositoryTargetSpec(label);return formatRepositoryTarget(parsed.repoUrl,parsed.gitRef)}catch{return}}if(!repoUrl)return;try{const parsed=parseRepositoryTargetSpec(repoUrl);const path=new URL(parsed.repoUrl).pathname.slice(1);if(label===path)return formatRepositoryTarget(parsed.repoUrl);if(label.startsWith(`${path}@`)&&label.length>path.length+1)return formatRepositoryTarget(parsed.repoUrl,label.slice(path.length+1))}catch{return}return}function buildInvalidTargetSpecError(spec,cause){const prefix=cause?`${cause} `:`Target spec "${spec}" is not recognized. `;return new InvalidArgumentError(`${prefix}Expected package target <registry>:<name>[@<version>] (supported registries: ${KNOWN_REGISTRIES.join(", ")}) or repository target github:owner/repo, codeberg:owner/repo, or gitlab:group[/subgroup...]/project with optional #ref or @ref (approved full HTTPS URLs also accepted; GitHub additionally supports github.com/owner/repo and HTTP).`)}function projectTargetResolution(resolution){if(!resolution)return;return{...resolution.requested?{requested:projectIdentity(resolution.requested)}:{},...resolution.resolvedRequested?{resolvedRequested:projectIdentity(resolution.resolvedRequested)}:{},...resolution.served?{served:projectIdentity(resolution.served)}:{},...resolution.freshness?{freshness:resolution.freshness}:{},...resolution.freshnessReason?{freshnessReason:resolution.freshnessReason}:{},...resolution.indexingRef?{indexingRef:resolution.indexingRef}:{},availableVersions:resolution.availableVersions.map(projectArtifact),availableRefs:resolution.availableRefs.map(projectArtifact),suggestedRefs:(resolution.suggestedRefs??[]).map(projectArtifact)}}function buildTargetResolutionNotes(resolution){if(!resolution)return[];const lines=[];const requested=formatTargetResolutionIdentity(resolution.requested);const fresh=formatTargetResolutionIdentity(resolution.resolvedRequested);const served=formatTargetResolutionIdentity(resolution.served);const reason=formatFreshnessReason(resolution.freshnessReason,resolution.freshness);switch(resolution.freshness){case"fallback_recent":{const parts=[reason??"Using recent indexed snapshot"];if(served)parts.push(`served=${served}`);if(fresh&&identitiesMateriallyDiffer(fresh,served)){parts.push(`fresh=${fresh}`)}lines.push(parts.join(" | "));break}case"indexing":{const parts=[reason??"Fresh target is being indexed"];if(served)parts.push(`served=${served}`);if(requested)parts.push(`requested=${requested}`);if(fresh&&identitiesMateriallyDiffer(fresh,served)){parts.push(`fresh=${fresh}`)}if(resolution.indexingRef)parts.push(`indexingRef=${resolution.indexingRef}`);lines.push(parts.join(" | "));break}case"provisional":{const parts=["provisional (still indexing)"];if(reason)parts.push(reason);if(served)parts.push(`served=${served}`);if(resolution.indexingRef)parts.push(`indexingRef=${resolution.indexingRef}`);lines.push(parts.join(" | "));break}case"unavailable":{const parts=[reason??"Target unavailable"];if(requested)parts.push(`requested=${requested}`);lines.push(parts.join(" | "));break}case"current":{return lines}default:{if(resolution.freshness||identitiesDiffer(requested,fresh,served)){const parts=[`target resolution: ${resolution.freshness??"unknown"}`];if(served)parts.push(`served=${served}`);if(requested)parts.push(`requested=${requested}`);if(fresh&&fresh!==served)parts.push(`fresh=${fresh}`);if(reason)parts.push(reason);lines.push(parts.join(" | "))}break}}const candidates=buildRetryCandidateLine(resolution);if(candidates)lines.push(candidates);const suggestions=buildSuggestedRefsLine(resolution);if(suggestions)lines.push(suggestions);return lines}function formatFreshnessReason(reason,freshness){switch(reason){case undefined:case"exact_current":case"exact_provisional":return;case"no_current_fallback":if(freshness==="fallback_recent"){return"Serving an older indexed snapshot; current target is still being indexed"}return"Fresh target is being indexed; no current snapshot is available yet";case"ref_resolution_deferred":return"Using recent indexed snapshot while branch resolution is deferred";case"requested_ref_indexing":return"Requested ref is being indexed";default:return`freshnessReason=${reason}`}}function buildRetryCandidateLine(resolution){if(!resolution)return;const parts=[];if(resolution.availableVersions.length>0){parts.push(`versions=${resolution.availableVersions.map(formatArtifact).join(",")}`)}if(resolution.availableRefs.length>0){parts.push(`refs=${resolution.availableRefs.map(formatArtifact).join(",")}`)}return parts.length>0?`queryable now: ${parts.join(" | ")}`:undefined}function buildSuggestedRefsLine(resolution){const refs=resolution?.suggestedRefs??[];if(refs.length===0)return;return`suggested refs (may need indexing): ${refs.map(formatArtifact).join(",")}`}function buildResolutionFromRetryCandidates(target){if(!target.availableVersions?.length&&!target.availableRefs?.length&&!target.suggestedRefs?.length){return}return{freshness:target.freshness==="CURRENT"?"current":target.freshness==="PROVISIONAL"?"provisional":target.freshness,indexingRef:target.indexingRef,availableVersions:target.availableVersions??[],availableRefs:target.availableRefs??[],suggestedRefs:target.suggestedRefs??[]}}function projectIdentity(identity){const out={};if(identity.kind)out.kind=identity.kind;if(identity.registry)out.registry=identity.registry;if(identity.packageName)out.packageName=identity.packageName;if(identity.version)out.version=identity.version;if(identity.repoUrl)out.repoUrl=identity.repoUrl;if(identity.gitRef)out.gitRef=identity.gitRef;if(identity.commitSha)out.commitSha=identity.commitSha;if(identity.site)out.site=identity.site;return out}function projectArtifact(artifact){return artifact.version?{version:artifact.version,ref:artifact.ref}:{ref:artifact.ref}}function formatTargetResolutionIdentity(identity){if(!identity)return;if(identity.registry&&identity.packageName){const version=identity.version?`@${identity.version}`:"";const commit=identity.commitSha?`#${shortSha(identity.commitSha)}`:"";return`${identity.registry.toLowerCase()}:${identity.packageName}${version}${commit}`}if(identity.repoUrl){const target=formatRepositoryTarget(identity.repoUrl,identity.gitRef);const commit=identity.commitSha?`@${shortSha(identity.commitSha)}`:"";return`${target}${commit}`}if(identity.site)return identity.site;return identity.gitRef??identity.version??identity.commitSha??identity.kind}function formatArtifact(artifact){return artifact.version?`${artifact.version}@${artifact.ref}`:artifact.ref}function identitiesDiffer(requested,fresh,served){if(!served)return Boolean(requested||fresh);return Boolean(requested&&requested!==served||fresh&&fresh!==served)}function identitiesMateriallyDiffer(left,right){if(!left||!right)return Boolean(left||right);return stripShortCommit(left)!==stripShortCommit(right)}function stripShortCommit(value){return value.replace(/[@#][0-9a-f]{7}$/i,"")}function shortSha(value){return/^[0-9a-f]{12,}$/i.test(value)?value.slice(0,7):value}var SEP=" | ";function renderGrepRepoText(envelope){const lines=[];lines.push(buildHeader(envelope));lines.push("");if(envelope.matches.length===0){lines.push("No matches.");for(const note of buildEmptyGrepGuidance(envelope))lines.push(note);return lines.join(`
|
|
47
|
+
`)}const contextNotice=buildGrepContextClampingNotice(envelope);if(contextNotice)lines.push(contextNotice,"");const blocks=buildRenderBlocks(envelope.matches);const blocksByFile=groupBlocksByFile(blocks);const useContext=blocksHaveContext(blocks);const matchCountsByFile=countMatchesByFile(envelope.matches);let firstFile=true;for(const[filePath,fileBlocks]of blocksByFile){if(!firstFile)lines.push("");firstFile=false;const matchCount=matchCountsByFile.get(filePath)??0;lines.push(`${filePath} (${matchCount})`);fileBlocks.forEach((block,idx)=>{if(useContext&&idx>0)lines.push(" --");const gutterWidth=widestLineNumberInBlock(block);for(const ln of block.lines){lines.push(renderLine(ln,gutterWidth,useContext))}})}const trailer=buildTrailer(envelope);if(trailer.length>0){lines.push("");for(const t of trailer)lines.push(t)}return lines.join(`
|
|
48
|
+
`)}function buildEmptyGrepGuidance(envelope,surface="mcp"){const lines=[formatEmptyGrepFileCounts(envelope)];const contextNotice=buildGrepContextClampingNotice(envelope,surface);if(contextNotice)lines.push(contextNotice);const served=formatGrepServedTarget(envelope);if(served)lines.push(served);for(const note of buildTargetResolutionNotes(envelope.targetResolution)){lines.push(note)}const skipNotes=[];if(envelope.binaryFilesSkipped){skipNotes.push(`${envelope.binaryFilesSkipped} binary file(s) skipped`)}if(envelope.filesTooLargeSkipped){skipNotes.push(`${envelope.filesTooLargeSkipped} oversized file(s) skipped`)}if(skipNotes.length>0)lines.push(`Note: ${skipNotes.join(", ")}.`);if(envelope.truncatedReason){const reason=formatTruncationReason(envelope.truncatedReason);lines.push(`Truncated: ${reason}. ${formatTruncationAdvice(envelope.truncatedReason,surface)}`)}if(envelope.hasMore&&envelope.nextCursor){lines.push(surface==="cli"?`More matches available — rerun with --cursor ${shellQuote(envelope.nextCursor)}`:`More matches available. Pass cursor=${envelope.nextCursor} for the next page.`)}else if(envelope.hasMore){lines.push("More matches available.")}if(envelope.truncatedReason||envelope.hasMore)return lines;lines.push("Do not repeat this grep unchanged.");if(envelope.filesInScope===0){lines.push(surface==="cli"?"next: loosen the optional path-prefix argument, --path, --glob, --ext, or exclusion flags.":"next: loosen path, path_prefix, globs, extensions, or exclusion filters.");return lines}const pivots=["shorten or change the pattern"];if(envelope.caseSensitive){pivots.push(surface==="cli"?"drop --case-sensitive":"set case_sensitive: false")}pivots.push(surface==="cli"?"use githits search for conceptual intent":"use search for conceptual intent");lines.push(`next: ${pivots.join("; ")}.`);return lines}function formatEmptyGrepFileCounts(envelope){if(envelope.filesInScope===0){return`files scanned: ${envelope.filesScanned} (no files in scope)`}if(envelope.filesScanned<envelope.filesInScope){return`files: ${envelope.filesInScope} in scope | ${envelope.filesScanned} content-scanned after index pruning`}return`files scanned: ${envelope.filesScanned} (full scope)`}function formatTruncationReason(reason){switch(reason){case"deadline":return"time limit reached";case"max_matches":return"match limit reached";case"max_matches_per_file":return"per-file match limit reached";default:return reason}}function formatTruncationAdvice(reason,surface){if(surface==="cli"){switch(reason){case"max_matches":return"Narrow the file selectors or increase --limit.";case"max_matches_per_file":return"Narrow the file selectors or increase --per-file-limit.";default:return"Narrow the file selectors."}}switch(reason){case"max_matches":return"Pass narrower path/path_prefix/globs or increase max_matches.";case"max_matches_per_file":return"Pass narrower path/path_prefix/globs or increase max_matches_per_file.";default:return"Pass narrower path/path_prefix/globs."}}function formatGrepServedTarget(envelope){const resolved=formatTargetResolutionIdentity(envelope.targetResolution?.served);if(resolved){const state=envelope.targetResolution?.freshness;return`target: served=${resolved}${state?` | state=${state}`:""}`}const servedRef=envelope.indexedVersion??envelope.resolution?.resolvedRef??envelope.gitRef;return servedRef?`target: served=${servedRef}`:undefined}function buildHeader(envelope){const parts=[`code_grep${SEP}${envelope.totalMatches} match${envelope.totalMatches===1?"":"es"} in ${envelope.uniqueFilesMatched} file${envelope.uniqueFilesMatched===1?"":"s"}`];parts.push(`pattern=${quote(envelope.pattern)}`);const flags=[];if(envelope.patternType==="regex")flags.push("regex");if(envelope.caseSensitive)flags.push("case-sensitive");if(flags.length>0)parts.push(flags.join(","));return parts.join(SEP)}function buildTrailer(envelope){const lines=[];if(envelope.truncatedReason){lines.push(`Truncated: ${formatTruncationReason(envelope.truncatedReason)}. ${formatTruncationAdvice(envelope.truncatedReason,"mcp")}`)}if(envelope.hasMore&&envelope.nextCursor){lines.push(`More matches available. Pass cursor=${envelope.nextCursor} for the next page.`)}else if(envelope.hasMore){lines.push("More matches available.")}const skipNotes=[];if(envelope.binaryFilesSkipped){skipNotes.push(`${envelope.binaryFilesSkipped} binary file(s) skipped`)}if(envelope.filesTooLargeSkipped){skipNotes.push(`${envelope.filesTooLargeSkipped} oversized file(s) skipped`)}if(skipNotes.length>0){lines.push(`Note: ${skipNotes.join(", ")}.`)}for(const note of buildTargetResolutionNotes(envelope.targetResolution)){lines.push(note)}return lines}function buildRenderBlocks(matches){if(matches.length===0)return[];const linesByFile=new Map;for(const match of matches){let lineMap=linesByFile.get(match.filePath);if(!lineMap){lineMap=new Map;linesByFile.set(match.filePath,lineMap)}const before=match.contextBefore??[];const beforeStart=match.line-before.length;for(let i=0;i<before.length;i+=1){const lineNumber=beforeStart+i;if(!lineMap.has(lineNumber)){lineMap.set(lineNumber,{lineNumber,content:before[i]??"",isMatch:false})}}lineMap.set(match.line,{lineNumber:match.line,content:match.lineContent,isMatch:true});const after=match.contextAfter??[];for(let i=0;i<after.length;i+=1){const lineNumber=match.line+i+1;if(!lineMap.has(lineNumber)){lineMap.set(lineNumber,{lineNumber,content:after[i]??"",isMatch:false})}}}const blocks=[];for(const[filePath,lineMap]of linesByFile){const sorted=[...lineMap.values()].sort((a,b)=>a.lineNumber-b.lineNumber);let current=[];for(const line of sorted){const previous=current[current.length-1];if(!previous||line.lineNumber===previous.lineNumber+1){current.push(line);continue}blocks.push({filePath,lines:current});current=[line]}if(current.length>0){blocks.push({filePath,lines:current})}}return blocks}function groupBlocksByFile(blocks){const map=new Map;for(const block of blocks){const list=map.get(block.filePath)??[];list.push(block);map.set(block.filePath,list)}return map}function blocksHaveContext(blocks){for(const block of blocks){for(const line of block.lines){if(!line.isMatch)return true}}return false}function widestLineNumberInBlock(block){let max=0;for(const line of block.lines){const len=String(line.lineNumber).length;if(len>max)max=len}return max}function countMatchesByFile(matches){const counts=new Map;for(const match of matches){counts.set(match.filePath,(counts.get(match.filePath)??0)+1)}return counts}function renderLine(line,gutterWidth,useContext){const gutter=String(line.lineNumber).padStart(gutterWidth," ");const sep=!useContext||line.isMatch?":":"-";return` ${gutter}${sep} ${line.content}`}function quote(value){return value.includes('"')?`'${value}'`:`"${value}"`}function buildGrepContextClampingNotice(envelope,surface="mcp"){const adjustment=envelope.contextClamping;if(!adjustment)return;const read=surface==="cli"?"githits code read":"code_read";return`Context limited to ${adjustment.effectiveBefore} before / ${adjustment.effectiveAfter} after (requested ${adjustment.requestedBefore} / ${adjustment.requestedAfter}; maximum 10 per side). Use ${read} for a larger window.`}var UTF8_ENCODER=new TextEncoder;function buildGrepRepoSuccessPayload(result,options){const envelope={pattern:options.pattern,matches:result.matches.map(projectMatch),hasMore:result.hasMore,filesScanned:result.filesScanned,filesInScope:result.filesInScope,totalMatches:result.totalMatches,uniqueFilesMatched:result.uniqueFilesMatched};if(options.contextClamping)envelope.contextClamping=options.contextClamping;if(options.patternType!=="literal"){envelope.patternType=options.patternType}if(options.caseSensitive)envelope.caseSensitive=true;if(result.binaryFilesSkipped>0){envelope.binaryFilesSkipped=result.binaryFilesSkipped}if(result.filesTooLargeSkipped>0){envelope.filesTooLargeSkipped=result.filesTooLargeSkipped}if(result.truncatedReason&&result.truncatedReason!=="NONE"){envelope.truncatedReason=result.truncatedReason.toLowerCase()}if(options.registry)envelope.registry=options.registry;if(options.name)envelope.name=options.name;if(options.repoUrl)envelope.repoUrl=options.repoUrl;if(options.gitRef)envelope.gitRef=options.gitRef;if(result.nextCursor)envelope.nextCursor=result.nextCursor;if(result.indexedVersion)envelope.indexedVersion=result.indexedVersion;if(result.resolution){envelope.resolution=projectResolution(result.resolution)}const targetResolution=projectTargetResolution(result.targetResolution);if(targetResolution)envelope.targetResolution=targetResolution;const filter=buildFilterBlock(options);if(filter)envelope.filter=filter;return envelope}function projectMatch(match){const projected={filePath:match.filePath,line:match.line,matchStartByte:match.matchStartByte,matchEndByte:match.matchEndByte,lineContent:match.lineContent};if(match.contextBefore&&match.contextBefore.length>0){projected.contextBefore=match.contextBefore}if(match.contextAfter&&match.contextAfter.length>0){projected.contextAfter=match.contextAfter}if(match.fileContentHash)projected.fileContentHash=match.fileContentHash;if(match.fileIntent)projected.fileIntent=match.fileIntent;if(match.symbol)projected.symbol=match.symbol;return projected}function projectResolution(resolution){if(!resolution)return;const out={};if(resolution.requestedVersion)out.requestedVersion=resolution.requestedVersion;if(resolution.requestedRef)out.requestedRef=resolution.requestedRef;if(resolution.resolvedRef)out.resolvedRef=resolution.resolvedRef;if(resolution.commitSha)out.commitSha=resolution.commitSha;return Object.keys(out).length>0?out:undefined}function buildFilterBlock(options){const filter={};if(options.explicit.path&&options.path)filter.path=options.path;if(options.explicit.pathPrefix&&options.pathPrefix){filter.pathPrefix=options.pathPrefix}if(options.explicit.globs&&options.globs&&options.globs.length>0){filter.globs=options.globs}if(options.explicit.extensions&&options.extensions&&options.extensions.length>0){filter.extensions=options.extensions}if(options.explicit.patternType)filter.patternType=options.patternType;if(options.explicit.caseSensitive){filter.caseSensitive=options.caseSensitive}if(options.explicit.excludeDocFiles){filter.excludeDocFiles=options.excludeDocFiles}if(options.explicit.excludeTestFiles){filter.excludeTestFiles=options.excludeTestFiles}if(options.explicit.contextLines&&options.contextLines!==undefined){filter.contextLines=options.contextLines}if(options.explicit.contextLinesBefore){filter.contextLinesBefore=options.contextLinesBefore}if(options.explicit.contextLinesAfter){filter.contextLinesAfter=options.contextLinesAfter}if(options.explicit.maxMatches)filter.maxMatches=options.maxMatches;if(options.explicit.maxMatchesPerFile&&options.maxMatchesPerFile!==undefined){filter.maxMatchesPerFile=options.maxMatchesPerFile}if(options.explicit.cursor&&options.cursor)filter.cursor=options.cursor;if(options.explicit.symbolFields&&options.symbolFields&&options.symbolFields.length>0){filter.symbolFields=options.symbolFields}return Object.keys(filter).length>0?filter:undefined}import{z}from"zod";var symbolKindMap={function:"FUNCTION",method:"METHOD",constructor:"CONSTRUCTOR",getter:"GETTER",setter:"SETTER",operator:"OPERATOR",class:"CLASS",interface:"INTERFACE",trait:"TRAIT",struct:"STRUCT",enum:"ENUM",record:"RECORD",protocol:"PROTOCOL",extension:"EXTENSION",delegate:"DELEGATE",mixin:"MIXIN",actor:"ACTOR",annotation:"ANNOTATION",type:"TYPE",module:"MODULE",namespace:"NAMESPACE",package:"PACKAGE",object:"OBJECT",field:"FIELD",property:"PROPERTY",event:"EVENT",constant:"CONSTANT",doc_section:"DOC_SECTION"};var symbolCategoryMap={callable:"CALLABLE",type:"TYPE",module:"MODULE",data:"DATA",documentation:"DOCUMENTATION"};var fileIntentMap={production:"PRODUCTION",test:"TEST",benchmark:"BENCHMARK",example:"EXAMPLE",generated:"GENERATED",fixture:"FIXTURE",build:"BUILD",vendor:"VENDOR"};function toCodeNavigationRegistry(registry){return toPkgseerRegistry2(registry)}function toSymbolKind(kind){return kind?symbolKindMap[kind]:undefined}function toSymbolCategory(category){return category?symbolCategoryMap[category]:undefined}function toFileIntent(intent){return intent?fileIntentMap[intent]:undefined}function isKnownFileIntent(value){return value in fileIntentMap}function knownFileIntentList(){return Object.keys(fileIntentMap)}function parseCodeNavigationTargetSpec(spec){const trimmed=spec.trim();if(trimmed.length===0){throw new InvalidArgumentError("Target spec cannot be empty.")}if(isRepositoryTargetSpec(trimmed)){return parseRepositoryTargetSpec(trimmed)}let parsed;try{parsed=parsePackageSpec(trimmed)}catch(error){if(error instanceof InvalidPackageSpecError||error instanceof UnsupportedRegistryError){throw buildInvalidTargetSpecError(trimmed,error.message)}throw error}return{registry:toCodeNavigationRegistry(parsed.registry),packageName:parsed.name,version:parsed.version}}var structuredCodeTargetShape={registry:z.enum(PKGSEER_REGISTRY_ARGS).optional().describe(`Package registry (${PKGSEER_REGISTRY_LIST2}). Required for package scope.`),package_name:z.string().max(255).optional().describe("Package name. Required for package scope."),version:z.string().max(100).optional().describe("Package version, e.g. '4.18.2' (defaults to latest). For package scope only."),repo_url:z.string().optional().describe("Full HTTPS repository URL (GitHub, Codeberg, or GitLab). Required for repo scope. Example: https://github.com/expressjs/express"),git_ref:z.string().optional().describe("Git ref - tag, branch, commit, or HEAD. Omit with repo_url to request the backend-resolved default branch.")};var structuredCodeTargetObject=z.object(structuredCodeTargetShape);var structuredCodeTargetSchema=structuredCodeTargetObject.describe("Target: provide registry + package_name (indexed artifact/manifest-root package scope) or repo_url with optional git_ref (public repository scope for the full repository or sibling packages; omitted ref means default branch intent). Swift package targets use swift:github.com/<owner>/<repo> or swift:gitlab.com/<group>/<project>; Zig package targets use zig:gh/<owner>/<repo> or zig:cb/<owner>/<repo>.");var codeTargetSchema=z.union([structuredCodeTargetSchema,z.string().min(1).describe("Compact target string. Package targets inspect an indexed artifact/manifest root: `npm:react@18.2.0` or `npm:react` for latest release; Swift uses `swift:github.com/<owner>/<repo>` or `swift:gitlab.com/<group>/<project>` and Zig uses `zig:gh/<owner>/<repo>` or `zig:cb/<owner>/<repo>`. Use a public repository target for the full repository or sibling packages: `github:facebook/react`, `codeberg:zigil/decimal`, `gitlab:group/subgroup/project`, or approved full HTTPS URLs (GitHub also accepts `github.com/owner/repo` and HTTP), or any repo form with `#HEAD` / `@HEAD` for a git ref. Output uses canonical `provider:path#ref` form. Codeberg requires owner/repo; GitLab allows nested namespaces. Bare owner/repo, self-hosted URLs, web subpaths, credentials, query strings, empty refs, and mixed suffixes are rejected. Refs may contain / and @.")]);function resolveCodeTarget(target){if(typeof target==="string"){try{return parseCodeNavigationTargetSpec(target)}catch(error){return mappedInvalidTargetResult(error)}}const registry=normaliseOptionalValue(target.registry)?.toLowerCase();const packageName=normaliseOptionalValue(target.package_name);const version=normaliseOptionalValue(target.version);const repoUrl=normaliseOptionalValue(target.repo_url);const gitRef=normaliseOptionalValue(target.git_ref);const hasPackageTarget=registry!==undefined||packageName!==undefined;const hasRepoTarget=repoUrl!==undefined||gitRef!==undefined;if(hasPackageTarget&&hasRepoTarget){return invalidTargetResult("Invalid target: provide either registry + package_name or repo_url with optional git_ref, not both.")}if(!hasPackageTarget&&!hasRepoTarget){return invalidTargetResult("Missing target: provide registry + package_name or repo_url.")}if(hasPackageTarget){if(!registry||!packageName){return invalidTargetResult("Incomplete package target: both registry and package_name are required.")}return{registry:toCodeNavigationRegistry(registry),packageName,version}}if(!repoUrl){return invalidTargetResult("Incomplete repository target: repo_url is required.")}return{repoUrl,gitRef}}function normaliseOptionalValue(value){if(value===undefined)return;const trimmed=value.trim();return trimmed.length>0?trimmed:undefined}function mappedInvalidTargetResult(error){const mapped=mapCodeNavigationError(error);return mcpMappedErrorResult(mapped)}function invalidTargetResult(message){return errorResult(JSON.stringify({error:message,code:"INVALID_ARGUMENT",retryable:false}))}var schema={target:codeTargetSchema,pattern:z2.string().optional().describe(GREP_REPO_PATTERN_NOTE),path:z2.string().optional().describe("Exact file path to grep. Shares the same path vocabulary as `code_read`."),path_prefix:z2.string().optional().describe("Literal directory prefix to scope grep, matching `code_files` / `search` naming."),globs:z2.array(z2.string()).optional().describe("Repeatable glob scopes with real glob semantics (e.g. `src/**/*.ts`)."),extensions:z2.array(z2.string()).optional().describe("Extensions to include, without a leading dot."),pattern_type:z2.enum(["literal","regex"]).optional(),case_sensitive:z2.boolean().optional(),exclude_doc_files:z2.boolean().optional(),exclude_test_files:z2.boolean().optional(),context_lines:z2.number().int().min(GREP_REPO_CONTEXT_MIN).optional().describe(`Context lines on both sides of each match (nonnegative integer; capped at ${GREP_REPO_CONTEXT_MAX}). \`context_lines_before\` or \`context_lines_after\` overrides the corresponding side.`),context_lines_before:z2.number().int().min(GREP_REPO_CONTEXT_MIN).optional().describe(`Context lines before each match (nonnegative integer; capped at ${GREP_REPO_CONTEXT_MAX}). Overrides \`context_lines\` for the before side.`),context_lines_after:z2.number().int().min(GREP_REPO_CONTEXT_MIN).optional().describe(`Context lines after each match (nonnegative integer; capped at ${GREP_REPO_CONTEXT_MAX}). Overrides \`context_lines\` for the after side.`),max_matches:z2.number().optional().describe("Maximum total result limit for this page (1-1000, default 50)."),max_matches_per_file:z2.number().optional().describe("Maximum matches from one file on this page (0-1000, 0 = unlimited). Defaults to max_matches, replacing the backend's smaller hidden default; set a lower value when result diversity across files matters."),cursor:z2.string().optional(),symbol_fields:z2.array(z2.enum(GREP_REPO_SYMBOL_FIELDS)).optional().describe(GREP_REPO_SYMBOL_FIELDS_NOTE),wait_timeout_ms:z2.number().optional().describe("Max milliseconds to wait for indexing (0-60000, default 20000). On an `INDEXING` error envelope, use `details.indexingEstimate` when present to decide whether to wait longer, or pass an already-indexed version/ref from `details.availableVersions` / `details.availableRefs`; `suggestedRefs` are fuzzy hints and may need indexing first."),format:z2.enum(["text","json"]).default("text").describe("Use `text` (default) for reading and tool follow-ups; it is token-efficient. Use `json` only to parse responses in code or obtain fields absent from text.")};var DESCRIPTION="Find text, regex, or identifier matches in a public repo or package. Results cover known exact literals, regexes, identifiers, and call sites; they are deterministic and paginated. "+'Use this when you know the pattern (literal by default; pass `pattern_type: "regex"` for RE2). '+"Context is capped at 10 lines per side; larger values are clamped with a notice. For larger windows, use `code_read` on returned paths and line numbers instead of repeating grep. "+"Use `search` for conceptual or open-ended discovery and `code_files` to enumerate paths. "+"Whole-target grep is the default — narrow with `path`, `path_prefix`, `globs`, or `extensions` to keep responses small. "+"Each match's `filePath` (or text file heading) chains into `code_read.path`; pick a window around `match.line` for `code_read.start_line` / `end_line`. "+"When an exact path returns `FILE_NOT_FOUND`, `FILE_PATH_EXCLUDED`, or `SOURCE_FILE_INVENTORY_UNKNOWN`, follow `details.action` to inspect paths available through `code_files`. "+"When fresh data is not ready within the wait window, responses may include `targetResolution` provenance, `indexingEstimate`, and immediately-queryable alternatives in error details. "+"`availableVersions` and `availableRefs` are already indexed/queryable; `suggestedRefs` are fuzzy ref hints and may need indexing first."+`
|
|
49
|
+
|
|
50
|
+
${CODE_GREP_GUARDRAIL}`;function createGrepRepoTool(service){return{name:"code_grep",description:DESCRIPTION,schema,annotations:READ_ONLY_TOOL_ANNOTATIONS,handler:async(args,context)=>{const target=resolveCodeTarget(args.target);if("content"in target)return target;try{const build=buildGrepRepoParams({target,pattern:args.pattern,path:args.path,pathPrefix:args.path_prefix,globs:args.globs,extensions:args.extensions,patternType:args.pattern_type,caseSensitive:args.case_sensitive,excludeDocFiles:args.exclude_doc_files,excludeTestFiles:args.exclude_test_files,contextLines:args.context_lines,contextLinesBefore:args.context_lines_before,contextLinesAfter:args.context_lines_after,maxMatches:args.max_matches,maxMatchesPerFile:args.max_matches_per_file,cursor:args.cursor,symbolFields:args.symbol_fields,waitTimeoutMs:args.wait_timeout_ms});const result=await service.grepRepo(build.params);const payload=buildGrepRepoSuccessPayload(result,{contextClamping:build.contextClamping,registry:target.registry?toPkgseerRegistryLowercase2(target.registry):undefined,name:target.packageName,repoUrl:target.repoUrl,gitRef:target.gitRef,pattern:build.params.pattern,patternType:build.params.patternType==="REGEX"?"regex":"literal",caseSensitive:build.params.caseSensitive??false,path:args.path,pathPrefix:args.path_prefix,globs:args.globs,extensions:args.extensions,contextLines:args.context_lines,contextLinesBefore:build.params.contextLinesBefore??0,contextLinesAfter:build.params.contextLinesAfter??0,maxMatches:build.params.maxMatches??50,maxMatchesPerFile:build.params.maxMatchesPerFile,cursor:args.cursor,symbolFields:build.params.symbolFields,excludeDocFiles:build.params.excludeDocFiles,excludeTestFiles:build.params.excludeTestFiles,explicit:build.explicit});if(isTextFormat(args.format)){return textResult(renderGrepRepoText(payload))}return textResult(JSON.stringify(payload))}catch(error){throwIfCallerCancellation(error,context?.signal);const mapped=withGrepFileRecovery(mapCodeNavigationError(error));return mcpMappedErrorResult(mapped,context)}}}}function isTextFormat(format){return format===undefined||format==="text"}import{z as z3}from"zod";var LIMIT_MIN2=1;var LIMIT_MAX2=1000;var LIMIT_DEFAULT2=200;var WAIT_MIN2=0;function buildListFilesParams(input){const limitExplicit=input.limit!==undefined;const limit=normaliseLimit(input.limit);const waitTimeoutMs=normaliseWaitTimeoutMs(input.waitTimeoutMs);const path=normalizeOptionalNonEmpty2(input.path,"path");const pathPrefix=normalisePathPrefix(input.pathPrefix);const globs=normalizeStringList2(input.globs,"globs");const extensions=normalizeExtensions2(input.extensions);const fileTypes=normalizeStringList2(input.fileTypes,"file_types");const languages=normalizeStringList2(input.languages,"languages");const{fileIntent,fileIntentEcho}=normalizeOptionalFileIntent(input.fileIntent,"file_intent");const fileIntents=normalizeFileIntentList(input.fileIntents,"file_intents");const excludeFileIntents=normalizeFileIntentList(input.excludeFileIntents,"exclude_file_intents");if(fileIntent&&fileIntents.length>0){throw new InvalidPackageSpecError("`file_intent` cannot be combined with `file_intents`.")}const pathSelectors=buildPathSelectors2({path,globs});const pathExplicit=path!==undefined;const pathPrefixExplicit=pathPrefix!==undefined;const globsExplicit=globs.length>0;return{params:{target:input.target,pathSelectors,pathPrefix,extensions:extensions.length>0?extensions:undefined,fileTypes:fileTypes.length>0?fileTypes:undefined,languages:languages.length>0?languages:undefined,fileIntent,fileIntents:fileIntents.length>0?fileIntents:undefined,excludeFileIntents:excludeFileIntents.length>0?excludeFileIntents:undefined,excludeDocFiles:input.excludeDocFiles,excludeTestFiles:input.excludeTestFiles,includeHidden:input.includeHidden,limit,waitTimeoutMs},effectiveLimit:limit,limitExplicit,explicit:{path:pathExplicit,pathPrefix:pathPrefixExplicit,globs:globsExplicit,extensions:extensions.length>0,fileTypes:fileTypes.length>0,languages:languages.length>0,fileIntent:fileIntent!==undefined,fileIntents:fileIntents.length>0,excludeFileIntents:excludeFileIntents.length>0,excludeDocFiles:input.excludeDocFiles!==undefined,excludeTestFiles:input.excludeTestFiles!==undefined,includeHidden:input.includeHidden!==undefined,limit:limitExplicit},filterEcho:{path,pathPrefix,globs:globsExplicit?globs:undefined,extensions:extensions.length>0?extensions:undefined,fileTypes:fileTypes.length>0?fileTypes:undefined,languages:languages.length>0?languages:undefined,fileIntent:fileIntentEcho,fileIntents:fileIntents.length>0?fileIntents.map((intent)=>intent.toLowerCase()):undefined,excludeFileIntents:excludeFileIntents.length>0?excludeFileIntents.map((intent)=>intent.toLowerCase()):undefined,excludeDocFiles:input.excludeDocFiles,excludeTestFiles:input.excludeTestFiles,includeHidden:input.includeHidden,limit:limitExplicit?limit:undefined}}}function buildPathSelectors2(input){const selectors=[];if(input.path)selectors.push({kind:"EXACT",value:input.path});for(const glob of input.globs){selectors.push({kind:"GLOB",value:glob})}return selectors.length>0?selectors:undefined}function normalizeOptionalNonEmpty2(raw,_field){if(raw===undefined)return;const trimmed=raw.trim();return trimmed.length>0?trimmed:undefined}function normalizeStringList2(raw,field){if(!raw)return[];const values=[];for(const entry of raw){const trimmed=entry.trim();if(trimmed.length===0){throw new InvalidPackageSpecError(`\`${field}\` entries cannot be empty.`)}values.push(trimmed)}return values}function normalizeExtensions2(raw){const values=normalizeStringList2(raw,"extensions");for(const value of values){if(value.startsWith(".")){throw new InvalidPackageSpecError("`extensions` values must not include a leading dot.")}}return values}function normalizeOptionalFileIntent(raw,field){if(raw===undefined)return{};const trimmed=raw.trim().toLowerCase();if(trimmed.length===0)return{};if(!isKnownFileIntent(trimmed)){throw new InvalidPackageSpecError(`\`${field}\` must be one of: ${knownFileIntentList().join(", ")}. Got ${raw}.`)}return{fileIntent:toFileIntent(trimmed),fileIntentEcho:trimmed}}function normalizeFileIntentList(raw,field){const values=normalizeStringList2(raw,field);const intents=[];for(const value of values){const lower=value.toLowerCase();if(!isKnownFileIntent(lower)){throw new InvalidPackageSpecError(`\`${field}\` values must be one of: ${knownFileIntentList().join(", ")}. Got ${value}.`)}intents.push(toFileIntent(lower))}return intents}function normaliseLimit(raw){if(raw===undefined)return LIMIT_DEFAULT2;if(!Number.isInteger(raw)||raw<LIMIT_MIN2||raw>LIMIT_MAX2){throw new InvalidPackageSpecError(`\`limit\` must be an integer between ${LIMIT_MIN2} and ${LIMIT_MAX2}. Got ${raw}.`)}return raw}function normaliseWaitTimeoutMs(raw){if(raw===undefined)return DEFAULT_WAIT_TIMEOUT_MS;if(!Number.isInteger(raw)||raw<WAIT_MIN2||raw>MAX_WAIT_TIMEOUT_MS){throw new InvalidPackageSpecError(`\`wait_timeout_ms\` must be an integer between ${WAIT_MIN2} and ${MAX_WAIT_TIMEOUT_MS}. Got ${raw}.`)}return raw}function normalisePathPrefix(raw){if(raw===undefined)return;const trimmed=raw.trim();return trimmed.length>0?trimmed:undefined}var getCodePointsLength=(()=>{const SURROGATE_PAIR_RE=/[\uD800-\uDBFF][\uDC00-\uDFFF]/g;return(input)=>{let surrogatePairsNr=0;SURROGATE_PAIR_RE.lastIndex=0;while(SURROGATE_PAIR_RE.test(input)){surrogatePairsNr+=1}return input.length-surrogatePairsNr}})();var isFullWidth=(x)=>{return x===12288||x>=65281&&x<=65376||x>=65504&&x<=65510};var isWideNotCJKTNotEmoji=(x)=>{return x===8987||x===9001||x>=12272&&x<=12287||x>=12289&&x<=12350||x>=12441&&x<=12543||x>=12549&&x<=12591||x>=12593&&x<=12686||x>=12688&&x<=12771||x>=12783&&x<=12830||x>=12832&&x<=12871||x>=12880&&x<=19903||x>=65040&&x<=65049||x>=65072&&x<=65106||x>=65108&&x<=65126||x>=65128&&x<=65131||x>=127488&&x<=127490||x>=127504&&x<=127547||x>=127552&&x<=127560||x>=131072&&x<=196605||x>=196608&&x<=262141};var ANSI_RE=/[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]|\u001b\]8;[^;]*;.*?(?:\u0007|\u001b\u005c)/y;var CONTROL_RE=/[\x00-\x08\x0A-\x1F\x7F-\x9F]{1,1000}/y;var CJKT_WIDE_RE=/(?:(?![\uFF61-\uFF9F\uFF00-\uFFEF])[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}\p{Script=Tangut}]){1,1000}/yu;var TAB_RE=/\t{1,1000}/y;var EMOJI_RE=/[\u{1F1E6}-\u{1F1FF}]{2}|\u{1F3F4}[\u{E0061}-\u{E007A}]{2}[\u{E0030}-\u{E0039}\u{E0061}-\u{E007A}]{1,3}\u{E007F}|(?:\p{Emoji}\uFE0F\u20E3?|\p{Emoji_Modifier_Base}\p{Emoji_Modifier}?|\p{Emoji_Presentation})(?:\u200D(?:\p{Emoji_Modifier_Base}\p{Emoji_Modifier}?|\p{Emoji_Presentation}|\p{Emoji}\uFE0F\u20E3?))*/yu;var LATIN_RE=/(?:[\x20-\x7E\xA0-\xFF](?!\uFE0F)){1,1000}/y;var MODIFIER_RE=/\p{M}+/gu;var NO_TRUNCATION={limit:Infinity,ellipsis:""};var getStringTruncatedWidth=(input,truncationOptions={},widthOptions={})=>{const LIMIT=truncationOptions.limit??Infinity;const ELLIPSIS=truncationOptions.ellipsis??"";const ELLIPSIS_WIDTH=truncationOptions?.ellipsisWidth??(ELLIPSIS?getStringTruncatedWidth(ELLIPSIS,NO_TRUNCATION,widthOptions).width:0);const ANSI_WIDTH=0;const CONTROL_WIDTH=widthOptions.controlWidth??0;const TAB_WIDTH=widthOptions.tabWidth??8;const EMOJI_WIDTH=widthOptions.emojiWidth??2;const FULL_WIDTH_WIDTH=2;const REGULAR_WIDTH=widthOptions.regularWidth??1;const WIDE_WIDTH=widthOptions.wideWidth??FULL_WIDTH_WIDTH;const PARSE_BLOCKS=[[LATIN_RE,REGULAR_WIDTH],[ANSI_RE,ANSI_WIDTH],[CONTROL_RE,CONTROL_WIDTH],[TAB_RE,TAB_WIDTH],[EMOJI_RE,EMOJI_WIDTH],[CJKT_WIDE_RE,WIDE_WIDTH]];let indexPrev=0;let index=0;let length=input.length;let lengthExtra=0;let truncationEnabled=false;let truncationIndex=length;let truncationLimit=Math.max(0,LIMIT-ELLIPSIS_WIDTH);let unmatchedStart=0;let unmatchedEnd=0;let width=0;let widthExtra=0;outer:while(true){if(unmatchedEnd>unmatchedStart||index>=length&&index>indexPrev){const unmatched=input.slice(unmatchedStart,unmatchedEnd)||input.slice(indexPrev,index);lengthExtra=0;for(const char of unmatched.replaceAll(MODIFIER_RE,"")){const codePoint=char.codePointAt(0)||0;if(isFullWidth(codePoint)){widthExtra=FULL_WIDTH_WIDTH}else if(isWideNotCJKTNotEmoji(codePoint)){widthExtra=WIDE_WIDTH}else{widthExtra=REGULAR_WIDTH}if(width+widthExtra>truncationLimit){truncationIndex=Math.min(truncationIndex,Math.max(unmatchedStart,indexPrev)+lengthExtra)}if(width+widthExtra>LIMIT){truncationEnabled=true;break outer}lengthExtra+=char.length;width+=widthExtra}unmatchedStart=unmatchedEnd=0}if(index>=length){break outer}for(let i=0,l=PARSE_BLOCKS.length;i<l;i++){const[BLOCK_RE,BLOCK_WIDTH]=PARSE_BLOCKS[i];BLOCK_RE.lastIndex=index;if(BLOCK_RE.test(input)){lengthExtra=BLOCK_RE===CJKT_WIDE_RE?getCodePointsLength(input.slice(index,BLOCK_RE.lastIndex)):BLOCK_RE===EMOJI_RE?1:BLOCK_RE.lastIndex-index;widthExtra=lengthExtra*BLOCK_WIDTH;if(width+widthExtra>truncationLimit){truncationIndex=Math.min(truncationIndex,index+Math.floor((truncationLimit-width)/BLOCK_WIDTH))}if(width+widthExtra>LIMIT){truncationEnabled=true;break outer}width+=widthExtra;unmatchedStart=indexPrev;unmatchedEnd=index;index=indexPrev=BLOCK_RE.lastIndex;continue outer}}index+=1}return{width:truncationEnabled?truncationLimit:width,index:truncationEnabled?truncationIndex:length,truncated:truncationEnabled,ellipsed:truncationEnabled&&LIMIT>=ELLIPSIS_WIDTH}};var dist_default=getStringTruncatedWidth;var NO_TRUNCATION2={limit:Infinity,ellipsis:"",ellipsisWidth:0};var fastStringWidth=(input,options={})=>{return dist_default(input,NO_TRUNCATION2,options).width};var dist_default2=fastStringWidth;function terminalWidth(text){return dist_default2(text)}function buildListFilesSuccessPayload(result,options){const files=result.files.map((entry)=>projectEntry(entry));const envelope={total:result.total,hasMore:result.hasMore,files};if(options.registry)envelope.registry=options.registry;if(options.name)envelope.name=options.name;if(options.repoUrl)envelope.repoUrl=options.repoUrl;if(options.gitRef)envelope.gitRef=options.gitRef;if(result.indexedVersion)envelope.indexedVersion=result.indexedVersion;if(result.resolution)envelope.resolution=projectResolution2(result.resolution);const targetResolution=projectTargetResolution(result.targetResolution);if(targetResolution)envelope.targetResolution=targetResolution;if(result.hint)envelope.hint=result.hint;const filter=buildFilterBlock2(options);if(filter)envelope.filter=filter;return envelope}function projectEntry(entry){const lean={path:entry.path};if(entry.name!=null)lean.name=entry.name;if(entry.language!=null)lean.language=entry.language;if(entry.fileType!=null)lean.fileType=entry.fileType;if(entry.byteSize!=null)lean.byteSize=entry.byteSize;return lean}function projectResolution2(resolution){if(!resolution)return;const lean={};if(resolution.requestedVersion)lean.requestedVersion=resolution.requestedVersion;if(resolution.requestedRef)lean.requestedRef=resolution.requestedRef;if(resolution.resolvedRef)lean.resolvedRef=resolution.resolvedRef;if(resolution.commitSha)lean.commitSha=resolution.commitSha;return Object.keys(lean).length>0?lean:undefined}function buildFilterBlock2(options){const filter={};if(options.explicit.path&&options.path){filter.path=options.path}if(options.explicit.pathPrefix&&options.pathPrefix){filter.pathPrefix=options.pathPrefix}if(options.explicit.globs&&options.globs&&options.globs.length>0){filter.globs=options.globs}if(options.explicit.extensions&&options.extensions&&options.extensions.length>0){filter.extensions=options.extensions}if(options.explicit.fileTypes&&options.fileTypes&&options.fileTypes.length>0){filter.fileTypes=options.fileTypes}if(options.explicit.languages&&options.languages&&options.languages.length>0){filter.languages=options.languages}if(options.explicit.fileIntent&&options.fileIntent){filter.fileIntent=options.fileIntent}if(options.explicit.fileIntents&&options.fileIntents&&options.fileIntents.length>0){filter.fileIntents=options.fileIntents}if(options.explicit.excludeFileIntents&&options.excludeFileIntents&&options.excludeFileIntents.length>0){filter.excludeFileIntents=options.excludeFileIntents}if(options.explicit.excludeDocFiles){filter.excludeDocFiles=options.excludeDocFiles}if(options.explicit.excludeTestFiles){filter.excludeTestFiles=options.excludeTestFiles}if(options.explicit.includeHidden){filter.includeHidden=options.includeHidden}if(options.explicit.limit&&options.limit!==undefined){filter.limit=options.limit}return Object.keys(filter).length>0?filter:undefined}var SEP2=" | ";function renderListFilesText(envelope){const lines=[];lines.push(buildHeader2(envelope));lines.push("");if(envelope.files.length===0){lines.push(envelope.hint??"No files match the requested filter.");appendTargetResolutionNotes(lines,envelope);return lines.join(`
|
|
19
51
|
`)}for(const entry of envelope.files){lines.push(entry.path)}if(envelope.hasMore){lines.push("");lines.push("More files available. Pass limit=N or refine the filter.")}if(envelope.hint){lines.push("");lines.push(envelope.hint)}appendTargetResolutionNotes(lines,envelope);return lines.join(`
|
|
20
52
|
`)}function appendTargetResolutionNotes(lines,envelope){const notes=buildTargetResolutionNotes(envelope.targetResolution);if(notes.length===0)return;lines.push("");for(const note of notes)lines.push(note)}function buildHeader2(envelope){const identity=buildIdentity(envelope);const countValue=envelope.hasMore?`${envelope.files.length}+`:String(envelope.total);const parts=[`code_files${SEP2}${countValue} path${countValue==="1"?"":"s"}`];if(identity)parts.push(identity);const filter=buildFilterEcho(envelope);if(filter)parts.push(filter);return parts.join(SEP2)}function buildIdentity(envelope){if(envelope.registry&&envelope.name){const version=envelope.indexedVersion??envelope.resolution?.resolvedRef;return version?`${envelope.registry}:${envelope.name}@${version}`:`${envelope.registry}:${envelope.name}`}if(envelope.repoUrl){return formatRepositoryTarget(envelope.repoUrl,envelope.gitRef)}return""}function buildFilterEcho(envelope){const parts=[];if(envelope.filter?.path){parts.push(`path=${quote2(envelope.filter.path)}`)}if(envelope.filter?.pathPrefix){parts.push(`path_prefix=${quote2(envelope.filter.pathPrefix)}`)}if(envelope.filter?.globs?.length){parts.push(`globs=${envelope.filter.globs.join(",")}`)}if(envelope.filter?.extensions?.length){parts.push(`exts=${envelope.filter.extensions.join(",")}`)}if(envelope.filter?.fileTypes?.length){parts.push(`file_types=${envelope.filter.fileTypes.join(",")}`)}if(envelope.filter?.languages?.length){parts.push(`languages=${envelope.filter.languages.join(",")}`)}if(envelope.filter?.fileIntent){parts.push(`file_intent=${envelope.filter.fileIntent}`)}if(envelope.filter?.fileIntents?.length){parts.push(`file_intents=${envelope.filter.fileIntents.join(",")}`)}if(envelope.filter?.excludeFileIntents?.length){parts.push(`exclude_file_intents=${envelope.filter.excludeFileIntents.join(",")}`)}if(envelope.filter?.excludeDocFiles!==undefined){parts.push(`exclude_doc_files=${String(envelope.filter.excludeDocFiles)}`)}if(envelope.filter?.excludeTestFiles!==undefined){parts.push(`exclude_test_files=${String(envelope.filter.excludeTestFiles)}`)}if(envelope.filter?.includeHidden!==undefined){parts.push(`include_hidden=${String(envelope.filter.includeHidden)}`)}if(envelope.filter?.limit!==undefined){parts.push(`limit=${envelope.filter.limit}`)}return parts.join(" ")}function quote2(value){return value.includes('"')?`'${value}'`:`"${value}"`}var schema2={target:codeTargetSchema,path:z3.string().optional().describe("Exact target-relative file path to include. When combined with `path_prefix` or `globs`, files matching any selector are returned."),path_prefix:z3.string().optional().describe("Literal directory prefix to filter by (e.g. `src/` or `lib/parser`). NOT a glob. OR-ed with `path` and `globs` when combined."),globs:z3.array(z3.string()).optional().describe("Repeatable glob selectors with real glob semantics (e.g. `src/**/*.ts`). OR-ed with `path` and `path_prefix`."),extensions:z3.array(z3.string()).optional().describe("File extensions to include, without a leading dot."),file_types:z3.array(z3.string()).optional().describe("File type filters to include, matching aigrep file_type values such as `source` or `doc`."),languages:z3.array(z3.string()).optional().describe("Language filters to include, matching aigrep language names."),file_intent:z3.string().optional().describe(`Single inclusive file-intent filter. Cannot be combined with \`file_intents\`. Valid values: ${knownFileIntentList().join(", ")}.`),file_intents:z3.array(z3.string()).optional().describe(`Inclusive file-intent filters. Cannot be combined with \`file_intent\`. Valid values: ${knownFileIntentList().join(", ")}.`),exclude_file_intents:z3.array(z3.string()).optional().describe(`Exclude these file intents after inclusive intent filtering. Valid values: ${knownFileIntentList().join(", ")}.`),exclude_doc_files:z3.boolean().optional(),exclude_test_files:z3.boolean().optional(),include_hidden:z3.boolean().optional(),limit:z3.number().optional().describe("Max entries to return (1–1000, default 200). Out-of-range values return an `INVALID_ARGUMENT` envelope."),wait_timeout_ms:z3.number().optional().describe("Max milliseconds to wait for indexing (0-60000, default 20000). On an `INDEXING` error envelope, use `details.indexingEstimate` when present to decide whether to wait longer, or pass an already-indexed version/ref from `details.availableVersions` / `details.availableRefs`; `suggestedRefs` are fuzzy hints and may need indexing first."),format:z3.enum(["text","json"]).default("text").describe("Use `text` (default) for reading and tool follow-ups; it is token-efficient. Use `json` only to parse responses in code or obtain fields absent from text.")};var DESCRIPTION2="List indexed files and paths in a public repo or package. Then use `code_read` or "+"`code_grep`. Use this for enumeration tasks such as files under a directory; use "+"`path_prefix` for directory prefixes (e.g. `lib/`) and optional "+"`extensions` for language filtering. Discover paths before `code_read` "+"when you don't yet know the path, or when it returns "+"`FILE_NOT_FOUND`, `FILE_PATH_EXCLUDED`, or "+"`SOURCE_FILE_INVENTORY_UNKNOWN`. Also use it to scope `code_grep`. Address "+"via `target.registry` + `target.package_name` (package scope) or "+"`target.repo_url` + optional `target.git_ref` (repo scope), mutually "+"exclusive. Narrow with `path`, `path_prefix`, `globs`, "+"`extensions`, `file_types`, `languages`, or file-intent filters. "+"JSON envelope shape: `{total, hasMore, files: [{path, name, "+"language, fileType, byteSize}], resolution, indexedVersion}`. "+"When fresh data is not ready within the wait window, responses may "+"include `targetResolution` provenance, `indexingEstimate`, and immediately-queryable "+"alternatives. `availableVersions` and `availableRefs` are already "+"indexed/queryable; `suggestedRefs` are fuzzy ref hints and may need "+"indexing first. On an `INDEXING` error envelope, retry with a longer "+"`wait_timeout_ms` or use a version/ref from `details.availableVersions` "+"/ `details.availableRefs`.";function createListFilesTool(service){return{name:"code_files",description:DESCRIPTION2,schema:schema2,annotations:READ_ONLY_TOOL_ANNOTATIONS,handler:async(args,context)=>{const target=resolveCodeTarget(args.target);if("content"in target)return target;try{const build=buildListFilesParams({target,path:args.path,pathPrefix:args.path_prefix,globs:args.globs,extensions:args.extensions,fileTypes:args.file_types,languages:args.languages,fileIntent:args.file_intent,fileIntents:args.file_intents,excludeFileIntents:args.exclude_file_intents,excludeDocFiles:args.exclude_doc_files,excludeTestFiles:args.exclude_test_files,includeHidden:args.include_hidden,limit:args.limit,waitTimeoutMs:args.wait_timeout_ms});const result=await service.listFiles(build.params);const payload=buildListFilesSuccessPayload(result,{registry:target.registry?toPkgseerRegistryLowercase2(target.registry):undefined,name:target.packageName,repoUrl:target.repoUrl,gitRef:target.gitRef,path:build.filterEcho.path,pathPrefix:build.filterEcho.pathPrefix,globs:build.filterEcho.globs,extensions:build.filterEcho.extensions,fileTypes:build.filterEcho.fileTypes,languages:build.filterEcho.languages,fileIntent:build.filterEcho.fileIntent,fileIntents:build.filterEcho.fileIntents,excludeFileIntents:build.filterEcho.excludeFileIntents,excludeDocFiles:build.filterEcho.excludeDocFiles,excludeTestFiles:build.filterEcho.excludeTestFiles,includeHidden:build.filterEcho.includeHidden,limit:build.filterEcho.limit,explicit:build.explicit});if(isTextFormat2(args.format)){return textResult(renderListFilesText(payload))}return textResult(JSON.stringify(payload))}catch(error){throwIfCallerCancellation(error,context?.signal);const mapped=mapCodeNavigationError(error);return mcpMappedErrorResult(mapped,context)}}}}function isTextFormat2(format){return format===undefined||format==="text"}import{z as z4}from"zod";function normalisePackageVersion(raw,registry,options={}){if(raw===undefined)return;const version=raw.trim();if(version.length===0)return;if(registry==="GO"){if(/^[0-9]/.test(version))return`v${version}`;if(/^v[0-9]/.test(version))return version}if(options.rejectLeadingV===true&®istry!=="SWIFT"&&/^v[0-9]/i.test(version)){const fieldName=options.fieldName??"version";throw new InvalidPackageSpecError(`Invalid ${fieldName} '${version}': it looks like a git tag. Use the canonical package version without a leading 'v' (for example '${version.slice(1)}').`)}return version}function buildListPackageDocsParams(input){const rawPackageName=input.packageName?.trim()??"";if(!rawPackageName){throw new InvalidPackageSpecError("Package name is required.")}const registry=input.registry?.trim().toLowerCase()??"";if(!isKnownPkgseerRegistryArg(registry)){throw new UnsupportedRegistryError(`Unsupported registry '${input.registry}'. Supported: ${PKGSEER_REGISTRY_LIST2}.`)}const backendRegistry=toPkgseerRegistry2(registry);const params={registry:backendRegistry,packageName:normalisePackageName(rawPackageName,backendRegistry)};const version=normalisePackageVersion(input.version,backendRegistry);if(version!==undefined)params.version=version;const after=input.after?.trim();if(after)params.after=after;if(input.limit!==undefined){if(!Number.isInteger(input.limit)||input.limit<1||input.limit>500){throw new InvalidPackageSpecError("Limit must be an integer between 1 and 500.")}params.limit=input.limit}return{params,limitExplicit:input.limit!==undefined,afterExplicit:Boolean(after)}}function normalisePackageName(packageName,registry){if(registry==="SWIFT"&&/^github\.com\//i.test(packageName)){return packageName.toLowerCase()}return packageName}function lowerDocSourceKind(value){switch(value){case"CRAWLED":return"crawled";case"REPOSITORY":return"repo";default:return}}function buildSearchHitFollowUpCommand(hit,syntax="mcp"){const preferredRead=hit.repositoryEvidence?.semanticContext?.preferredRead;if(preferredRead){const location=semanticReadLocation(preferredRead);const source=hit.repositoryEvidence?.matchedSource??hit.repositoryEvidence?.focusedSource;const range=syntax==="mcp"&&preferredRead.endLine-preferredRead.startLine+1>MCP_READ_MAX_SPAN?boundLargeReadRange(preferredRead,source?{startLine:source.startLine,endLine:source.endLine,matchLine:source.matchLine??undefined}:undefined):preferredRead;const parts=syntax==="cli"?[`githits code read ${shellQuote(location.target)} ${shellQuote(location.path)}`]:[`code_read target=${quote3(location.target)} path=${quote3(location.path)}`];if(syntax==="cli")appendCliRange(parts,range.startLine,range.endLine);else appendRange(parts,range.startLine,range.endLine);return parts.join(" ")}const loc=hit.locator;if(loc.pageId){const docsReadTarget=loc.docsReadTarget??loc.pageId;return syntax==="cli"?buildCliDocsReadCommand(docsReadTarget,loc.startLine,loc.endLine):buildDocsReadCommand(docsReadTarget,loc.startLine,loc.endLine)}if((hit.type==="repository_code"||hit.type==="repository_symbol")&&loc.repoUrl&&!loc.commitSha&&!loc.gitRef&&!isPackageTarget(hit)){return"follow-up unavailable: missing exact revision"}const input=buildSearchHitCodeReadInput(hit,syntax);if(input){return syntax==="cli"?buildCliCodeReadCommand(input):buildCodeReadCommand(input)}if(hit.type==="repository_code"||hit.type==="repository_symbol"){return"follow-up unavailable: missing filePath"}if(loc.sourceUrl)return loc.sourceUrl;return""}function semanticReadLocation(read){if(read.registry&&read.packageName&&read.version&&read.targetLabel.toLowerCase().startsWith(`${read.registry}:${read.packageName}`.toLowerCase())){return{target:`${read.registry.toLowerCase()}:${read.packageName}@${read.version}`,path:read.filePath}}return{target:formatRepositoryTarget(read.repoUrl,read.commitSha),path:read.repositoryFilePath}}function buildSearchHitCodeReadInput(hit,syntax){const loc=hit.locator;const definition=loc.symbolContext?.relation==="encloses_match"?loc.symbolContext.definitionRange:undefined;const evidence=loc.evidenceRange;const targetFilePath=definition?.filePath??loc.filePath;const repositoryFilePath=definition?.repositoryFilePath??loc.repositoryFilePath;let startLine=definition?.startLine??evidence?.startLine??loc.startLine;const trueEndLine=definition?.endLine??evidence?.endLine??loc.endLine;let endLine=trueEndLine;if(syntax==="mcp"&&typeof startLine==="number"&&typeof trueEndLine==="number"&&trueEndLine-startLine+1>MCP_READ_MAX_SPAN){if(definition){({startLine,endLine}=boundLargeReadRange(definition,evidence))}else if(evidence){({startLine,endLine}=boundLargeReadRange(evidence,evidence))}else{endLine=startLine+MCP_READ_MAX_SPAN-1}}const exactRef=loc.commitSha??loc.gitRef;if(loc.repoUrl&&exactRef&&repositoryFilePath){return{repoUrl:loc.repoUrl,gitRef:exactRef,filePath:repositoryFilePath,startLine,endLine}}const filePath=!isPackageTarget(hit)&&repositoryFilePath?repositoryFilePath:targetFilePath;if(!filePath)return;return{registry:loc.registry,packageName:loc.packageName,version:loc.version,repoUrl:loc.repoUrl,gitRef:exactRef,filePath,startLine,endLine,preferPackageTarget:isPackageTarget(hit)}}function boundLargeReadRange(bounds,evidence){const latestStart=bounds.endLine-MCP_READ_MAX_SPAN+1;const evidenceSpan=evidence?evidence.endLine-evidence.startLine+1:undefined;if(evidence&&typeof evidenceSpan==="number"&&evidenceSpan<=MCP_READ_MAX_SPAN){const leadingContext=Math.floor((MCP_READ_MAX_SPAN-evidenceSpan)/2);const startLine=Math.min(Math.max(bounds.startLine,evidence.startLine-leadingContext),latestStart);return{startLine,endLine:startLine+MCP_READ_MAX_SPAN-1}}const focusedLine=evidence?.matchLine??evidence?.startLine;const leadingContext=Math.floor((MCP_READ_MAX_SPAN-1)/2);const startLine=Math.min(Math.max(bounds.startLine,focusedLine===undefined?bounds.startLine:focusedLine-leadingContext),latestStart);return{startLine,endLine:startLine+MCP_READ_MAX_SPAN-1}}function buildCliDocsReadCommand(target,startLine,endLine){const parts=[`githits docs read ${shellQuote(target)}`];appendCliRange(parts,startLine,endLine);return parts.join(" ")}function buildCliCodeReadCommand(input){if(!input.filePath)return"follow-up unavailable: missing filePath";const target=buildTargetSpec(input);if(!target)return"follow-up unavailable: missing target";const parts=["githits code read"];if(input.repoUrl&&!(input.preferPackageTarget&&input.registry&&input.packageName)){parts.push("--repo-url",shellQuote(input.repoUrl));if(input.gitRef)parts.push("--git-ref",shellQuote(input.gitRef))}else{parts.push(shellQuote(target))}parts.push(shellQuote(input.filePath));appendCliRange(parts,input.startLine,input.endLine);return parts.join(" ")}function buildDocsReadCommand(target,startLine,endLine){const parts=[`docs_read page_id=${quote3(target)}`];appendRange(parts,startLine,endLine);return parts.join(" ")}function buildCodeReadCommand(input){if(!input.filePath)return"follow-up unavailable: missing filePath";const target=buildTargetSpec(input);if(!target)return"follow-up unavailable: missing target";const parts=[`code_read target=${quote3(target)}`,`path=${quote3(input.filePath)}`];appendRange(parts,input.startLine,input.endLine);return parts.join(" ")}function buildTargetSpec(input){if(input.preferPackageTarget&&input.registry&&input.packageName){return`${input.registry}:${input.packageName}${input.version?`@${input.version}`:""}`}if(input.repoUrl){return formatRepositoryTarget(input.repoUrl,input.gitRef)}if(input.registry&&input.packageName){return`${input.registry}:${input.packageName}${input.version?`@${input.version}`:""}`}return}function isPackageTarget(hit){const registry=hit.locator.registry;const packageName=hit.locator.packageName;return Boolean(registry&&packageName&&hit.target.startsWith(`${registry}:${packageName}`))}function appendRange(parts,startLine,endLine){if(typeof startLine==="number")parts.push(`start_line=${startLine}`);if(typeof endLine==="number")parts.push(`end_line=${endLine}`)}function appendCliRange(parts,startLine,endLine){if(typeof startLine!=="number"&&typeof endLine!=="number")return;parts.push("--lines",`${typeof startLine==="number"?startLine:""}-${typeof endLine==="number"?endLine:""}`)}function quote3(value){return JSON.stringify(value)}function toIsoDate(iso){if(!iso)return null;const parsed=new Date(iso);if(Number.isNaN(parsed.getTime()))return null;return parsed.toISOString().slice(0,10)}var MINUTE=60;var HOUR=60*MINUTE;var DAY=24*HOUR;var MONTH=30*DAY;var YEAR=365*DAY;function toRelativeDate(iso,now=new Date){if(!iso)return null;const parsed=new Date(iso);if(Number.isNaN(parsed.getTime()))return null;const deltaSeconds=Math.floor((now.getTime()-parsed.getTime())/1000);if(deltaSeconds<0){return toIsoDate(iso)}if(deltaSeconds<MINUTE)return"just now";if(deltaSeconds<HOUR)return formatUnit(deltaSeconds,MINUTE,"minute");if(deltaSeconds<DAY)return formatUnit(deltaSeconds,HOUR,"hour");if(deltaSeconds<MONTH)return formatUnit(deltaSeconds,DAY,"day");if(deltaSeconds<YEAR)return formatUnit(deltaSeconds,MONTH,"month");return formatUnit(deltaSeconds,YEAR,"year")}function formatUnit(deltaSeconds,unit,label){const n=Math.floor(deltaSeconds/unit);return`${n} ${label}${n===1?"":"s"} ago`}function buildListPackageDocsSuccessPayload(result,options){const envelope={hasMore:result.pageInfo?.hasNextPage??false,pages:result.pages.map((page)=>{assertDocListEntry(page);const pageId=page.id;const lastUpdatedAt=toIsoDate(page.lastUpdatedAt);const entry={pageId,docsReadTarget:page.docsReadTarget};if(page.title)entry.title=page.title;const sourceKind=lowerDocSourceKind(page.sourceKind);if(sourceKind)entry.sourceKind=sourceKind;if(page.sourceUrl)entry.sourceUrl=page.sourceUrl;if(page.repoUrl)entry.repoUrl=page.repoUrl;if(page.gitRef)entry.gitRef=page.gitRef;if(page.requestedRef)entry.requestedRef=page.requestedRef;if(page.filePath)entry.filePath=page.filePath;if(lastUpdatedAt)entry.lastUpdatedAt=lastUpdatedAt;return entry})};if(result.registry)envelope.registry=result.registry.toLowerCase();if(result.packageName)envelope.name=result.packageName;if(result.version)envelope.version=result.version;if(typeof result.stale==="boolean")envelope.stale=result.stale;if(result.codeIndexState)envelope.codeIndexState=result.codeIndexState;if(result.pageInfo?.totalCount!==undefined)envelope.total=result.pageInfo.totalCount;if(result.pageInfo?.endCursor)envelope.nextCursor=result.pageInfo.endCursor;const filter={};if(options.limitExplicit&&options.limit!==undefined)filter.limit=options.limit;if(options.afterExplicit&&options.after)filter.after=options.after;if(Object.keys(filter).length>0)envelope.filter=filter;return envelope}function assertDocListEntry(page){if(!page.id){throw new MalformedPackageIntelligenceResponseError("Documentation page list entry missing required id.")}if(!page.docsReadTarget){throw new MalformedPackageIntelligenceResponseError("Documentation page list entry missing required docsReadTarget.")}if(page.sourceKind==="REPOSITORY"&&(!page.repoUrl||!page.gitRef||!page.filePath)){throw new MalformedPackageIntelligenceResponseError("Repository-backed documentation list entry missing repo locator fields.")}}function isPackageDocsActive(envelope){return envelope.codeIndexState==="PENDING"||envelope.codeIndexState==="INDEXING"||envelope.codeIndexState==="PROVISIONAL"}function packageDocsLifecycleLabel(envelope){if(envelope.codeIndexState==="PENDING")return"preparing";if(envelope.codeIndexState==="INDEXING")return"indexing";if(envelope.codeIndexState==="PROVISIONAL")return"provisional";return}function packageDocsProgressDescription(envelope){return envelope.codeIndexState==="PENDING"?"preparation":"indexing"}var SEP3=" | ";function renderListPackageDocsText(envelope){const lines=[];lines.push(buildHeader3(envelope));lines.push("");if(envelope.pages.length===0){lines.push(isPackageDocsActive(envelope)?"No documentation pages yet.":"No documentation pages found.");if(isPackageDocsActive(envelope)){lines.push(`Documentation ${packageDocsProgressDescription(envelope)} is still in progress. Retry ${buildMcpDocsListCall(envelope)} later.`)}return lines.join(`
|
|
21
53
|
`)}for(const page of envelope.pages){lines.push([page.pageId,page.title??"",page.sourceKind??"",page.sourceUrl??""].join(SEP3));lines.push(` ${buildDocsReadCommand(page.docsReadTarget)}`);if(page.sourceKind==="repo"&&page.repoUrl&&page.filePath){lines.push(` ${buildCodeReadCommand({repoUrl:page.repoUrl,gitRef:page.gitRef,filePath:page.filePath,startLine:1,endLine:150})}`)}}if(envelope.nextCursor){lines.push("");lines.push(`More docs available. Pass after=${envelope.nextCursor}.`)}if(envelope.stale){lines.push("");lines.push("Documentation may be stale.")}if(isPackageDocsActive(envelope)){lines.push("");lines.push(`Documentation ${packageDocsProgressDescription(envelope)} is still in progress. Retry ${buildMcpDocsListCall(envelope)} later for a current snapshot.`)}return lines.join(`
|
|
@@ -78,7 +110,7 @@ ${PKG_UPGRADE_REVIEW_GUARDRAIL}`;function createPackageUpgradeReviewTool(service
|
|
|
78
110
|
`).trimEnd()}function formatAdvisoryCapHint(hidden,surface){const hint=surface==="mcp"?"use verbose=true or format=json":"use -v";return`... (+${hidden} more; ${hint})`}function severityColumnLabel(advisory){if(advisory.isMalicious===true){if(advisory.severityLabel)return`MALWARE | ${advisory.severityLabel}`;return"MALWARE"}return advisory.severityLabel??"unrated"}function isPlaceholderSummary(summary){return/^\s*no summary available\s*$/i.test(summary)}function severityColumnColor(advisory,useColors,padded){if(!useColors)return padded;if(advisory.withdrawnAt!==undefined)return dim(padded,useColors);if(advisory.isMalicious===true){return`${colorize(padded,"red",useColors)}`}switch(advisory.severityLabel){case"critical":return colorize(padded,"red",useColors);case"high":return colorize(padded,"yellow",useColors);case"medium":return colorize(padded,"yellow",useColors);case"low":return dim(padded,useColors);default:return dim(padded,useColors)}}function formatAdvisoryLines(advisory,labelWidth,verbose,useColors,rangeLimit,surface){const rawLabel=severityColumnLabel(advisory);const padded=rawLabel.padEnd(labelWidth);const colouredLabel=severityColumnColor(advisory,useColors,padded);const parts=[colouredLabel];if(advisory.id)parts.push(sanitizeIdentity(advisory.id));if(advisory.publishedAt)parts.push(sanitizeIdentity(advisory.publishedAt));if(advisory.summary)parts.push(sanitizeProse(advisory.summary));const lines=[` ${parts.join(" ")}`];const detailWidth=verbose?12:8;const pushRow=(label,value)=>{lines.push(` ${label.padEnd(detailWidth)} ${value}`)};if(advisory.affectedRanges&&advisory.affectedRanges.length>0){pushRow("affected",formatRangeList(advisory.affectedRanges,verbose,useColors,rangeLimit,surface,advisory.affectedVersionRangesCount,advisory.affectedVersionRangesTruncated))}if(advisory.fixedIn&&advisory.fixedIn.length>0){pushRow("fixed in",advisory.fixedIn.map(sanitizeIdentity).join(", "))}if(verbose){if(advisory.aliases&&advisory.aliases.length>0){pushRow("aliases",advisory.aliases.map(sanitizeIdentity).join(", "))}if(typeof advisory.severity==="number"){pushRow("severity",`${advisory.severity} (CVSS)`)}if(advisory.publishedAt){pushRow("published",sanitizeIdentity(advisory.publishedAt))}if(advisory.modifiedAt){pushRow("modified",sanitizeIdentity(advisory.modifiedAt))}if(advisory.withdrawnAt){pushRow("withdrawn",sanitizeIdentity(advisory.withdrawnAt))}if(advisory.isMalicious===true){pushRow("malicious","yes")}}return lines}function formatRangeList(ranges,verbose,useColors,limit,surface,totalCount,backendTruncated){const safeRanges=ranges.map(sanitizeIdentity);const actualTotal=Math.max(totalCount??safeRanges.length,safeRanges.length);const backendHidden=backendTruncated===true?actualTotal-safeRanges.length:0;const appendBackendHint=(shown)=>{if(backendHidden>0){const hint=dim(`... (+${backendHidden} ranges omitted by service)`,useColors);return shown.length>0?`${shown}, ${hint}`:hint}return shown};if(verbose||safeRanges.length<=limit){return appendBackendHint(safeRanges.join(", "))}const shown=safeRanges.slice(0,limit).join(", ");const localHidden=safeRanges.length-limit;const localHint=surface==="mcp"?"use verbose=true":"use -v";const hintText=backendHidden>0?`... (+${localHidden} more with ${localHint}; +${backendHidden} omitted by service)`:`... (+${localHidden} more; ${localHint})`;const hint=dim(hintText,useColors);return`${shown}, ${hint}`}function sanitizeIdentity(value){return sanitizeTerminalText(value)}function sanitizeProse(value){return sanitizeTerminalText(value.replace(/\s+/g," ")).replace(/\s+/g," ").trim()}function formatTransitiveAuditTerminal(audit,options){const width=normaliseTerminalWidth2(options.terminalWidth);const lines=["Resolved dependencies"];lines.push(...wrapFreeText(formatTransitiveSummaryLine(audit),width));const breakdown=formatTransitiveBreakdown(audit.summary,options.useColors,width);if(breakdown)lines.push(breakdown);if(options.includeWithdrawn){lines.push(...wrapFreeText("Dependency analysis excludes withdrawn advisories.",width," "))}const rows=flattenTransitiveRows(audit);if(rows.length>0){lines.push("",...formatTransitiveRows(rows,options))}return lines.join(`
|
|
79
111
|
`)}function formatTransitiveSummaryLine(audit){const summary=audit.summary;const scopeLabel=audit.advisoryScope==="affected"?"affected":"historical";const occurrenceNoun=`${scopeLabel} advisory ${summary.occurrenceCount===1?"occurrence":"occurrences"}`;const packageNoun=summary.packageCount===1?"dependency package":"dependency packages";const versionNoun=summary.totalPackagesAnalyzed===1?"resolved package version":"resolved package versions";if(summary.occurrenceCount===0){const emptyLabel=audit.advisoryScope==="all"?"affected or historical":scopeLabel;return`No ${emptyLabel} advisory occurrences found; ${summary.totalPackagesAnalyzed} ${versionNoun} checked.`}if(audit.advisoryScope==="all"){const occurrences=audit.packages.flatMap((pkg)=>pkg.occurrences);const affected=occurrences.filter((occurrence)=>occurrence.affectsResolvedVersion).length;const historical=occurrences.length-affected;const noun=summary.occurrenceCount===1?"occurrence":"occurrences";return`${summary.occurrenceCount} advisory ${noun} (${affected} affected, ${historical} historical) in ${summary.packageCount} ${packageNoun}; ${summary.totalPackagesAnalyzed} ${versionNoun} checked.`}return`${summary.occurrenceCount} ${occurrenceNoun} in ${summary.packageCount} ${packageNoun}; ${summary.totalPackagesAnalyzed} ${versionNoun} checked.`}var TRANSITIVE_ROW_MARGIN=" ";var TRANSITIVE_COLUMN_SEPARATOR=" ";var TRANSITIVE_SEVERITY_LABEL_WIDTH="critical".length;var TRANSITIVE_COORDINATE_INDENT=TRANSITIVE_ROW_MARGIN.length+TRANSITIVE_SEVERITY_LABEL_WIDTH+TRANSITIVE_COLUMN_SEPARATOR.length;var TRANSITIVE_DETAIL_LABEL_WIDTH="advisory ranges".length;var TRANSITIVE_COORDINATE_PREFIX=" ".repeat(TRANSITIVE_COORDINATE_INDENT);function formatTransitiveBreakdown(summary,useColors,terminalWidth){if(!summary.bySeverity)return;const labels={malware:"MALWARE",critical:"critical",high:"high",medium:"medium",low:"low",unrated:"unrated"};const parts=[];for(const key of BUCKET_ORDER){const count=summary.bySeverity[key];if(typeof count==="number"&&count>0){const part=`${count} ${labels[key]}`;parts.push({text:part,color:key==="malware"?"red":undefined})}}return parts.length>0?formatBreakdownParts(parts,useColors,terminalWidth):undefined}function flattenTransitiveRows(audit){return audit.packages.flatMap((pkg)=>pkg.occurrences.map((occurrence)=>({registry:pkg.registry,name:pkg.name,occurrence}))).sort(compareTransitiveTextRows)}function compareTransitiveTextRows(a,b){const risk=transitiveRiskRank(b.occurrence)-transitiveRiskRank(a.occurrence);if(risk!==0)return risk;const registry=compareStrings(a.registry,b.registry);if(registry!==0)return registry;const name=compareStrings(a.name,b.name);if(name!==0)return name;const version=compareStrings(a.occurrence.resolvedVersion,b.occurrence.resolvedVersion);if(version!==0)return version;const identity=compareStrings(transitiveAdvisoryIdentity(a.occurrence),transitiveAdvisoryIdentity(b.occurrence));if(identity!==0)return identity;return compareStrings(JSON.stringify(a.occurrence),JSON.stringify(b.occurrence))}function formatTransitiveRows(rows,options){const shownRows=options.verbose||options.surface==="cli"?rows:rows.slice(0,DEFAULT_ADVISORY_CAP);const lines=[];for(const row of shownRows){lines.push(...formatTransitiveOccurrence(row,options))}const hidden=rows.length-shownRows.length;if(hidden>0){const hint=options.surface==="mcp"?"use verbose=true or format=json":"use -v";lines.push(...wrapFreeText(`... (+${hidden} more; ${hint})`,normaliseTerminalWidth2(options.terminalWidth)).map((line)=>dim(line,options.useColors)))}return lines}function formatTransitiveOccurrence(row,options){const occurrence=row.occurrence;const label=transitiveSeverityColumnLabel(occurrence);const paddedLabel=label.padEnd(TRANSITIVE_SEVERITY_LABEL_WIDTH);const coordinate=`${sanitizeIdentity(row.name)}@${sanitizeIdentity(occurrence.resolvedVersion)}`;const identity=occurrence.id?sanitizeIdentity(occurrence.id):undefined;const headlineParts=[paddedLabel,coordinate];if(!occurrence.affectsResolvedVersion)headlineParts.push("[historical]");if(identity)headlineParts.push(identity);const headline=`${TRANSITIVE_ROW_MARGIN}${headlineParts.join(TRANSITIVE_COLUMN_SEPARATOR)}`;const lines=formatTransitiveHeadline(headline,occurrence.summary,options.terminalWidth);const coloredLabel=colorize(label,transitiveLabelColor(label),options.useColors);const labelStart=lines[0]?.indexOf(paddedLabel)??0;lines[0]=`${lines[0]?.slice(0,labelStart)??""}${coloredLabel}${" ".repeat(paddedLabel.length-label.length)}${lines[0]?.slice(labelStart+paddedLabel.length)??""}`;if(occurrence.affectsResolvedVersion){lines.push(...formatAtomicDetail("matched",occurrence.matchedAffectedVersionRanges,options.terminalWidth));const nearest=occurrence.nearestFixedVersion?sanitizeIdentity(occurrence.nearestFixedVersion):"no higher fixed version known";lines.push(...formatFreeDetail("nearest fix",nearest,options.terminalWidth));const higherFixesRepeatNearest=occurrence.fixVersionsAboveResolved.length===1&&occurrence.nearestFixedVersion!==undefined&&occurrence.fixVersionsAboveResolved[0]===occurrence.nearestFixedVersion;if(options.verbose&&occurrence.fixVersionsAboveResolved.length>0&&!higherFixesRepeatNearest){lines.push(...formatAtomicDetail("higher fixes",occurrence.fixVersionsAboveResolved,options.terminalWidth))}if(options.verbose&&occurrence.aliases&&occurrence.aliases.length>0){lines.push(...formatAtomicDetail("aliases",occurrence.aliases,options.terminalWidth))}}else if(options.verbose){if(occurrence.affectedRanges&&occurrence.affectedRanges.length>0){lines.push(...formatAtomicDetail("advisory ranges",occurrence.affectedRanges,options.terminalWidth))}if(occurrence.fixedIn&&occurrence.fixedIn.length>0){lines.push(...formatAtomicDetail("advisory fixes",occurrence.fixedIn,options.terminalWidth))}if(occurrence.aliases&&occurrence.aliases.length>0){lines.push(...formatAtomicDetail("aliases",occurrence.aliases,options.terminalWidth))}}return lines}function formatTransitiveHeadline(headline,summary,terminalWidth2){const cleanSummary=summary?sanitizeProse(summary):"";if(!cleanSummary)return[headline];const words=cleanSummary.split(" ").filter(Boolean);const width=normaliseTerminalWidth2(terminalWidth2);const lines=[];let current=headline;for(const word of words){const separator=current===headline?" ":" ";const candidate=`${current}${separator}${word}`;if(terminalWidth(candidate)<=width){current=candidate;continue}lines.push(current.trimEnd());current=`${TRANSITIVE_COORDINATE_PREFIX}${word}`}lines.push(current.trimEnd());return lines}function formatAtomicDetail(label,values,terminalWidth2){const width=normaliseTerminalWidth2(terminalWidth2);const prefix=`${TRANSITIVE_COORDINATE_PREFIX}${label.padEnd(TRANSITIVE_DETAIL_LABEL_WIDTH)} `;const continuation=" ".repeat(prefix.length);const lines=[];let current=prefix;for(const[index,rawValue]of values.entries()){const value=sanitizeIdentity(rawValue);const addition=index===0?value:`, ${value}`;if(index===0||terminalWidth(`${current}${addition}`)<=width){current+=addition;continue}lines.push(current.trimEnd());current=`${continuation}${value}`}if(current!==prefix)lines.push(current.trimEnd());return lines}function formatFreeDetail(label,value,terminalWidth2){const prefix=`${TRANSITIVE_COORDINATE_PREFIX}${label.padEnd(TRANSITIVE_DETAIL_LABEL_WIDTH)} `;const width=normaliseTerminalWidth2(terminalWidth2);const words=sanitizeProse(value).split(" ").filter(Boolean);if(words.length===0)return[prefix.trimEnd()];const continuation=" ".repeat(prefix.length);const lines=[];let current=prefix;for(const word of words){if(current===prefix||terminalWidth(`${current}${current===prefix?"":" "}${word}`)<=width){current+=`${current===prefix?"":" "}${word}`;continue}lines.push(current.trimEnd());current=`${continuation}${word}`}lines.push(current.trimEnd());return lines}function wrapFreeText(value,width,continuationPrefix=" "){const words=value.split(/\s+/).filter(Boolean);if(words.length===0)return[];const lines=[];let current=words[0]??"";for(const word of words.slice(1)){const candidate=`${current} ${word}`;if(terminalWidth(candidate)<=width){current=candidate}else{lines.push(current);current=`${continuationPrefix}${word}`}}lines.push(current);return lines}function transitiveSeverityColumnLabel(occurrence){if(occurrence.isMalicious===true)return"MALWARE";return occurrence.severityLabel??"unrated"}function transitiveLabelColor(label){if(label==="MALWARE"||label==="critical")return"red";if(label==="high"||label==="medium")return"yellow";return"dim"}function normaliseTerminalWidth2(width){if(width===undefined||!Number.isFinite(width))return 80;return Math.max(20,Math.floor(width))}function resolveAffectedRangesLimit(terminalWidth){const cols=typeof terminalWidth==="number"?terminalWidth:80;if(cols>=160)return 8;if(cols>=120)return 6;return 4}function formatUpgradeFooter(paths){if(!paths||paths.length===0)return;const safePaths=paths.map(sanitizeIdentity);if(safePaths.length===1)return`Fix version: ${safePaths[0]}.`;return`Fix versions: ${safePaths.join(", ")}.`}var schema8={registry:z9.string().describe("Package registry. Vulnerability data is available for npm, pypi, hex, crates, nuget, maven, packagist, rubygems, go, and swift; unavailable for vcpkg and zig."),package_name:z9.string().describe("Package name (scoped names ok: @types/node)."),version:z9.string().optional().describe("Specific version to check. Defaults to latest when omitted. Go accepts versions with or without its canonical `v` prefix; tag-style `v` prefixes are rejected for other registries except Swift."),min_severity:z9.string().optional().describe("Only return advisories at or above this severity (`low`, `medium`, `high`, `critical`; uppercase tolerated). Omit to see all, including null-severity advisories."),include_withdrawn:z9.boolean().optional().describe("Include retracted advisories (default: false)."),include_transitive:z9.boolean().optional().describe("Opt in to dependency vulnerability evidence for the resolved graph. Adds graph-analysis cost; min_severity and advisory_scope apply to direct and transitive rows, while include_withdrawn affects direct rows only."),advisory_scope:z9.string().optional().describe("Advisory rows to return: `affected` (default), `non_affecting` for historical advisories that do not affect the inspected version, or `all` for both affected and historical advisories. Counts always include affected/non-affecting/all totals."),verbose:z9.boolean().optional().describe("Text output only. Show every advisory and full detail rows; format=json always returns the complete structured envelope."),format:z9.enum(["text","json"]).default("text").describe("Use `text` (default) for reading and tool follow-ups; it is token-efficient. Use `json` only to parse responses in code or obtain fields absent from text.")};var DESCRIPTION_BASE3="Check current package advisories. Do not trust your memory for vulnerabilities. "+"Advisories can be published or revised after training; a cutoff disclaimer is not current evidence. "+"Covers pinned releases, latest-version risk, and package security history. "+'For package-wide history, omit `version` and pass `advisory_scope:"all"`: `{"registry":"npm","package_name":"next","advisory_scope":"all"}`. '+"Supports npm, PyPI, Hex, Crates, NuGet, Maven, Packagist, RubyGems, Go, and Swift; vcpkg and Zig unsupported. "+"Returns counts/details: identifiers and aliases, including CVEs when available, severity, affected ranges, and fixes; malicious advisories are separate. "+"Pinned lookup: pass `version`; omit it for latest. "+"Default text is capped; `verbose:true` shows all selected rows and identifier aliases (including CVEs), while "+'`format:"json"` returns the complete envelope. `min_severity` filters thresholds (`low`, `medium`, `high`, `critical`); `include_withdrawn` includes retracted advisories. '+"Use `include_transitive:true` for dependency vulnerability evidence covering the resolved graph; this is opt-in because it adds graph-analysis cost. `min_severity` and `advisory_scope` apply to direct and transitive rows, while `include_withdrawn` affects direct rows only and transitive withdrawn advisories remain excluded. "+"Use `pkg_info` for latest health overview or `pkg_upgrade_review` for current-vs-target upgrade evidence.";var DESCRIPTION8=`${DESCRIPTION_BASE3}
|
|
80
112
|
|
|
81
|
-
${PKG_VULNS_GUARDRAIL}`;function createPackageVulnerabilitiesTool(service){return{name:"pkg_vulns",description:DESCRIPTION8,schema:schema8,annotations:READ_ONLY_TOOL_ANNOTATIONS,handler:async(args,context)=>{try{const{params:builtParams,filter}=buildPackageVulnerabilitiesParams({registry:args.registry,packageName:args.package_name,version:args.version,minSeverity:args.min_severity,includeWithdrawn:args.include_withdrawn,includeTransitive:args.include_transitive,advisoryScope:args.advisory_scope});const params={...builtParams,includeTransitiveAdvisoryDetails:args.format==="json"||args.verbose===true&&(builtParams.advisoryScope??"AFFECTED")!=="AFFECTED"};const report=await service.packageVulnerabilities(params);const payload=buildPackageVulnerabilitiesSuccessPayload(report,{requestedVersion:params.version,filter});if(isTextFormat7(args.format)){return textResult(formatPackageVulnerabilitiesTerminal(report,{useColors:false,requestedVersion:params.version,filter,verbose:args.verbose,surface:"mcp"}).trimEnd())}return textResult(JSON.stringify(payload))}catch(error){throwIfCallerCancellation(error,context?.signal);const mapped=mapPackageIntelligenceError(error);return mcpMappedErrorResult(mapped,context)}}}}function isTextFormat7(format){return format===undefined||format==="text"}var schema9={};var DESCRIPTION9="
|
|
113
|
+
${PKG_VULNS_GUARDRAIL}`;function createPackageVulnerabilitiesTool(service){return{name:"pkg_vulns",description:DESCRIPTION8,schema:schema8,annotations:READ_ONLY_TOOL_ANNOTATIONS,handler:async(args,context)=>{try{const{params:builtParams,filter}=buildPackageVulnerabilitiesParams({registry:args.registry,packageName:args.package_name,version:args.version,minSeverity:args.min_severity,includeWithdrawn:args.include_withdrawn,includeTransitive:args.include_transitive,advisoryScope:args.advisory_scope});const params={...builtParams,includeTransitiveAdvisoryDetails:args.format==="json"||args.verbose===true&&(builtParams.advisoryScope??"AFFECTED")!=="AFFECTED"};const report=await service.packageVulnerabilities(params);const payload=buildPackageVulnerabilitiesSuccessPayload(report,{requestedVersion:params.version,filter});if(isTextFormat7(args.format)){return textResult(formatPackageVulnerabilitiesTerminal(report,{useColors:false,requestedVersion:params.version,filter,verbose:args.verbose,surface:"mcp"}).trimEnd())}return textResult(JSON.stringify(payload))}catch(error){throwIfCallerCancellation(error,context?.signal);const mapped=mapPackageIntelligenceError(error);return mcpMappedErrorResult(mapped,context)}}}}function isTextFormat7(format){return format===undefined||format==="text"}var schema9={};var DESCRIPTION9="Choose the GitHits tool for an OSS question before discovering evidence tools. Call this routing guide first unless the loaded githits-mcp skill already contains it. It identifies which tool to discover, the evidence scope, and untrusted-content rules.";var QUICK_START_PREREQUISITE="Before using this tool, call `quick_start` once per session unless the `githits-mcp` skill is loaded.";function createQuickStartTool(guide){return{name:"quick_start",description:DESCRIPTION9,schema:schema9,annotations:READ_ONLY_TOOL_ANNOTATIONS,handler:async()=>textResult(guide)}}import{z as z10}from"zod";function withReadFileRecovery(mapped,requestedPath){if(isExactPathAuthorityError(mapped)){return withExactPathAuthorityRecovery(mapped,"read")}if(mapped.code!=="FILE_NOT_FOUND"&&(mapped.code!=="NOT_FOUND"||!looksLikeMissingFileMessage(mapped.message))){return mapped}const recoveryPath=mapped.details?.filePath??requestedPath;return{...mapped,details:{...mapped.details,action:buildReadFileNotFoundAction(recoveryPath,mapped.code==="FILE_NOT_FOUND")}}}function buildReadFileNotFoundAction(requestedPath,exactFilePath){const prefix=exactFilePath?buildContainingPathPrefix(requestedPath):buildPathPrefixSuggestion(requestedPath);const preamble=exactFilePath?"`code_read` requires an indexed exact file path. ":"`code_read` reads files only, not directories. ";const listing=prefix===""?"Use `code_files` without `path_prefix`":`Use \`code_files\` with \`path_prefix: ${JSON.stringify(prefix)}\``;return`${preamble}${listing} to list valid indexed paths, then `+"pass an emitted `path` back to `code_read`."}var WAIT_MIN3=0;function buildReadFileParams(input){const filePath=input.filePath?.trim()??"";if(!filePath){throw new InvalidPackageSpecError("`file_path` is required — pass the path to the file within the package or repo.")}if(filePath.endsWith("/")){throw new InvalidPackageSpecError(`\`file_path\` must be an exact file path, not a directory prefix. Use \`code_files\` with \`path_prefix: ${JSON.stringify(filePath)}\` to list files, then pass an emitted \`path\` to \`code_read\`.`)}const startLine=normaliseLine(input.startLine,"start_line");const endLine=normaliseLine(input.endLine,"end_line");if(startLine!==undefined&&endLine!==undefined&&startLine>endLine){throw new InvalidPackageSpecError(`Line range is reversed: start_line (${startLine}) must be ≤ end_line (${endLine}).`)}const waitTimeoutMs=normaliseWaitTimeoutMs2(input.waitTimeoutMs);return{params:{target:input.target,filePath,startLine,endLine,waitTimeoutMs}}}function normaliseLine(raw,name){if(raw===undefined)return;if(!Number.isInteger(raw)||raw<1){throw new InvalidPackageSpecError(`\`${name}\` must be a positive integer (lines are 1-indexed). Got ${raw}.`)}return raw}function normaliseWaitTimeoutMs2(raw){if(raw===undefined)return DEFAULT_WAIT_TIMEOUT_MS;if(!Number.isInteger(raw)||raw<WAIT_MIN3||raw>MAX_WAIT_TIMEOUT_MS){throw new InvalidPackageSpecError(`\`wait_timeout_ms\` must be an integer between ${WAIT_MIN3} and ${MAX_WAIT_TIMEOUT_MS}. Got ${raw}.`)}return raw}function buildReadFileSuccessPayload(result,options){const envelope={path:result.filePath??options.requestedFilePath};if(options.registry)envelope.registry=options.registry;if(options.name)envelope.name=options.name;if(options.repoUrl)envelope.repoUrl=options.repoUrl;if(options.gitRef)envelope.gitRef=options.gitRef;if(result.language!=null)envelope.language=result.language;if(result.totalLines!=null)envelope.totalLines=result.totalLines;if(result.startLine!=null)envelope.startLine=result.startLine;if(result.endLine!=null)envelope.endLine=result.endLine;if(result.isBinary){envelope.isBinary=true}else if(result.content!=null){envelope.content=result.content}const targetResolution=projectTargetResolution(result.targetResolution);if(targetResolution)envelope.targetResolution=targetResolution;return envelope}function splitReadFileContentLines(envelope){if(!envelope.content)return[];const bodyLines=envelope.content.split(`
|
|
82
114
|
`);const expectedCount=expectedLineCount(envelope);if(expectedCount===undefined){if(bodyLines[bodyLines.length-1]==="")bodyLines.pop();return bodyLines}while(bodyLines.length>0&&bodyLines[bodyLines.length-1]===""&&bodyLines.length>expectedCount){bodyLines.pop()}return bodyLines}function expectedLineCount(envelope){if(envelope.startLine===undefined||envelope.endLine===undefined){return}if(envelope.endLine<envelope.startLine)return;return envelope.endLine-envelope.startLine+1}var SEP4=" | ";function renderReadFileText(envelope){const lines=[];lines.push(buildHeader4(envelope));lines.push("");if(envelope.isBinary){lines.push("Binary file - cannot display as text.")}else if(envelope.content){appendNumberedContent(lines,envelope.content,envelope.startLine??1,envelope.endLine)}else{lines.push("(no content returned)")}if(envelope.hint){lines.push("");lines.push(`hint: ${envelope.hint}`)}const resolutionNotes=buildTargetResolutionNotes(envelope.targetResolution);if(resolutionNotes.length>0){lines.push("");for(const note of resolutionNotes)lines.push(note)}return lines.join(`
|
|
83
115
|
`)}function buildHeader4(envelope){const parts=[`code_read${SEP4}${envelope.path}`];if(envelope.language)parts.push(envelope.language);const range=buildRange(envelope);if(range)parts.push(range);return parts.join(SEP4)}function buildRange(envelope){if(envelope.startLine!==undefined&&envelope.endLine!==undefined){return envelope.totalLines!==undefined?`lines ${envelope.startLine}-${envelope.endLine}/${envelope.totalLines}`:`lines ${envelope.startLine}-${envelope.endLine}`}if(envelope.totalLines!==undefined)return`${envelope.totalLines} lines`;return}function appendNumberedContent(lines,content,startLine,endLine){const bodyLines=splitReadFileContentLines({content,startLine,endLine});const renderedEndLine=startLine+bodyLines.length-1;const width=String(renderedEndLine).length;for(let i=0;i<bodyLines.length;i+=1){lines.push(`${String(startLine+i).padStart(width," ")} ${bodyLines[i]}`)}}var schema10={target:codeTargetSchema,path:z10.string().describe("Exact file path to read, not a directory. Package addressing: package-relative. Repo addressing: repo-relative. Use `code_files` with `path_prefix` to list directories, then pass an emitted `path` here."),start_line:z10.number().optional().describe(`Starting line (1-indexed). Omit to start at line 1. Without \`end_line\`, the MCP surface returns at most ${MCP_READ_DEFAULT_SPAN} lines. Read only the lines needed from a prior \`search\` / \`code_grep\` hit.`),end_line:z10.number().optional().describe(`Ending line (inclusive). Must be ≥ \`start_line\` when both are set. Omitting it returns ${MCP_READ_DEFAULT_SPAN} lines from \`start_line\`; an explicit range may request up to ${MCP_READ_MAX_SPAN} lines.`),wait_timeout_ms:z10.number().optional().describe("Max milliseconds to wait for indexing (0-60000, default 20000). On an `INDEXING` error envelope, use `details.indexingEstimate` when present to decide whether to wait longer, or pass an already-indexed version/ref from `details.availableVersions` / `details.availableRefs`; `suggestedRefs` are fuzzy hints and may need indexing first."),format:z10.enum(["text","json"]).default("text").describe("Use `text` (default) for reading and tool follow-ups; it is token-efficient. Use `json` only to parse responses in code or obtain fields absent from text.")};var DESCRIPTION_BASE4="Read an exact indexed file or focused window in a public repo or package. Use `code_files` "+"to enumerate paths and `code_grep` or `search` to find the right window. "+`It does not list directories. Reads return ${MCP_READ_DEFAULT_SPAN} lines by default; pass an explicit `+`\`start_line\` / \`end_line\` range for only the lines needed, up to ${MCP_READ_MAX_SPAN} lines. `+"Broader ranges truncate with a `hint` describing what was returned vs. "+"requested. Pick the window from a `search` / `code_grep` "+"match. Binary files omit `content`. When fresh data is not ready within the wait "+"window, responses may include `targetResolution` provenance, "+"`indexingEstimate`, and "+"immediately-queryable alternatives. `availableVersions` and "+"`availableRefs` are already indexed/queryable; `suggestedRefs` "+"are fuzzy ref hints and may need indexing first. On `INDEXING` "+"retry with a longer `wait_timeout_ms` or use a version/ref from "+"error details. "+"On `FILE_NOT_FOUND`, `FILE_PATH_EXCLUDED`, "+"`SOURCE_FILE_INVENTORY_UNKNOWN`, or a legacy `NOT_FOUND` that "+"specifically describes a missing file path, follow `details.action` "+"to inspect paths available through `code_files`.";var DESCRIPTION10=`${DESCRIPTION_BASE4}
|
|
84
116
|
|
package/dist/smoke-test.js
CHANGED
|
@@ -5,4 +5,4 @@ var EXPECTED_MCP_TOOLS=["quick_start","get_example","search_language","pkg_info"
|
|
|
5
5
|
Security
|
|
6
6
|
`)&&upgradeReviewText.includes(`
|
|
7
7
|
Changes
|
|
8
|
-
`),"pkg_upgrade_review default missing grouped evidence");assert(!upgradeReviewText.includes("pkg_upgrade_review")&&!/\b(?:recommendation|risk level|assessment)\b/i.test(upgradeReviewText),"pkg_upgrade_review default leaked assessment language");const upgradeReviewJson=assertJsonResult(await callTool(caller,"pkg_upgrade_review",{registry:"npm",package_name:"express",current_version:"5.0.0",target_version:"5.2.1",skip_transitive_security:true,format:"json"}),"pkg_upgrade_review json");assertRecord(upgradeReviewJson,"pkg_upgrade_review json");assertRecord(upgradeReviewJson.summary,"pkg_upgrade_review json summary");assert(Array.isArray(upgradeReviewJson.reviews),"pkg_upgrade_review json missing reviews array");const firstUpgradeReview=upgradeReviewJson.reviews[0];assert(firstUpgradeReview,"pkg_upgrade_review json missing first review");for(const forbidden of["risk","riskLevel","recommendation","findings","verification"]){assert(!(forbidden in firstUpgradeReview),`pkg_upgrade_review json leaked judgment field ${forbidden}`)}const docsJson=assertJsonResult(await callTool(caller,"docs_list",{...SMOKE_PACKAGE_TARGET,limit:500,format:"json"}),"docs_list json");assertRecord(docsJson,"docs_list json");assert(Array.isArray(docsJson.pages),"docs_list json missing pages array");const docsPages=docsJson.pages;const crawledPage=docsPages.find((page)=>typeof page==="object"&&page!==null&&page.sourceKind==="crawled"&&typeof page.docsReadTarget==="string"&&/^https?:\/\//.test(page.docsReadTarget));const repoPage=docsPages.find((page)=>typeof page==="object"&&page!==null&&page.sourceKind==="repo");assert(crawledPage&&typeof crawledPage.docsReadTarget==="string"&&typeof crawledPage.pageId==="string"&&typeof crawledPage.sourceUrl==="string","docs_list json missing crawled URL target, stable page ID, or source URL");assert(repoPage&&typeof repoPage.docsReadTarget==="string"&&typeof repoPage.pageId==="string"&&typeof repoPage.sourceUrl==="string","docs_list json missing repo-backed target, stable page ID, or source URL");assert(repoPage.docsReadTarget===repoPage.pageId,"docs_list json repo-backed docsReadTarget should remain snapshot-pinned");const crawledPageIndex=docsPages.indexOf(crawledPage);let crawledPageAfter;if(crawledPageIndex>0){const precedingDocs=assertJsonResult(await callTool(caller,"docs_list",{...SMOKE_PACKAGE_TARGET,limit:crawledPageIndex,format:"json"}),"docs_list crawled target cursor");assertRecord(precedingDocs,"docs_list crawled target cursor");assert(typeof precedingDocs.nextCursor==="string","docs_list crawled target cursor missing nextCursor");crawledPageAfter=precedingDocs.nextCursor}const docsText=assertDefaultText(await callTool(caller,"docs_list",{...SMOKE_PACKAGE_TARGET,limit:1,...crawledPageAfter?{after:crawledPageAfter}:{}}),"docs_list crawled target default");assert(docsText.includes(`docs_read page_id=${JSON.stringify(crawledPage.docsReadTarget)}`),"docs_list default missing crawled URL follow-up");const docReadText=assertDefaultText(await callTool(caller,"docs_read",{page_id:crawledPage.docsReadTarget,start_line:1,end_line:5}),"docs_read crawled URL default");assert(docReadText.length>0,"docs_read crawled URL default missing content");const docReadJson=assertJsonResult(await callTool(caller,"docs_read",{page_id:crawledPage.docsReadTarget,start_line:1,end_line:5,format:"json"}),"docs_read crawled URL json");assertRecord(docReadJson,"docs_read crawled URL json");assert(docReadJson.docsReadTarget===crawledPage.docsReadTarget&&docReadJson.pageId===crawledPage.pageId&&docReadJson.sourceUrl===crawledPage.sourceUrl&&typeof docReadJson.content==="string","docs_read crawled URL json missing target, page ID, source URL, or content");const legacyCrawledRead=assertJsonResult(await callTool(caller,"docs_read",{page_id:crawledPage.pageId,start_line:1,end_line:5,format:"json"}),"docs_read legacy crawled ID json");assertRecord(legacyCrawledRead,"docs_read legacy crawled ID json");assert(legacyCrawledRead.pageId===docReadJson.pageId&&legacyCrawledRead.content===docReadJson.content,"docs_read URL and legacy crawled ID returned different ranged content");const repoRead=assertJsonResult(await callTool(caller,"docs_read",{page_id:repoPage.docsReadTarget,format:"json"}),"docs_read repo-backed ID json");assertRecord(repoRead,"docs_read repo-backed ID json");assert(repoRead.docsReadTarget===repoPage.docsReadTarget&&repoRead.pageId===repoPage.pageId&&typeof repoRead.content==="string","docs_read repo-backed ID json missing snapshot target, page ID, or content");assertErrorCode(await callTool(caller,"docs_read",{page_id:"https://docs.example.invalid/githits-smoke-unknown",format:"json"}),"docs_read unknown URL","NOT_FOUND");const codeFilesText=assertDefaultText(await callTool(caller,"code_files",{target:SMOKE_PACKAGE_TARGET,path_prefix:"package.json",limit:1}),"code_files default");assert(codeFilesText.includes("package.json"),"code_files default missing package.json");const codeFilesJson=assertJsonResult(await callTool(caller,"code_files",{target:SMOKE_PACKAGE_TARGET,path_prefix:"package.json",limit:1,format:"json"}),"code_files json");assertRecord(codeFilesJson,"code_files json");assert(Array.isArray(codeFilesJson.files),"code_files json missing files array");const codeReadText=assertDefaultText(await callTool(caller,"code_read",{target:SMOKE_PACKAGE_TARGET,path:"package.json",start_line:1,end_line:5}),"code_read default");assert(/^1\s+/m.test(codeReadText),"code_read default missing line numbers");const codeReadJson=assertJsonResult(await callTool(caller,"code_read",{target:SMOKE_PACKAGE_TARGET,path:"package.json",start_line:1,end_line:5,format:"json"}),"code_read json");assertRecord(codeReadJson,"code_read json");assert(codeReadJson.path==="package.json","code_read json path mismatch");const codeGrepText=assertDefaultText(await callTool(caller,"code_grep",{target:SMOKE_PACKAGE_TARGET,pattern:"express",path:"package.json",max_matches:1}),"code_grep default");assert(codeGrepText.includes("package.json"),"code_grep default missing package.json");const codeGrepJson=assertJsonResult(await callTool(caller,"code_grep",{target:SMOKE_PACKAGE_TARGET,pattern:"express",path:"package.json",max_matches:1,format:"json"}),"code_grep json");assertRecord(codeGrepJson,"code_grep json");assert("matches"in codeGrepJson||"totalMatches"in codeGrepJson,"code_grep json missing matches");const searchText=assertDefaultText(await callTool(caller,"search",{target:SMOKE_PACKAGE_TARGET,query:"router",limit:1}),"search default");assertSearchDefaultText(searchText,"search default");const searchJson=assertJsonResult(await callTool(caller,"search",{target:SMOKE_PACKAGE_TARGET,query:"router",limit:1,format:"json"}),"search json");assertRecord(searchJson,"search json");const searchRef=typeof searchJson.searchRef==="string"?searchJson.searchRef:undefined;if(searchRef){const statusJson=assertJsonResult(await callTool(caller,"search_status",{search_ref:searchRef,wait_timeout_ms:0,format:"json"}),"search_status json");assertRecord(statusJson,"search_status json");assert("completed"in statusJson||"progress"in statusJson,"search_status json missing status data")}else{assertErrorCode(await callTool(caller,"search_status",{search_ref:"smoke-invalid-search-ref",wait_timeout_ms:0}),"search_status invalid ref","NOT_FOUND")}}async function runMcpSmoke(caller,options={}){const logger=options.logger??console;const includeLiveTools=options.includeLiveTools??true;const toolsResponse=await caller.listTools();const toolNames=new Set(toolsResponse.tools.map((tool)=>tool.name));assert(!toolNames.has("feedback"),"listTools advertises removed feedback tool");for(const expected of EXPECTED_MCP_TOOLS){assert(toolNames.has(expected),`listTools missing ${expected}`)}for(const tool of toolsResponse.tools){assert(tool.annotations?.readOnlyHint===true,`${tool.name} must advertise readOnlyHint: true`)}const quickStart=assertDefaultText(await callTool(caller,"quick_start",{}),"quick_start default");for(const expected of["GitHits
|
|
8
|
+
`),"pkg_upgrade_review default missing grouped evidence");assert(!upgradeReviewText.includes("pkg_upgrade_review")&&!/\b(?:recommendation|risk level|assessment)\b/i.test(upgradeReviewText),"pkg_upgrade_review default leaked assessment language");const upgradeReviewJson=assertJsonResult(await callTool(caller,"pkg_upgrade_review",{registry:"npm",package_name:"express",current_version:"5.0.0",target_version:"5.2.1",skip_transitive_security:true,format:"json"}),"pkg_upgrade_review json");assertRecord(upgradeReviewJson,"pkg_upgrade_review json");assertRecord(upgradeReviewJson.summary,"pkg_upgrade_review json summary");assert(Array.isArray(upgradeReviewJson.reviews),"pkg_upgrade_review json missing reviews array");const firstUpgradeReview=upgradeReviewJson.reviews[0];assert(firstUpgradeReview,"pkg_upgrade_review json missing first review");for(const forbidden of["risk","riskLevel","recommendation","findings","verification"]){assert(!(forbidden in firstUpgradeReview),`pkg_upgrade_review json leaked judgment field ${forbidden}`)}const docsJson=assertJsonResult(await callTool(caller,"docs_list",{...SMOKE_PACKAGE_TARGET,limit:500,format:"json"}),"docs_list json");assertRecord(docsJson,"docs_list json");assert(Array.isArray(docsJson.pages),"docs_list json missing pages array");const docsPages=docsJson.pages;const crawledPage=docsPages.find((page)=>typeof page==="object"&&page!==null&&page.sourceKind==="crawled"&&typeof page.docsReadTarget==="string"&&/^https?:\/\//.test(page.docsReadTarget));const repoPage=docsPages.find((page)=>typeof page==="object"&&page!==null&&page.sourceKind==="repo");assert(crawledPage&&typeof crawledPage.docsReadTarget==="string"&&typeof crawledPage.pageId==="string"&&typeof crawledPage.sourceUrl==="string","docs_list json missing crawled URL target, stable page ID, or source URL");assert(repoPage&&typeof repoPage.docsReadTarget==="string"&&typeof repoPage.pageId==="string"&&typeof repoPage.sourceUrl==="string","docs_list json missing repo-backed target, stable page ID, or source URL");assert(repoPage.docsReadTarget===repoPage.pageId,"docs_list json repo-backed docsReadTarget should remain snapshot-pinned");const crawledPageIndex=docsPages.indexOf(crawledPage);let crawledPageAfter;if(crawledPageIndex>0){const precedingDocs=assertJsonResult(await callTool(caller,"docs_list",{...SMOKE_PACKAGE_TARGET,limit:crawledPageIndex,format:"json"}),"docs_list crawled target cursor");assertRecord(precedingDocs,"docs_list crawled target cursor");assert(typeof precedingDocs.nextCursor==="string","docs_list crawled target cursor missing nextCursor");crawledPageAfter=precedingDocs.nextCursor}const docsText=assertDefaultText(await callTool(caller,"docs_list",{...SMOKE_PACKAGE_TARGET,limit:1,...crawledPageAfter?{after:crawledPageAfter}:{}}),"docs_list crawled target default");assert(docsText.includes(`docs_read page_id=${JSON.stringify(crawledPage.docsReadTarget)}`),"docs_list default missing crawled URL follow-up");const docReadText=assertDefaultText(await callTool(caller,"docs_read",{page_id:crawledPage.docsReadTarget,start_line:1,end_line:5}),"docs_read crawled URL default");assert(docReadText.length>0,"docs_read crawled URL default missing content");const docReadJson=assertJsonResult(await callTool(caller,"docs_read",{page_id:crawledPage.docsReadTarget,start_line:1,end_line:5,format:"json"}),"docs_read crawled URL json");assertRecord(docReadJson,"docs_read crawled URL json");assert(docReadJson.docsReadTarget===crawledPage.docsReadTarget&&docReadJson.pageId===crawledPage.pageId&&docReadJson.sourceUrl===crawledPage.sourceUrl&&typeof docReadJson.content==="string","docs_read crawled URL json missing target, page ID, source URL, or content");const legacyCrawledRead=assertJsonResult(await callTool(caller,"docs_read",{page_id:crawledPage.pageId,start_line:1,end_line:5,format:"json"}),"docs_read legacy crawled ID json");assertRecord(legacyCrawledRead,"docs_read legacy crawled ID json");assert(legacyCrawledRead.pageId===docReadJson.pageId&&legacyCrawledRead.content===docReadJson.content,"docs_read URL and legacy crawled ID returned different ranged content");const repoRead=assertJsonResult(await callTool(caller,"docs_read",{page_id:repoPage.docsReadTarget,format:"json"}),"docs_read repo-backed ID json");assertRecord(repoRead,"docs_read repo-backed ID json");assert(repoRead.docsReadTarget===repoPage.docsReadTarget&&repoRead.pageId===repoPage.pageId&&typeof repoRead.content==="string","docs_read repo-backed ID json missing snapshot target, page ID, or content");assertErrorCode(await callTool(caller,"docs_read",{page_id:"https://docs.example.invalid/githits-smoke-unknown",format:"json"}),"docs_read unknown URL","NOT_FOUND");const codeFilesText=assertDefaultText(await callTool(caller,"code_files",{target:SMOKE_PACKAGE_TARGET,path_prefix:"package.json",limit:1}),"code_files default");assert(codeFilesText.includes("package.json"),"code_files default missing package.json");const codeFilesJson=assertJsonResult(await callTool(caller,"code_files",{target:SMOKE_PACKAGE_TARGET,path_prefix:"package.json",limit:1,format:"json"}),"code_files json");assertRecord(codeFilesJson,"code_files json");assert(Array.isArray(codeFilesJson.files),"code_files json missing files array");const codeReadText=assertDefaultText(await callTool(caller,"code_read",{target:SMOKE_PACKAGE_TARGET,path:"package.json",start_line:1,end_line:5}),"code_read default");assert(/^1\s+/m.test(codeReadText),"code_read default missing line numbers");const codeReadJson=assertJsonResult(await callTool(caller,"code_read",{target:SMOKE_PACKAGE_TARGET,path:"package.json",start_line:1,end_line:5,format:"json"}),"code_read json");assertRecord(codeReadJson,"code_read json");assert(codeReadJson.path==="package.json","code_read json path mismatch");const codeGrepText=assertDefaultText(await callTool(caller,"code_grep",{target:SMOKE_PACKAGE_TARGET,pattern:"express",path:"package.json",max_matches:1,context_lines_after:12}),"code_grep default");assert(codeGrepText.includes("package.json"),"code_grep default missing package.json");assert(codeGrepText.includes("requested 0 / 12"),"code_grep missing context clamping notice");const codeGrepJson=assertJsonResult(await callTool(caller,"code_grep",{target:SMOKE_PACKAGE_TARGET,pattern:"express",path:"package.json",max_matches:1,context_lines_after:12,format:"json"}),"code_grep json");assertRecord(codeGrepJson,"code_grep json");assert("matches"in codeGrepJson||"totalMatches"in codeGrepJson,"code_grep json missing matches");assertRecord(codeGrepJson.contextClamping,"code_grep context clamping");assert(codeGrepJson.contextClamping.requestedAfter===12&&codeGrepJson.contextClamping.effectiveAfter===10,"code_grep context clamping mismatch");const searchText=assertDefaultText(await callTool(caller,"search",{target:SMOKE_PACKAGE_TARGET,query:"router",limit:1}),"search default");assertSearchDefaultText(searchText,"search default");const searchJson=assertJsonResult(await callTool(caller,"search",{target:SMOKE_PACKAGE_TARGET,query:"router",limit:1,format:"json"}),"search json");assertRecord(searchJson,"search json");const searchRef=typeof searchJson.searchRef==="string"?searchJson.searchRef:undefined;if(searchRef){const statusJson=assertJsonResult(await callTool(caller,"search_status",{search_ref:searchRef,wait_timeout_ms:0,format:"json"}),"search_status json");assertRecord(statusJson,"search_status json");assert("completed"in statusJson||"progress"in statusJson,"search_status json missing status data")}else{assertErrorCode(await callTool(caller,"search_status",{search_ref:"smoke-invalid-search-ref",wait_timeout_ms:0}),"search_status invalid ref","NOT_FOUND")}}async function runMcpSmoke(caller,options={}){const logger=options.logger??console;const includeLiveTools=options.includeLiveTools??true;const toolsResponse=await caller.listTools();const toolNames=new Set(toolsResponse.tools.map((tool)=>tool.name));assert(!toolNames.has("feedback"),"listTools advertises removed feedback tool");for(const expected of EXPECTED_MCP_TOOLS){assert(toolNames.has(expected),`listTools missing ${expected}`)}for(const tool of toolsResponse.tools){assert(tool.annotations?.readOnlyHint===true,`${tool.name} must advertise readOnlyHint: true`)}const quickStart=assertDefaultText(await callTool(caller,"quick_start",{}),"quick_start default");for(const expected of["GitHits routing guide","`search`","`code_grep`"]){assert(quickStart.includes(expected),`quick_start default missing ${expected}`)}if(!includeLiveTools)return;if(await assertLiveOrAuthRequired(caller,logger)){await runLiveSmoke(caller);logger.log("MCP smoke passed")}}export{EXPECTED_MCP_TOOLS,assertCleanErrorEnvelope,assertDefaultText,assertHttpUnauthorizedChallenge,assertJsonResult,callToolText,resultText,runMcpSmoke};
|