@j0hanz/filesystem-mcp 2.1.1 → 2.1.3

package/dist/tools/search-content.js

@@ -2,30 +2,27 @@ import { stat } from 'node:fs/promises';
 import { basename, dirname } from 'node:path';
 import * as z from 'zod/v4';
 import { SearchStoppedReasonSchema } from '../core/concurrency.js';
-import { createFirstPage, readNextPage } from '../core/cursor.js';
+import { paginate } from '../core/cursor.js';
 import { ErrorCode, FsError } from '../core/errors.js';
 import { formatCount, truncateProgressPattern } from '../core/fmt.js';
 import { DEFAULT_EXCLUDE_PATTERNS } from '../core/glob.js';
+import { Logger } from '../core/observability.js';
 import { toPosixRelative } from '../core/path.js';
 import { escapeRegexLiteral } from '../core/primitives.js';
 import { CursorSchema, defaultFalseBoolean, includeHiddenField, includeIgnoredField, isBlank, maxDepthField, NextCursorSchema, NonNegInt, OptionalPath, PositiveInt, SafeGlobPattern, } from '../core/schema.js';
 import { compileRegex, freeRegex, searchContent } from '../core/search.js';
 import { putJsonResource } from '../core/store.js';
-import { DEFAULT_SEARCH_CONTENT_RESULTS, DEFAULT_SEARCH_TIMEOUT_MS, MAX_SEARCH_RESULTS, parseEnvInt, } from '../core/util.js';
+import { DEFAULT_SEARCH_CONTENT_RESULTS, DEFAULT_SEARCH_TIMEOUT_MS, MAX_SEARCH_RESULTS, } from '../core/util.js';
 import { defineTool } from './define.js';
 /**
- * Configuration constants for the Search Content tool.
+ * `FS_MAX_INLINE_MATCHES` used to cap how many matches a page showed inline
+ * and, past it, push the rest into the resource store. `maxResults` is the one
+ * page size now, and the full list is externalized whenever a response is
+ * incomplete, so the variable does nothing. It is still read so an operator who
+ * set it hears why it stopped mattering; the read goes at the next major.
  */
-const CONFIG = {
-    MAX_INLINE_MATCHES: parseEnvInt('FS_MAX_INLINE_MATCHES', 50, 1, 10_000),
-};
-function buildSearchPreviewState(payloads) {
-    const needsExternalize = payloads.length > CONFIG.MAX_INLINE_MATCHES;
-    const visibleCount = needsExternalize ? CONFIG.MAX_INLINE_MATCHES : payloads.length;
-    return {
-        needsExternalize,
-        visiblePayloads: payloads.slice(0, visibleCount),
-    };
+if (process.env['FS_MAX_INLINE_MATCHES'] !== undefined) {
+    Logger.warn('FS_MAX_INLINE_MATCHES is deprecated and ignored: maxResults sets the search_text page size. It will be removed in the next major release.');
 }
 const GrepInputSchema = z.strictObject({
     path: OptionalPath.describe('File to search, or directory to search under (default: the whole first allowed root). Naming a file searches that file alone: pattern is ignored and hidden/ignored filtering does not apply.'),
@@ -71,12 +68,12 @@ const GrepOutputSchema = z.strictObject({
     truncated: z
         .boolean()
         .optional()
-        .describe('True when the match list was cut due to maxResults or timeout'),
+        .describe('True when the search engine cut the match list — the hard result cap or the time limit. Paging is not truncation: a set that spans pages has nextCursor instead.'),
     stoppedReason: SearchStoppedReasonSchema.describe('Why the search ended early: maxResults = result cap reached, timeout = time limit hit or the request was cancelled. Absent when the scan ran to completion.'),
     resourceUri: z
         .string()
         .optional()
-        .describe('URI to the full match list in the resource store (present when matches exceed the inline limit)'),
+        .describe('URI to the full match list in the resource store; first page only, whenever the response is incomplete — more pages follow, or the engine cut the search'),
     nextCursor: NextCursorSchema,
 });
 function buildSearchMatchDetail(totalMatches, filesMatched) {
@@ -85,9 +82,9 @@ function buildSearchMatchDetail(totalMatches, filesMatched) {
         return matchDetail;
     return `${matchDetail} · ${formatCount(filesMatched, 'file', 'files')}`;
 }
-function searchContentOutput(matches, metadata) {
+function searchContentOutput(matches, metadata, nextCursor, resourceUri) {
     return {
-        matches,
+        matches: [...matches],
         totalMatches: metadata.totalMatches,
         filesScanned: metadata.filesScanned,
         ...(metadata.filesMatched ? { filesMatched: metadata.filesMatched } : {}),
@@ -95,6 +92,8 @@ function searchContentOutput(matches, metadata) {
         ...(metadata.stoppedReason !== undefined ? { stoppedReason: metadata.stoppedReason } : {}),
         ...(metadata.skippedInaccessible ? { skippedInaccessible: metadata.skippedInaccessible } : {}),
         ...(metadata.skippedTooLarge ? { skippedTooLarge: metadata.skippedTooLarge } : {}),
+        ...(resourceUri !== undefined ? { resourceUri } : {}),
+        ...(nextCursor !== undefined ? { nextCursor } : {}),
     };
 }
 function findColumnOffset(content, context) {
@@ -170,32 +169,10 @@ function createSearchContext(args, matcher) {
         ...(matcher ? { matcher } : {}),
     };
 }
-function buildExternalizedResponse(fullStructured, preview, resourceStore, searchPattern) {
-    const { entry, link } = putJsonResource(resourceStore, `'${searchPattern}' matches`, fullStructured);
-    const structuredForResponse = {
-        ...fullStructured,
-        resourceUri: entry.uri,
-    };
-    if (preview.needsExternalize) {
-        structuredForResponse.matches = preview.visiblePayloads;
-        structuredForResponse.truncated = true;
-    }
-    return { structured: structuredForResponse, link };
-}
 function sortedPayloads(result, args, regexMatcher) {
     const searchContext = createSearchContext(args, regexMatcher);
     return buildSortedPayloads(result, searchContext);
 }
-function finalizeSearchOutput(fullStructured, preview, resourceStore, searchPattern) {
-    if (resourceStore && preview.needsExternalize) {
-        return buildExternalizedResponse(fullStructured, preview, resourceStore, searchPattern ?? '');
-    }
-    if (preview.needsExternalize) {
-        fullStructured.matches = preview.visiblePayloads;
-        fullStructured.truncated = true;
-    }
-    return { structured: fullStructured };
-}
 /**
  * `path` is documented as "file to search, or directory to search under", but
  * the scan itself only walks directories. A file path is therefore rewritten
@@ -239,58 +216,52 @@ function searchContentQueryKey(args, requestedPath) {
 async function handleSearchContent(args, ctx) {
     const requestedPath = ctx.fs.pathGuard.resolvePathOrRoot(args.path);
     const queryKey = searchContentQueryKey(args, requestedPath);
-    if (args.cursor !== undefined) {
-        const paged = readNextPage({
-            store: ctx.pageStore,
-            queryKey,
-            cursor: args.cursor,
-            pageSize: args.maxResults,
-        });
-        const fullStructured = searchContentOutput([...paged.page], paged.metadata);
-        if (paged.nextCursor !== undefined)
-            fullStructured.nextCursor = paged.nextCursor;
-        const preview = buildSearchPreviewState([...paged.page]);
-        return finalizeSearchOutput(fullStructured, preview, ctx.resourceStore, args.searchPattern);
-    }
-    const { basePath, args: scoped } = await resolveSearchScope(args, ctx);
-    const regexMatcher = createSearchMatcher(scoped);
-    const result = await searchContent(basePath, scoped.searchPattern, buildSearchContentOptions({ ...scoped, maxResults: MAX_SEARCH_RESULTS }, ctx.signal), ctx.fs.pathGuard);
-    // regexMatcher holds wasm memory re2-wasm never reclaims on its own.
-    let allMatchPayloads;
-    try {
-        allMatchPayloads = sortedPayloads(result, scoped, regexMatcher);
-    }
-    finally {
-        freeRegex(regexMatcher);
-    }
-    const metadata = {
-        totalMatches: result.summary.matchingLines,
-        filesScanned: result.summary.filesScanned,
-        ...(result.summary.filesMatched ? { filesMatched: result.summary.filesMatched } : {}),
-        truncated: result.summary.truncated,
-        ...(result.summary.stoppedReason !== undefined && result.summary.stoppedReason !== 'maxFiles'
-            ? { stoppedReason: result.summary.stoppedReason }
-            : {}),
-        ...(result.summary.skippedInaccessible
-            ? { skippedInaccessible: result.summary.skippedInaccessible }
-            : {}),
-        ...(result.summary.skippedTooLarge ? { skippedTooLarge: result.summary.skippedTooLarge } : {}),
-    };
-    const paged = createFirstPage({
+    const { resourceStore } = ctx;
+    const paged = await paginate({
         store: ctx.pageStore,
         queryKey,
-        items: allMatchPayloads,
-        metadata,
-        pageSize: scoped.maxResults,
+        cursor: args.cursor,
+        pageSize: args.maxResults,
+        produce: async () => {
+            const { basePath, args: scoped } = await resolveSearchScope(args, ctx);
+            const regexMatcher = createSearchMatcher(scoped);
+            const result = await searchContent(basePath, scoped.searchPattern, buildSearchContentOptions({ ...scoped, maxResults: MAX_SEARCH_RESULTS }, ctx.signal), ctx.fs.pathGuard);
+            // regexMatcher holds wasm memory re2-wasm never reclaims on its own.
+            let items;
+            try {
+                items = sortedPayloads(result, scoped, regexMatcher);
+            }
+            finally {
+                freeRegex(regexMatcher);
+            }
+            return {
+                items,
+                metadata: {
+                    totalMatches: result.summary.matchingLines,
+                    filesScanned: result.summary.filesScanned,
+                    ...(result.summary.filesMatched ? { filesMatched: result.summary.filesMatched } : {}),
+                    truncated: result.summary.truncated,
+                    ...(result.summary.stoppedReason !== undefined &&
+                        result.summary.stoppedReason !== 'maxFiles'
+                        ? { stoppedReason: result.summary.stoppedReason }
+                        : {}),
+                    ...(result.summary.skippedInaccessible
+                        ? { skippedInaccessible: result.summary.skippedInaccessible }
+                        : {}),
+                    ...(result.summary.skippedTooLarge
+                        ? { skippedTooLarge: result.summary.skippedTooLarge }
+                        : {}),
+                },
+                truncated: result.summary.truncated,
+            };
+        },
+        externalize: resourceStore
+            ? (matches, metadata) => putJsonResource(resourceStore, `'${args.searchPattern}' matches`, searchContentOutput(matches, metadata, undefined, undefined))
+            : undefined,
     });
-    const fullStructured = searchContentOutput([...paged.page], metadata);
-    if (paged.nextCursor !== undefined)
-        fullStructured.nextCursor = paged.nextCursor;
-    const preview = buildSearchPreviewState([...paged.page]);
-    const { structured, link } = finalizeSearchOutput(fullStructured, preview, ctx.resourceStore, args.searchPattern);
     return {
-        structured,
-        ...(link !== undefined ? { link } : {}),
+        structured: searchContentOutput(paged.page, paged.metadata, paged.nextCursor, paged.resource?.entry.uri),
+        ...(paged.resource ? { link: paged.resource.link } : {}),
     };
 }
 export const SEARCH_CONTENT = defineTool({

package/dist/tools/search-content.js.map

@@ -1 +1 @@
-{"version":3,"file":"search-content.js","sourceRoot":"","sources":["../../src/tools/search-content.ts"],"names":[],"mappings":"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","sourcesContent":["import { stat } from 'node:fs/promises';\nimport { basename, dirname } from 'node:path';\n\nimport * as z from 'zod/v4';\n\nimport { SearchStoppedReasonSchema } from '../core/concurrency.js';\nimport { createFirstPage, readNextPage } from '../core/cursor.js';\nimport { ErrorCode, FsError } from '../core/errors.js';\nimport { formatCount, truncateProgressPattern } from '../core/fmt.js';\nimport { DEFAULT_EXCLUDE_PATTERNS } from '../core/glob.js';\nimport { toPosixRelative } from '../core/path.js';\nimport { escapeRegexLiteral } from '../core/primitives.js';\nimport {\n  CursorSchema,\n  defaultFalseBoolean,\n  includeHiddenField,\n  includeIgnoredField,\n  isBlank,\n  maxDepthField,\n  NextCursorSchema,\n  NonNegInt,\n  OptionalPath,\n  PositiveInt,\n  SafeGlobPattern,\n} from '../core/schema.js';\nimport type { Regex, SearchContentOptions } from '../core/search.js';\nimport { compileRegex, freeRegex, searchContent } from '../core/search.js';\nimport type { ResourceStore } from '../core/store.js';\nimport { putJsonResource } from '../core/store.js';\nimport {\n  DEFAULT_SEARCH_CONTENT_RESULTS,\n  DEFAULT_SEARCH_TIMEOUT_MS,\n  MAX_SEARCH_RESULTS,\n  parseEnvInt,\n} from '../core/util.js';\nimport { defineTool, type ToolCtx } from './define.js';\n\n/**\n * Configuration constants for the Search Content tool.\n */\nconst CONFIG = {\n  MAX_INLINE_MATCHES: parseEnvInt('FS_MAX_INLINE_MATCHES', 50, 1, 10_000),\n} as const;\n\n// Type Definitions\ntype SearchInput = z.infer<typeof GrepInputSchema>;\ntype SearchOutput = z.infer<typeof GrepOutputSchema>;\ntype SearchMatchPayload = NonNullable<SearchOutput['matches']>[number];\ntype SearchResultValue = Awaited<ReturnType<typeof searchContent>>;\n\ninterface SearchPreviewState {\n  needsExternalize: boolean;\n  visiblePayloads: SearchMatchPayload[];\n}\n\ninterface SearchContext {\n  pattern: string;\n  matcher?: Regex;\n  caseSensitive: boolean;\n}\n\ninterface SearchContentPageMetadata {\n  readonly totalMatches: number;\n  readonly filesScanned: number;\n  readonly filesMatched?: number;\n  readonly truncated: boolean;\n  readonly stoppedReason?: SearchOutput['stoppedReason'];\n  readonly skippedInaccessible?: number;\n  readonly skippedTooLarge?: number;\n}\n\nfunction buildSearchPreviewState(payloads: SearchMatchPayload[]): SearchPreviewState {\n  const needsExternalize = payloads.length > CONFIG.MAX_INLINE_MATCHES;\n  const visibleCount = needsExternalize ? CONFIG.MAX_INLINE_MATCHES : payloads.length;\n\n  return {\n    needsExternalize,\n    visiblePayloads: payloads.slice(0, visibleCount),\n  };\n}\n\nconst GrepInputSchema = z.strictObject({\n  path: OptionalPath.describe(\n    'File to search, or directory to search under (default: the whole first allowed root). Naming a file searches that file alone: pattern is ignored and hidden/ignored filtering does not apply.',\n  ),\n  pattern: SafeGlobPattern.optional().describe(\n    'Glob to restrict search to specific file types (e.g. **/*.ts); default: all text files',\n  ),\n  searchPattern: z\n    .string()\n    .min(1)\n    .max(10000)\n    .refine((val) => !isBlank(val), {\n      message: 'searchPattern cannot be empty or whitespace-only',\n    })\n    .describe(\n      'Exact literal text or RE2 regex pattern to search for in file contents. When isRegex=true, uses RE2 syntax (no lookahead, lookbehind, or backreferences). Cannot be empty or whitespace-only.',\n    )\n    .meta({ examples: ['TODO', 'function\\\\s+(\\\\w+)', 'import.*from'] }),\n  isRegex: defaultFalseBoolean('Treat searchPattern as a regex (default: literal text match)'),\n  includeHidden: includeHiddenField(),\n  includeIgnored: includeIgnoredField(),\n  caseSensitive: defaultFalseBoolean('Enable case-sensitive matching (default: case-insensitive)'),\n  maxResults: z\n    .uint32()\n    .min(1)\n    .max(MAX_SEARCH_RESULTS)\n    .optional()\n    .default(DEFAULT_SEARCH_CONTENT_RESULTS)\n    .describe('Maximum number of matching lines to return per page'),\n  maxDepth: maxDepthField(),\n  cursor: CursorSchema,\n});\n\nconst GrepOutputSchema = z.strictObject({\n  matches: z\n    .array(\n      z.strictObject({\n        file: z.string().describe('File path relative to the search root'),\n        line: PositiveInt.describe('1-indexed line number of the match'),\n        column: NonNegInt.optional().describe('0-indexed column offset of the match start'),\n        content: z.string().describe('Full text of the matching line'),\n        matchCount: NonNegInt.optional().describe('Number of pattern occurrences on this line'),\n      }),\n    )\n    .describe('Flat list of matches sorted by file path then line number'),\n  totalMatches: NonNegInt.optional().describe(\n    \"Total matching lines, one per entry in matches (not per occurrence); see that entry's matchCount for occurrences on a line.\",\n  ),\n  filesMatched: NonNegInt.optional().describe('Number of files containing at least one match'),\n  filesScanned: NonNegInt.optional().describe('Total number of files examined'),\n  skippedInaccessible: NonNegInt.optional().describe(\n    'Files skipped unread due to permission or access errors',\n  ),\n  skippedTooLarge: NonNegInt.optional().describe(\n    'Files skipped unread because they exceed the text-file size limit; raise the limit or narrow pattern if a match was expected in one',\n  ),\n  truncated: z\n    .boolean()\n    .optional()\n    .describe('True when the match list was cut due to maxResults or timeout'),\n  stoppedReason: SearchStoppedReasonSchema.describe(\n    'Why the search ended early: maxResults = result cap reached, timeout = time limit hit or the request was cancelled. Absent when the scan ran to completion.',\n  ),\n  resourceUri: z\n    .string()\n    .optional()\n    .describe(\n      'URI to the full match list in the resource store (present when matches exceed the inline limit)',\n    ),\n  nextCursor: NextCursorSchema,\n});\n\nfunction buildSearchMatchDetail(totalMatches: number, filesMatched: number): string {\n  const matchDetail = formatCount(totalMatches, 'match', 'matches');\n  if (filesMatched <= 0) return matchDetail;\n  return `${matchDetail} · ${formatCount(filesMatched, 'file', 'files')}`;\n}\n\nfunction searchContentOutput(\n  matches: SearchMatchPayload[],\n  metadata: SearchContentPageMetadata,\n): SearchOutput {\n  return {\n    matches,\n    totalMatches: metadata.totalMatches,\n    filesScanned: metadata.filesScanned,\n    ...(metadata.filesMatched ? { filesMatched: metadata.filesMatched } : {}),\n    ...(metadata.truncated ? { truncated: true } : {}),\n    ...(metadata.stoppedReason !== undefined ? { stoppedReason: metadata.stoppedReason } : {}),\n    ...(metadata.skippedInaccessible ? { skippedInaccessible: metadata.skippedInaccessible } : {}),\n    ...(metadata.skippedTooLarge ? { skippedTooLarge: metadata.skippedTooLarge } : {}),\n  };\n}\n\nfunction findColumnOffset(content: string, context: SearchContext): number | undefined {\n  if (context.matcher) {\n    context.matcher.lastIndex = 0;\n    const match = context.matcher.exec(content);\n    return match ? match.index : undefined;\n  }\n  if (context.caseSensitive) {\n    const idx = content.indexOf(context.pattern);\n    return idx >= 0 ? idx : undefined;\n  }\n  return undefined;\n}\n\nfunction buildSortedPayloads(\n  result: SearchResultValue,\n  context: SearchContext,\n): SearchMatchPayload[] {\n  const relativeByFile = new Map<string, string>();\n\n  const getRelativeFile = (file: string): string => {\n    const cached = relativeByFile.get(file);\n    if (cached !== undefined) return cached;\n\n    const rel = toPosixRelative(result.basePath, file);\n    relativeByFile.set(file, rel);\n    return rel;\n  };\n\n  const payloads = result.matches.map((match, originalIndex) => {\n    const relFile = getRelativeFile(match.file);\n    const column = findColumnOffset(match.content, context);\n\n    const payload: SearchMatchPayload = {\n      file: relFile,\n      line: match.line,\n      ...(column !== undefined ? { column } : {}),\n      content: match.content,\n      matchCount: match.matchCount,\n    };\n\n    return { payload, originalIndex };\n  });\n\n  payloads.sort((left, right) => {\n    const fileCompare = left.payload.file.localeCompare(right.payload.file);\n    if (fileCompare !== 0) return fileCompare;\n    if (left.payload.line !== right.payload.line) return left.payload.line - right.payload.line;\n    return left.originalIndex - right.originalIndex;\n  });\n\n  return payloads.map((p) => p.payload);\n}\n\nfunction buildSearchContentOptions(args: SearchInput, signal?: AbortSignal): SearchContentOptions {\n  return {\n    includeHidden: args.includeHidden,\n    excludePatterns: args.includeIgnored ? [] : DEFAULT_EXCLUDE_PATTERNS,\n    filePattern: args.pattern ?? '**/*',\n    caseSensitive: args.caseSensitive,\n    isRegex: args.isRegex,\n    maxResults: args.maxResults,\n    respectGitignore: !args.includeIgnored,\n    ...(args.maxDepth !== undefined ? { maxDepth: args.maxDepth } : {}),\n    ...(signal ? { signal } : {}),\n  };\n}\n\nfunction createSearchMatcher(args: SearchInput): Regex | undefined {\n  if (args.isRegex) {\n    return compileRegex(args.searchPattern, { caseSensitive: args.caseSensitive });\n  }\n  if (!args.caseSensitive) {\n    return compileRegex(escapeRegexLiteral(args.searchPattern), { caseSensitive: false });\n  }\n  return undefined;\n}\n\nfunction createSearchContext(args: SearchInput, matcher: Regex | undefined): SearchContext {\n  return {\n    pattern: args.searchPattern,\n    caseSensitive: args.caseSensitive,\n    ...(matcher ? { matcher } : {}),\n  };\n}\n\nfunction buildExternalizedResponse(\n  fullStructured: SearchOutput,\n  preview: SearchPreviewState,\n  resourceStore: ResourceStore,\n  searchPattern: string,\n): { structured: SearchOutput; link: ReturnType<typeof putJsonResource>['link'] } {\n  const { entry, link } = putJsonResource(\n    resourceStore,\n    `'${searchPattern}' matches`,\n    fullStructured,\n  );\n\n  const structuredForResponse: SearchOutput = {\n    ...fullStructured,\n    resourceUri: entry.uri,\n  };\n\n  if (preview.needsExternalize) {\n    structuredForResponse.matches = preview.visiblePayloads;\n    structuredForResponse.truncated = true;\n  }\n\n  return { structured: structuredForResponse, link };\n}\n\nfunction sortedPayloads(\n  result: SearchResultValue,\n  args: SearchInput,\n  regexMatcher: Regex | undefined,\n): SearchMatchPayload[] {\n  const searchContext = createSearchContext(args, regexMatcher);\n  return buildSortedPayloads(result, searchContext);\n}\n\nfunction finalizeSearchOutput(\n  fullStructured: SearchOutput,\n  preview: SearchPreviewState,\n  resourceStore?: ResourceStore,\n  searchPattern?: string,\n): { structured: SearchOutput; link?: ReturnType<typeof putJsonResource>['link'] } {\n  if (resourceStore && preview.needsExternalize) {\n    return buildExternalizedResponse(fullStructured, preview, resourceStore, searchPattern ?? '');\n  }\n\n  if (preview.needsExternalize) {\n    fullStructured.matches = preview.visiblePayloads;\n    fullStructured.truncated = true;\n  }\n\n  return { structured: fullStructured };\n}\n\n/**\n * `path` is documented as \"file to search, or directory to search under\", but\n * the scan itself only walks directories. A file path is therefore rewritten\n * into the scan it means: its parent as the base, its own name as the glob.\n * Naming a file is an explicit request for that file, so hidden/ignored\n * filtering is lifted for it — otherwise `search_text` on a path the caller can\n * see returned nothing.\n */\nasync function resolveSearchScope(\n  args: SearchInput,\n  ctx: ToolCtx,\n): Promise<{ basePath: string; args: SearchInput }> {\n  const requested = ctx.fs.pathGuard.resolvePathOrRoot(args.path);\n  // One resolution, one stat: validateExistingDirectory would redo both.\n  const resolved = await ctx.fs.pathGuard.validateExistingPath(requested);\n  const stats = await stat(resolved);\n  if (!stats.isFile()) {\n    if (!stats.isDirectory()) {\n      throw new FsError(ErrorCode.NOT_DIRECTORY, 'Not a directory', requested);\n    }\n    return { basePath: resolved, args };\n  }\n  return {\n    basePath: dirname(resolved),\n    // ponytail: the name goes through as a glob, so a file whose name contains\n    // glob metacharacters (`[id].ts`) matches as a pattern rather than\n    // literally. Escape it here if that ever bites.\n    args: { ...args, pattern: basename(resolved), includeHidden: true, includeIgnored: true },\n  };\n}\n\nfunction searchContentQueryKey(args: SearchInput, requestedPath: string): string {\n  return JSON.stringify({\n    method: 'search_text',\n    path: requestedPath,\n    pattern: args.pattern,\n    searchPattern: args.searchPattern,\n    isRegex: args.isRegex,\n    includeHidden: args.includeHidden,\n    includeIgnored: args.includeIgnored,\n    caseSensitive: args.caseSensitive,\n    maxDepth: args.maxDepth,\n  });\n}\n\nasync function handleSearchContent(\n  args: SearchInput,\n  ctx: ToolCtx,\n): Promise<{\n  structured: SearchOutput;\n  link?: ReturnType<typeof putJsonResource>['link'];\n}> {\n  const requestedPath = ctx.fs.pathGuard.resolvePathOrRoot(args.path);\n  const queryKey = searchContentQueryKey(args, requestedPath);\n\n  if (args.cursor !== undefined) {\n    const paged = readNextPage<SearchMatchPayload, SearchContentPageMetadata>({\n      store: ctx.pageStore,\n      queryKey,\n      cursor: args.cursor,\n      pageSize: args.maxResults,\n    });\n    const fullStructured = searchContentOutput([...paged.page], paged.metadata);\n    if (paged.nextCursor !== undefined) fullStructured.nextCursor = paged.nextCursor;\n    const preview = buildSearchPreviewState([...paged.page]);\n    return finalizeSearchOutput(fullStructured, preview, ctx.resourceStore, args.searchPattern);\n  }\n\n  const { basePath, args: scoped } = await resolveSearchScope(args, ctx);\n  const regexMatcher = createSearchMatcher(scoped);\n\n  const result = await searchContent(\n    basePath,\n    scoped.searchPattern,\n    buildSearchContentOptions({ ...scoped, maxResults: MAX_SEARCH_RESULTS }, ctx.signal),\n    ctx.fs.pathGuard,\n  );\n\n  // regexMatcher holds wasm memory re2-wasm never reclaims on its own.\n  let allMatchPayloads: SearchMatchPayload[];\n  try {\n    allMatchPayloads = sortedPayloads(result, scoped, regexMatcher);\n  } finally {\n    freeRegex(regexMatcher);\n  }\n  const metadata: SearchContentPageMetadata = {\n    totalMatches: result.summary.matchingLines,\n    filesScanned: result.summary.filesScanned,\n    ...(result.summary.filesMatched ? { filesMatched: result.summary.filesMatched } : {}),\n    truncated: result.summary.truncated,\n    ...(result.summary.stoppedReason !== undefined && result.summary.stoppedReason !== 'maxFiles'\n      ? { stoppedReason: result.summary.stoppedReason }\n      : {}),\n    ...(result.summary.skippedInaccessible\n      ? { skippedInaccessible: result.summary.skippedInaccessible }\n      : {}),\n    ...(result.summary.skippedTooLarge ? { skippedTooLarge: result.summary.skippedTooLarge } : {}),\n  };\n  const paged = createFirstPage<SearchMatchPayload, SearchContentPageMetadata>({\n    store: ctx.pageStore,\n    queryKey,\n    items: allMatchPayloads,\n    metadata,\n    pageSize: scoped.maxResults,\n  });\n  const fullStructured = searchContentOutput([...paged.page], metadata);\n  if (paged.nextCursor !== undefined) fullStructured.nextCursor = paged.nextCursor;\n  const preview = buildSearchPreviewState([...paged.page]);\n  const { structured, link } = finalizeSearchOutput(\n    fullStructured,\n    preview,\n    ctx.resourceStore,\n    args.searchPattern,\n  );\n\n  return {\n    structured,\n    ...(link !== undefined ? { link } : {}),\n  };\n}\n\nexport const SEARCH_CONTENT = defineTool({\n  name: 'search_text',\n  title: 'Search Content',\n  description:\n    'Search file contents by text or regex (grep-style). Returns matching lines with file path, ' +\n    '1-indexed line number and 0-indexed column offset. ' +\n    'Scope to specific file types with pattern (e.g. **/*.ts). ' +\n    'Set includeHidden=true to include dotfiles. Use find_files to search by filename instead.',\n  input: GrepInputSchema,\n  output: GrepOutputSchema,\n  annotations: {\n    readOnlyHint: true,\n    idempotentHint: true,\n    destructiveHint: false,\n    openWorldHint: false,\n  },\n  timeoutMs: DEFAULT_SEARCH_TIMEOUT_MS,\n  defaultErrorCode: ErrorCode.UNKNOWN,\n  progress: (args) => ({\n    label: 'Search',\n    subject: truncateProgressPattern(args.searchPattern),\n  }),\n  progressDone: (_args, result) => ({\n    detail: buildSearchMatchDetail(result.totalMatches ?? 0, result.filesMatched ?? 0),\n  }),\n  accessPaths: (args) => (args.path ? [args.path] : []),\n  run: async (args, ctx) => {\n    const { structured, link } = await handleSearchContent(args, ctx);\n    const text =\n      structured.matches.length > 0\n        ? structured.matches.map((m) => `${m.file}:${String(m.line)}: ${m.content}`).join('\\n')\n        : `No matches for '${args.searchPattern}'`;\n    if (link) {\n      return { structured, text, resources: [link] };\n    }\n    return { structured, text };\n  },\n});\n"]}
+{"version":3,"file":"search-content.js","sourceRoot":"","sources":["../../src/tools/search-content.ts"],"names":[],"mappings":"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","sourcesContent":["import { stat } from 'node:fs/promises';\nimport { basename, dirname } from 'node:path';\n\nimport * as z from 'zod/v4';\n\nimport { SearchStoppedReasonSchema } from '../core/concurrency.js';\nimport { paginate } from '../core/cursor.js';\nimport { ErrorCode, FsError } from '../core/errors.js';\nimport { formatCount, truncateProgressPattern } from '../core/fmt.js';\nimport { DEFAULT_EXCLUDE_PATTERNS } from '../core/glob.js';\nimport { Logger } from '../core/observability.js';\nimport { toPosixRelative } from '../core/path.js';\nimport { escapeRegexLiteral } from '../core/primitives.js';\nimport {\n  CursorSchema,\n  defaultFalseBoolean,\n  includeHiddenField,\n  includeIgnoredField,\n  isBlank,\n  maxDepthField,\n  NextCursorSchema,\n  NonNegInt,\n  OptionalPath,\n  PositiveInt,\n  SafeGlobPattern,\n} from '../core/schema.js';\nimport type { Regex, SearchContentOptions } from '../core/search.js';\nimport { compileRegex, freeRegex, searchContent } from '../core/search.js';\nimport type { JsonResourceResult } from '../core/store.js';\nimport { putJsonResource } from '../core/store.js';\nimport {\n  DEFAULT_SEARCH_CONTENT_RESULTS,\n  DEFAULT_SEARCH_TIMEOUT_MS,\n  MAX_SEARCH_RESULTS,\n} from '../core/util.js';\nimport { defineTool, type ToolCtx } from './define.js';\n\n/**\n * `FS_MAX_INLINE_MATCHES` used to cap how many matches a page showed inline\n * and, past it, push the rest into the resource store. `maxResults` is the one\n * page size now, and the full list is externalized whenever a response is\n * incomplete, so the variable does nothing. It is still read so an operator who\n * set it hears why it stopped mattering; the read goes at the next major.\n */\nif (process.env['FS_MAX_INLINE_MATCHES'] !== undefined) {\n  Logger.warn(\n    'FS_MAX_INLINE_MATCHES is deprecated and ignored: maxResults sets the search_text page size. It will be removed in the next major release.',\n  );\n}\n\n// Type Definitions\ntype SearchInput = z.infer<typeof GrepInputSchema>;\ntype SearchOutput = z.infer<typeof GrepOutputSchema>;\ntype SearchMatchPayload = NonNullable<SearchOutput['matches']>[number];\ntype SearchResultValue = Awaited<ReturnType<typeof searchContent>>;\n\ninterface SearchContext {\n  pattern: string;\n  matcher?: Regex;\n  caseSensitive: boolean;\n}\n\ninterface SearchContentPageMetadata {\n  readonly totalMatches: number;\n  readonly filesScanned: number;\n  readonly filesMatched?: number;\n  readonly truncated: boolean;\n  readonly stoppedReason?: SearchOutput['stoppedReason'];\n  readonly skippedInaccessible?: number;\n  readonly skippedTooLarge?: number;\n}\n\nconst GrepInputSchema = z.strictObject({\n  path: OptionalPath.describe(\n    'File to search, or directory to search under (default: the whole first allowed root). Naming a file searches that file alone: pattern is ignored and hidden/ignored filtering does not apply.',\n  ),\n  pattern: SafeGlobPattern.optional().describe(\n    'Glob to restrict search to specific file types (e.g. **/*.ts); default: all text files',\n  ),\n  searchPattern: z\n    .string()\n    .min(1)\n    .max(10000)\n    .refine((val) => !isBlank(val), {\n      message: 'searchPattern cannot be empty or whitespace-only',\n    })\n    .describe(\n      'Exact literal text or RE2 regex pattern to search for in file contents. When isRegex=true, uses RE2 syntax (no lookahead, lookbehind, or backreferences). Cannot be empty or whitespace-only.',\n    )\n    .meta({ examples: ['TODO', 'function\\\\s+(\\\\w+)', 'import.*from'] }),\n  isRegex: defaultFalseBoolean('Treat searchPattern as a regex (default: literal text match)'),\n  includeHidden: includeHiddenField(),\n  includeIgnored: includeIgnoredField(),\n  caseSensitive: defaultFalseBoolean('Enable case-sensitive matching (default: case-insensitive)'),\n  maxResults: z\n    .uint32()\n    .min(1)\n    .max(MAX_SEARCH_RESULTS)\n    .optional()\n    .default(DEFAULT_SEARCH_CONTENT_RESULTS)\n    .describe('Maximum number of matching lines to return per page'),\n  maxDepth: maxDepthField(),\n  cursor: CursorSchema,\n});\n\nconst GrepOutputSchema = z.strictObject({\n  matches: z\n    .array(\n      z.strictObject({\n        file: z.string().describe('File path relative to the search root'),\n        line: PositiveInt.describe('1-indexed line number of the match'),\n        column: NonNegInt.optional().describe('0-indexed column offset of the match start'),\n        content: z.string().describe('Full text of the matching line'),\n        matchCount: NonNegInt.optional().describe('Number of pattern occurrences on this line'),\n      }),\n    )\n    .describe('Flat list of matches sorted by file path then line number'),\n  totalMatches: NonNegInt.optional().describe(\n    \"Total matching lines, one per entry in matches (not per occurrence); see that entry's matchCount for occurrences on a line.\",\n  ),\n  filesMatched: NonNegInt.optional().describe('Number of files containing at least one match'),\n  filesScanned: NonNegInt.optional().describe('Total number of files examined'),\n  skippedInaccessible: NonNegInt.optional().describe(\n    'Files skipped unread due to permission or access errors',\n  ),\n  skippedTooLarge: NonNegInt.optional().describe(\n    'Files skipped unread because they exceed the text-file size limit; raise the limit or narrow pattern if a match was expected in one',\n  ),\n  truncated: z\n    .boolean()\n    .optional()\n    .describe(\n      'True when the search engine cut the match list — the hard result cap or the time limit. Paging is not truncation: a set that spans pages has nextCursor instead.',\n    ),\n  stoppedReason: SearchStoppedReasonSchema.describe(\n    'Why the search ended early: maxResults = result cap reached, timeout = time limit hit or the request was cancelled. Absent when the scan ran to completion.',\n  ),\n  resourceUri: z\n    .string()\n    .optional()\n    .describe(\n      'URI to the full match list in the resource store; first page only, whenever the response is incomplete — more pages follow, or the engine cut the search',\n    ),\n  nextCursor: NextCursorSchema,\n});\n\nfunction buildSearchMatchDetail(totalMatches: number, filesMatched: number): string {\n  const matchDetail = formatCount(totalMatches, 'match', 'matches');\n  if (filesMatched <= 0) return matchDetail;\n  return `${matchDetail} · ${formatCount(filesMatched, 'file', 'files')}`;\n}\n\nfunction searchContentOutput(\n  matches: readonly SearchMatchPayload[],\n  metadata: SearchContentPageMetadata,\n  nextCursor: string | undefined,\n  resourceUri: string | undefined,\n): SearchOutput {\n  return {\n    matches: [...matches],\n    totalMatches: metadata.totalMatches,\n    filesScanned: metadata.filesScanned,\n    ...(metadata.filesMatched ? { filesMatched: metadata.filesMatched } : {}),\n    ...(metadata.truncated ? { truncated: true } : {}),\n    ...(metadata.stoppedReason !== undefined ? { stoppedReason: metadata.stoppedReason } : {}),\n    ...(metadata.skippedInaccessible ? { skippedInaccessible: metadata.skippedInaccessible } : {}),\n    ...(metadata.skippedTooLarge ? { skippedTooLarge: metadata.skippedTooLarge } : {}),\n    ...(resourceUri !== undefined ? { resourceUri } : {}),\n    ...(nextCursor !== undefined ? { nextCursor } : {}),\n  };\n}\n\nfunction findColumnOffset(content: string, context: SearchContext): number | undefined {\n  if (context.matcher) {\n    context.matcher.lastIndex = 0;\n    const match = context.matcher.exec(content);\n    return match ? match.index : undefined;\n  }\n  if (context.caseSensitive) {\n    const idx = content.indexOf(context.pattern);\n    return idx >= 0 ? idx : undefined;\n  }\n  return undefined;\n}\n\nfunction buildSortedPayloads(\n  result: SearchResultValue,\n  context: SearchContext,\n): SearchMatchPayload[] {\n  const relativeByFile = new Map<string, string>();\n\n  const getRelativeFile = (file: string): string => {\n    const cached = relativeByFile.get(file);\n    if (cached !== undefined) return cached;\n\n    const rel = toPosixRelative(result.basePath, file);\n    relativeByFile.set(file, rel);\n    return rel;\n  };\n\n  const payloads = result.matches.map((match, originalIndex) => {\n    const relFile = getRelativeFile(match.file);\n    const column = findColumnOffset(match.content, context);\n\n    const payload: SearchMatchPayload = {\n      file: relFile,\n      line: match.line,\n      ...(column !== undefined ? { column } : {}),\n      content: match.content,\n      matchCount: match.matchCount,\n    };\n\n    return { payload, originalIndex };\n  });\n\n  payloads.sort((left, right) => {\n    const fileCompare = left.payload.file.localeCompare(right.payload.file);\n    if (fileCompare !== 0) return fileCompare;\n    if (left.payload.line !== right.payload.line) return left.payload.line - right.payload.line;\n    return left.originalIndex - right.originalIndex;\n  });\n\n  return payloads.map((p) => p.payload);\n}\n\nfunction buildSearchContentOptions(args: SearchInput, signal?: AbortSignal): SearchContentOptions {\n  return {\n    includeHidden: args.includeHidden,\n    excludePatterns: args.includeIgnored ? [] : DEFAULT_EXCLUDE_PATTERNS,\n    filePattern: args.pattern ?? '**/*',\n    caseSensitive: args.caseSensitive,\n    isRegex: args.isRegex,\n    maxResults: args.maxResults,\n    respectGitignore: !args.includeIgnored,\n    ...(args.maxDepth !== undefined ? { maxDepth: args.maxDepth } : {}),\n    ...(signal ? { signal } : {}),\n  };\n}\n\nfunction createSearchMatcher(args: SearchInput): Regex | undefined {\n  if (args.isRegex) {\n    return compileRegex(args.searchPattern, { caseSensitive: args.caseSensitive });\n  }\n  if (!args.caseSensitive) {\n    return compileRegex(escapeRegexLiteral(args.searchPattern), { caseSensitive: false });\n  }\n  return undefined;\n}\n\nfunction createSearchContext(args: SearchInput, matcher: Regex | undefined): SearchContext {\n  return {\n    pattern: args.searchPattern,\n    caseSensitive: args.caseSensitive,\n    ...(matcher ? { matcher } : {}),\n  };\n}\n\nfunction sortedPayloads(\n  result: SearchResultValue,\n  args: SearchInput,\n  regexMatcher: Regex | undefined,\n): SearchMatchPayload[] {\n  const searchContext = createSearchContext(args, regexMatcher);\n  return buildSortedPayloads(result, searchContext);\n}\n\n/**\n * `path` is documented as \"file to search, or directory to search under\", but\n * the scan itself only walks directories. A file path is therefore rewritten\n * into the scan it means: its parent as the base, its own name as the glob.\n * Naming a file is an explicit request for that file, so hidden/ignored\n * filtering is lifted for it — otherwise `search_text` on a path the caller can\n * see returned nothing.\n */\nasync function resolveSearchScope(\n  args: SearchInput,\n  ctx: ToolCtx,\n): Promise<{ basePath: string; args: SearchInput }> {\n  const requested = ctx.fs.pathGuard.resolvePathOrRoot(args.path);\n  // One resolution, one stat: validateExistingDirectory would redo both.\n  const resolved = await ctx.fs.pathGuard.validateExistingPath(requested);\n  const stats = await stat(resolved);\n  if (!stats.isFile()) {\n    if (!stats.isDirectory()) {\n      throw new FsError(ErrorCode.NOT_DIRECTORY, 'Not a directory', requested);\n    }\n    return { basePath: resolved, args };\n  }\n  return {\n    basePath: dirname(resolved),\n    // ponytail: the name goes through as a glob, so a file whose name contains\n    // glob metacharacters (`[id].ts`) matches as a pattern rather than\n    // literally. Escape it here if that ever bites.\n    args: { ...args, pattern: basename(resolved), includeHidden: true, includeIgnored: true },\n  };\n}\n\nfunction searchContentQueryKey(args: SearchInput, requestedPath: string): string {\n  return JSON.stringify({\n    method: 'search_text',\n    path: requestedPath,\n    pattern: args.pattern,\n    searchPattern: args.searchPattern,\n    isRegex: args.isRegex,\n    includeHidden: args.includeHidden,\n    includeIgnored: args.includeIgnored,\n    caseSensitive: args.caseSensitive,\n    maxDepth: args.maxDepth,\n  });\n}\n\nasync function handleSearchContent(\n  args: SearchInput,\n  ctx: ToolCtx,\n): Promise<{\n  structured: SearchOutput;\n  link?: ReturnType<typeof putJsonResource>['link'];\n}> {\n  const requestedPath = ctx.fs.pathGuard.resolvePathOrRoot(args.path);\n  const queryKey = searchContentQueryKey(args, requestedPath);\n  const { resourceStore } = ctx;\n\n  const paged = await paginate<SearchMatchPayload, SearchContentPageMetadata, JsonResourceResult>({\n    store: ctx.pageStore,\n    queryKey,\n    cursor: args.cursor,\n    pageSize: args.maxResults,\n    produce: async () => {\n      const { basePath, args: scoped } = await resolveSearchScope(args, ctx);\n      const regexMatcher = createSearchMatcher(scoped);\n\n      const result = await searchContent(\n        basePath,\n        scoped.searchPattern,\n        buildSearchContentOptions({ ...scoped, maxResults: MAX_SEARCH_RESULTS }, ctx.signal),\n        ctx.fs.pathGuard,\n      );\n\n      // regexMatcher holds wasm memory re2-wasm never reclaims on its own.\n      let items: SearchMatchPayload[];\n      try {\n        items = sortedPayloads(result, scoped, regexMatcher);\n      } finally {\n        freeRegex(regexMatcher);\n      }\n      return {\n        items,\n        metadata: {\n          totalMatches: result.summary.matchingLines,\n          filesScanned: result.summary.filesScanned,\n          ...(result.summary.filesMatched ? { filesMatched: result.summary.filesMatched } : {}),\n          truncated: result.summary.truncated,\n          ...(result.summary.stoppedReason !== undefined &&\n          result.summary.stoppedReason !== 'maxFiles'\n            ? { stoppedReason: result.summary.stoppedReason }\n            : {}),\n          ...(result.summary.skippedInaccessible\n            ? { skippedInaccessible: result.summary.skippedInaccessible }\n            : {}),\n          ...(result.summary.skippedTooLarge\n            ? { skippedTooLarge: result.summary.skippedTooLarge }\n            : {}),\n        },\n        truncated: result.summary.truncated,\n      };\n    },\n    externalize: resourceStore\n      ? (matches, metadata) =>\n          putJsonResource(\n            resourceStore,\n            `'${args.searchPattern}' matches`,\n            searchContentOutput(matches, metadata, undefined, undefined),\n          )\n      : undefined,\n  });\n\n  return {\n    structured: searchContentOutput(\n      paged.page,\n      paged.metadata,\n      paged.nextCursor,\n      paged.resource?.entry.uri,\n    ),\n    ...(paged.resource ? { link: paged.resource.link } : {}),\n  };\n}\n\nexport const SEARCH_CONTENT = defineTool({\n  name: 'search_text',\n  title: 'Search Content',\n  description:\n    'Search file contents by text or regex (grep-style). Returns matching lines with file path, ' +\n    '1-indexed line number and 0-indexed column offset. ' +\n    'Scope to specific file types with pattern (e.g. **/*.ts). ' +\n    'Set includeHidden=true to include dotfiles. Use find_files to search by filename instead.',\n  input: GrepInputSchema,\n  output: GrepOutputSchema,\n  annotations: {\n    readOnlyHint: true,\n    idempotentHint: true,\n    destructiveHint: false,\n    openWorldHint: false,\n  },\n  timeoutMs: DEFAULT_SEARCH_TIMEOUT_MS,\n  defaultErrorCode: ErrorCode.UNKNOWN,\n  progress: (args) => ({\n    label: 'Search',\n    subject: truncateProgressPattern(args.searchPattern),\n  }),\n  progressDone: (_args, result) => ({\n    detail: buildSearchMatchDetail(result.totalMatches ?? 0, result.filesMatched ?? 0),\n  }),\n  accessPaths: (args) => (args.path ? [args.path] : []),\n  run: async (args, ctx) => {\n    const { structured, link } = await handleSearchContent(args, ctx);\n    const text =\n      structured.matches.length > 0\n        ? structured.matches.map((m) => `${m.file}:${String(m.line)}: ${m.content}`).join('\\n')\n        : `No matches for '${args.searchPattern}'`;\n    if (link) {\n      return { structured, text, resources: [link] };\n    }\n    return { structured, text };\n  },\n});\n"]}

package/dist/tools/search-files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-files.d.ts","sourceRoot":"","sources":["../../src/tools/search-files.ts"],"names":[],"mappings":"AAuNA,eAAO,MAAM,YAAY,mCAoCvB,CAAC"}
+{"version":3,"file":"search-files.d.ts","sourceRoot":"","sources":["../../src/tools/search-files.ts"],"names":[],"mappings":"AAwMA,eAAO,MAAM,YAAY,mCAoCvB,CAAC"}

package/dist/tools/search-files.js

@@ -1,6 +1,6 @@
 import * as z from 'zod/v4';
 import { SearchStoppedReasonSchema } from '../core/concurrency.js';
-import { createFirstPage, readNextPage } from '../core/cursor.js';
+import { paginate } from '../core/cursor.js';
 import { ErrorCode } from '../core/errors.js';
 import { formatCount, truncateProgressPattern } from '../core/fmt.js';
 import { DEFAULT_EXCLUDE_PATTERNS } from '../core/glob.js';
@@ -45,7 +45,7 @@ const SearchFilesOutputSchema = z.strictObject({
     resourceUri: z
         .string()
         .optional()
-        .describe('URI to the full results JSON in the resource store; first page only, when results are paginated'),
+        .describe('URI to the full results JSON in the resource store; first page only, whenever the response is incomplete — more pages follow, or the result cap cut the search'),
     nextCursor: NextCursorSchema,
 });
 function buildRelativeResults(basePath, displayResults) {
@@ -68,7 +68,7 @@ function searchFilesQueryKey(args, basePath) {
         maxDepth: args.maxDepth,
     });
 }
-function searchFilesOutput(results, metadata, nextCursor) {
+function searchFilesOutput(results, metadata, nextCursor, resourceUri) {
     return {
         root: metadata.root,
         results: [...results],
@@ -76,73 +76,55 @@ function searchFilesOutput(results, metadata, nextCursor) {
         filesScanned: metadata.filesScanned,
         ...(metadata.skippedInaccessible ? { skippedInaccessible: metadata.skippedInaccessible } : {}),
         ...(metadata.stoppedReason !== undefined ? { stoppedReason: metadata.stoppedReason } : {}),
-        ...(metadata.resourceUri ? { resourceUri: metadata.resourceUri } : {}),
+        ...(resourceUri !== undefined ? { resourceUri } : {}),
         ...(nextCursor !== undefined ? { nextCursor } : {}),
     };
 }
 async function handleSearchFiles(args, ctx) {
     const requestedBasePath = ctx.fs.pathGuard.resolvePathOrRoot(args.path);
     const queryKey = searchFilesQueryKey(args, requestedBasePath);
-    if (args.cursor !== undefined) {
-        const paged = readNextPage({
-            store: ctx.pageStore,
-            queryKey,
-            cursor: args.cursor,
-            pageSize: args.maxResults,
-        });
-        // First page only — see the same note in list.ts: the overflow entry expires
-        // on ResourceStore's clock, not this snapshot's.
-        const { resourceUri: _firstPageOnly, ...pageMetadata } = paged.metadata;
-        return {
-            structured: searchFilesOutput(paged.page, pageMetadata, paged.nextCursor),
-        };
-    }
-    const basePath = await ctx.fs.pathGuard.validateExistingDirectory(requestedBasePath);
-    const excludePatterns = args.includeIgnored ? [] : DEFAULT_EXCLUDE_PATTERNS;
-    const searchOptions = {
-        maxResults: MAX_SEARCH_RESULTS,
-        includeHidden: args.includeHidden,
-        sortBy: args.sortBy,
-        respectGitignore: !args.includeIgnored,
-        ...(args.maxDepth !== undefined ? { maxDepth: args.maxDepth } : {}),
-        signal: ctx.signal,
-    };
-    const result = await searchFiles(basePath, args.pattern, excludePatterns, searchOptions, ctx.fs.pathGuard);
-    const relativeResults = buildRelativeResults(result.basePath, result.results);
-    // Store the full result set so a caller can fetch all matching files by URI
-    // when the response is incomplete: `nextCursor` covers the multi-page case,
-    // and `summary.truncated` covers a single page that already hit the hard result
-    // cap (no nextCursor, but more matches exist beyond the cap).
-    let resourceUri;
-    let link;
-    if (ctx.resourceStore !== undefined &&
-        (relativeResults.length > args.maxResults || result.summary.truncated)) {
-        const stored = putJsonResource(ctx.resourceStore, `${args.pattern} files`, relativeResults);
-        resourceUri = stored.entry.uri;
-        link = stored.link;
-    }
-    const metadata = {
-        root: result.basePath,
-        totalMatches: result.summary.matched,
-        filesScanned: result.summary.filesScanned,
-        ...(result.summary.skippedInaccessible
-            ? { skippedInaccessible: result.summary.skippedInaccessible }
-            : {}),
-        ...(result.summary.stoppedReason !== undefined && result.summary.stoppedReason !== 'maxFiles'
-            ? { stoppedReason: result.summary.stoppedReason }
-            : {}),
-        ...(resourceUri ? { resourceUri } : {}),
-    };
-    const paged = createFirstPage({
+    const { resourceStore } = ctx;
+    const paged = await paginate({
         store: ctx.pageStore,
         queryKey,
-        items: relativeResults,
-        metadata,
+        cursor: args.cursor,
         pageSize: args.maxResults,
+        produce: async () => {
+            const basePath = await ctx.fs.pathGuard.validateExistingDirectory(requestedBasePath);
+            const excludePatterns = args.includeIgnored ? [] : DEFAULT_EXCLUDE_PATTERNS;
+            const searchOptions = {
+                maxResults: MAX_SEARCH_RESULTS,
+                includeHidden: args.includeHidden,
+                sortBy: args.sortBy,
+                respectGitignore: !args.includeIgnored,
+                ...(args.maxDepth !== undefined ? { maxDepth: args.maxDepth } : {}),
+                signal: ctx.signal,
+            };
+            const result = await searchFiles(basePath, args.pattern, excludePatterns, searchOptions, ctx.fs.pathGuard);
+            return {
+                items: buildRelativeResults(result.basePath, result.results),
+                metadata: {
+                    root: result.basePath,
+                    totalMatches: result.summary.matched,
+                    filesScanned: result.summary.filesScanned,
+                    ...(result.summary.skippedInaccessible
+                        ? { skippedInaccessible: result.summary.skippedInaccessible }
+                        : {}),
+                    ...(result.summary.stoppedReason !== undefined &&
+                        result.summary.stoppedReason !== 'maxFiles'
+                        ? { stoppedReason: result.summary.stoppedReason }
+                        : {}),
+                },
+                truncated: result.summary.truncated,
+            };
+        },
+        externalize: resourceStore
+            ? (results) => putJsonResource(resourceStore, `${args.pattern} files`, results)
+            : undefined,
     });
     return {
-        structured: searchFilesOutput(paged.page, metadata, paged.nextCursor),
-        ...(link !== undefined ? { link } : {}),
+        structured: searchFilesOutput(paged.page, paged.metadata, paged.nextCursor, paged.resource?.entry.uri),
+        ...(paged.resource ? { link: paged.resource.link } : {}),
     };
 }
 export const SEARCH_FILES = defineTool({

package/dist/tools/search-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"search-files.js","sourceRoot":"","sources":["../../src/tools/search-files.ts"],"names":[],"mappings":"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","sourcesContent":["import * as z from 'zod/v4';\n\nimport { SearchStoppedReasonSchema } from '../core/concurrency.js';\nimport { createFirstPage, readNextPage } from '../core/cursor.js';\nimport { ErrorCode } from '../core/errors.js';\nimport { formatCount, truncateProgressPattern } from '../core/fmt.js';\nimport { DEFAULT_EXCLUDE_PATTERNS } from '../core/glob.js';\nimport { toPosixRelative } from '../core/path.js';\nimport {\n  CursorSchema,\n  includeHiddenField,\n  includeIgnoredField,\n  maxDepthField,\n  NextCursorSchema,\n  NonNegInt,\n  OptionalPath,\n  SafeGlobPattern,\n} from '../core/schema.js';\nimport { searchFiles } from '../core/search.js';\nimport { putJsonResource } from '../core/store.js';\nimport {\n  DEFAULT_SEARCH_RESULTS,\n  DEFAULT_SEARCH_TIMEOUT_MS,\n  MAX_SEARCH_RESULTS,\n} from '../core/util.js';\nimport { defineTool, type ToolCtx } from './define.js';\n\n// ---------------------------------------------------------------------------\n\nconst SearchFilesInputSchema = z.strictObject({\n  path: OptionalPath.describe('Base directory to search under (default: first allowed root)'),\n  pattern: SafeGlobPattern.describe('Glob pattern to match file paths (e.g. **/*.ts, src/**/*.js)'),\n  maxResults: z\n    .uint32()\n    .min(1)\n    .max(MAX_SEARCH_RESULTS)\n    .optional()\n    .default(DEFAULT_SEARCH_RESULTS)\n    .describe('Maximum number of matching files to return per page'),\n  includeIgnored: includeIgnoredField(),\n  includeHidden: includeHiddenField(),\n  sortBy: z\n    .enum(['name', 'path'])\n    .optional()\n    .default('path')\n    .describe('Sort order: path = full path (default), name = basename only'),\n  maxDepth: maxDepthField(),\n  cursor: CursorSchema,\n});\n\nconst SearchFilesOutputSchema = z.strictObject({\n  root: z.string().describe('Resolved base directory used as the search root'),\n  results: z\n    .array(\n      z.strictObject({\n        path: z.string().describe('File path relative to the search root'),\n      }),\n    )\n    .describe('Matched files ordered by sortBy'),\n  totalMatches: NonNegInt.optional().describe('Total number of matching files found'),\n  filesScanned: NonNegInt.optional().describe('Total number of files examined during the search'),\n  skippedInaccessible: NonNegInt.optional().describe(\n    'Files skipped due to permission or access errors',\n  ),\n  stoppedReason: SearchStoppedReasonSchema.describe(\n    'Why the search ended early: maxResults = result cap reached, timeout = time limit hit or the request was cancelled. Absent when the scan ran to completion.',\n  ),\n  resourceUri: z\n    .string()\n    .optional()\n    .describe(\n      'URI to the full results JSON in the resource store; first page only, when results are paginated',\n    ),\n  nextCursor: NextCursorSchema,\n});\n\nfunction buildRelativeResults(\n  basePath: string,\n  displayResults: readonly { path: string }[],\n): NonNullable<z.infer<typeof SearchFilesOutputSchema>['results']> {\n  const relativeResults: NonNullable<z.infer<typeof SearchFilesOutputSchema>['results']> = [];\n  for (const entry of displayResults) {\n    relativeResults.push({\n      path: toPosixRelative(basePath, entry.path),\n    });\n  }\n  return relativeResults;\n}\n\ntype SearchFileResult = NonNullable<z.infer<typeof SearchFilesOutputSchema>['results']>[number];\n\ninterface SearchFilesPageMetadata {\n  readonly root: string;\n  readonly totalMatches: number;\n  readonly filesScanned: number;\n  readonly skippedInaccessible?: number;\n  readonly stoppedReason?: z.infer<typeof SearchFilesOutputSchema>['stoppedReason'];\n  readonly resourceUri?: string;\n}\n\nfunction searchFilesQueryKey(\n  args: z.infer<typeof SearchFilesInputSchema>,\n  basePath: string,\n): string {\n  return JSON.stringify({\n    method: 'find_files',\n    path: basePath,\n    pattern: args.pattern,\n    includeIgnored: args.includeIgnored,\n    includeHidden: args.includeHidden,\n    sortBy: args.sortBy,\n    maxDepth: args.maxDepth,\n  });\n}\n\nfunction searchFilesOutput(\n  results: readonly SearchFileResult[],\n  metadata: SearchFilesPageMetadata,\n  nextCursor: string | undefined,\n): z.infer<typeof SearchFilesOutputSchema> {\n  return {\n    root: metadata.root,\n    results: [...results],\n    totalMatches: metadata.totalMatches,\n    filesScanned: metadata.filesScanned,\n    ...(metadata.skippedInaccessible ? { skippedInaccessible: metadata.skippedInaccessible } : {}),\n    ...(metadata.stoppedReason !== undefined ? { stoppedReason: metadata.stoppedReason } : {}),\n    ...(metadata.resourceUri ? { resourceUri: metadata.resourceUri } : {}),\n    ...(nextCursor !== undefined ? { nextCursor } : {}),\n  };\n}\n\nasync function handleSearchFiles(\n  args: z.infer<typeof SearchFilesInputSchema>,\n  ctx: ToolCtx,\n): Promise<{\n  structured: z.infer<typeof SearchFilesOutputSchema>;\n  link?: ReturnType<typeof putJsonResource>['link'];\n}> {\n  const requestedBasePath = ctx.fs.pathGuard.resolvePathOrRoot(args.path);\n  const queryKey = searchFilesQueryKey(args, requestedBasePath);\n  if (args.cursor !== undefined) {\n    const paged = readNextPage<SearchFileResult, SearchFilesPageMetadata>({\n      store: ctx.pageStore,\n      queryKey,\n      cursor: args.cursor,\n      pageSize: args.maxResults,\n    });\n    // First page only — see the same note in list.ts: the overflow entry expires\n    // on ResourceStore's clock, not this snapshot's.\n    const { resourceUri: _firstPageOnly, ...pageMetadata } = paged.metadata;\n    return {\n      structured: searchFilesOutput(paged.page, pageMetadata, paged.nextCursor),\n    };\n  }\n\n  const basePath = await ctx.fs.pathGuard.validateExistingDirectory(requestedBasePath);\n  const excludePatterns = args.includeIgnored ? [] : DEFAULT_EXCLUDE_PATTERNS;\n  const searchOptions: Parameters<typeof searchFiles>[3] = {\n    maxResults: MAX_SEARCH_RESULTS,\n    includeHidden: args.includeHidden,\n    sortBy: args.sortBy,\n    respectGitignore: !args.includeIgnored,\n    ...(args.maxDepth !== undefined ? { maxDepth: args.maxDepth } : {}),\n    signal: ctx.signal,\n  };\n  const result = await searchFiles(\n    basePath,\n    args.pattern,\n    excludePatterns,\n    searchOptions,\n    ctx.fs.pathGuard,\n  );\n  const relativeResults = buildRelativeResults(result.basePath, result.results);\n\n  // Store the full result set so a caller can fetch all matching files by URI\n  // when the response is incomplete: `nextCursor` covers the multi-page case,\n  // and `summary.truncated` covers a single page that already hit the hard result\n  // cap (no nextCursor, but more matches exist beyond the cap).\n  let resourceUri: string | undefined;\n  let link: ReturnType<typeof putJsonResource>['link'] | undefined;\n  if (\n    ctx.resourceStore !== undefined &&\n    (relativeResults.length > args.maxResults || result.summary.truncated)\n  ) {\n    const stored = putJsonResource(ctx.resourceStore, `${args.pattern} files`, relativeResults);\n    resourceUri = stored.entry.uri;\n    link = stored.link;\n  }\n\n  const metadata: SearchFilesPageMetadata = {\n    root: result.basePath,\n    totalMatches: result.summary.matched,\n    filesScanned: result.summary.filesScanned,\n    ...(result.summary.skippedInaccessible\n      ? { skippedInaccessible: result.summary.skippedInaccessible }\n      : {}),\n    ...(result.summary.stoppedReason !== undefined && result.summary.stoppedReason !== 'maxFiles'\n      ? { stoppedReason: result.summary.stoppedReason }\n      : {}),\n    ...(resourceUri ? { resourceUri } : {}),\n  };\n  const paged = createFirstPage<SearchFileResult, SearchFilesPageMetadata>({\n    store: ctx.pageStore,\n    queryKey,\n    items: relativeResults,\n    metadata,\n    pageSize: args.maxResults,\n  });\n  return {\n    structured: searchFilesOutput(paged.page, metadata, paged.nextCursor),\n    ...(link !== undefined ? { link } : {}),\n  };\n}\n\nexport const SEARCH_FILES = defineTool({\n  name: 'find_files',\n  title: 'Find Files',\n  description:\n    'Find files matching a glob pattern. Returns matched paths with optional metadata. ' +\n    'Pagination cursors reference a query-bound snapshot that expires after 60 seconds. ' +\n    'For content search use search_text; for bulk regex replacements use replace_text with the same glob.',\n  input: SearchFilesInputSchema,\n  output: SearchFilesOutputSchema,\n  annotations: {\n    readOnlyHint: true,\n    idempotentHint: true,\n    destructiveHint: false,\n    openWorldHint: false,\n  },\n  timeoutMs: DEFAULT_SEARCH_TIMEOUT_MS,\n  defaultErrorCode: ErrorCode.UNKNOWN,\n  progress: (args) => ({\n    label: 'Find',\n    subject: truncateProgressPattern(args.pattern),\n  }),\n  progressDone: (_args, result) => ({\n    detail: formatCount(result.totalMatches ?? 0, 'match', 'matches'),\n  }),\n  accessPaths: (args) => (args.path ? [args.path] : []),\n  run: async (args, ctx) => {\n    const { structured, link } = await handleSearchFiles(args, ctx);\n    const text =\n      structured.results.length > 0\n        ? structured.results.map((r) => r.path).join('\\n')\n        : `No files matching '${args.pattern}'`;\n    if (link) {\n      return { structured, text, resources: [link] };\n    }\n    return { structured, text };\n  },\n});\n"]}
+{"version":3,"file":"search-files.js","sourceRoot":"","sources":["../../src/tools/search-files.ts"],"names":[],"mappings":"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","sourcesContent":["import * as z from 'zod/v4';\n\nimport { SearchStoppedReasonSchema } from '../core/concurrency.js';\nimport { paginate } from '../core/cursor.js';\nimport { ErrorCode } from '../core/errors.js';\nimport { formatCount, truncateProgressPattern } from '../core/fmt.js';\nimport { DEFAULT_EXCLUDE_PATTERNS } from '../core/glob.js';\nimport { toPosixRelative } from '../core/path.js';\nimport {\n  CursorSchema,\n  includeHiddenField,\n  includeIgnoredField,\n  maxDepthField,\n  NextCursorSchema,\n  NonNegInt,\n  OptionalPath,\n  SafeGlobPattern,\n} from '../core/schema.js';\nimport { searchFiles } from '../core/search.js';\nimport type { JsonResourceResult } from '../core/store.js';\nimport { putJsonResource } from '../core/store.js';\nimport {\n  DEFAULT_SEARCH_RESULTS,\n  DEFAULT_SEARCH_TIMEOUT_MS,\n  MAX_SEARCH_RESULTS,\n} from '../core/util.js';\nimport { defineTool, type ToolCtx } from './define.js';\n\n// ---------------------------------------------------------------------------\n\nconst SearchFilesInputSchema = z.strictObject({\n  path: OptionalPath.describe('Base directory to search under (default: first allowed root)'),\n  pattern: SafeGlobPattern.describe('Glob pattern to match file paths (e.g. **/*.ts, src/**/*.js)'),\n  maxResults: z\n    .uint32()\n    .min(1)\n    .max(MAX_SEARCH_RESULTS)\n    .optional()\n    .default(DEFAULT_SEARCH_RESULTS)\n    .describe('Maximum number of matching files to return per page'),\n  includeIgnored: includeIgnoredField(),\n  includeHidden: includeHiddenField(),\n  sortBy: z\n    .enum(['name', 'path'])\n    .optional()\n    .default('path')\n    .describe('Sort order: path = full path (default), name = basename only'),\n  maxDepth: maxDepthField(),\n  cursor: CursorSchema,\n});\n\nconst SearchFilesOutputSchema = z.strictObject({\n  root: z.string().describe('Resolved base directory used as the search root'),\n  results: z\n    .array(\n      z.strictObject({\n        path: z.string().describe('File path relative to the search root'),\n      }),\n    )\n    .describe('Matched files ordered by sortBy'),\n  totalMatches: NonNegInt.optional().describe('Total number of matching files found'),\n  filesScanned: NonNegInt.optional().describe('Total number of files examined during the search'),\n  skippedInaccessible: NonNegInt.optional().describe(\n    'Files skipped due to permission or access errors',\n  ),\n  stoppedReason: SearchStoppedReasonSchema.describe(\n    'Why the search ended early: maxResults = result cap reached, timeout = time limit hit or the request was cancelled. Absent when the scan ran to completion.',\n  ),\n  resourceUri: z\n    .string()\n    .optional()\n    .describe(\n      'URI to the full results JSON in the resource store; first page only, whenever the response is incomplete — more pages follow, or the result cap cut the search',\n    ),\n  nextCursor: NextCursorSchema,\n});\n\nfunction buildRelativeResults(\n  basePath: string,\n  displayResults: readonly { path: string }[],\n): NonNullable<z.infer<typeof SearchFilesOutputSchema>['results']> {\n  const relativeResults: NonNullable<z.infer<typeof SearchFilesOutputSchema>['results']> = [];\n  for (const entry of displayResults) {\n    relativeResults.push({\n      path: toPosixRelative(basePath, entry.path),\n    });\n  }\n  return relativeResults;\n}\n\ntype SearchFileResult = NonNullable<z.infer<typeof SearchFilesOutputSchema>['results']>[number];\n\ninterface SearchFilesPageMetadata {\n  readonly root: string;\n  readonly totalMatches: number;\n  readonly filesScanned: number;\n  readonly skippedInaccessible?: number;\n  readonly stoppedReason?: z.infer<typeof SearchFilesOutputSchema>['stoppedReason'];\n}\n\nfunction searchFilesQueryKey(\n  args: z.infer<typeof SearchFilesInputSchema>,\n  basePath: string,\n): string {\n  return JSON.stringify({\n    method: 'find_files',\n    path: basePath,\n    pattern: args.pattern,\n    includeIgnored: args.includeIgnored,\n    includeHidden: args.includeHidden,\n    sortBy: args.sortBy,\n    maxDepth: args.maxDepth,\n  });\n}\n\nfunction searchFilesOutput(\n  results: readonly SearchFileResult[],\n  metadata: SearchFilesPageMetadata,\n  nextCursor: string | undefined,\n  resourceUri: string | undefined,\n): z.infer<typeof SearchFilesOutputSchema> {\n  return {\n    root: metadata.root,\n    results: [...results],\n    totalMatches: metadata.totalMatches,\n    filesScanned: metadata.filesScanned,\n    ...(metadata.skippedInaccessible ? { skippedInaccessible: metadata.skippedInaccessible } : {}),\n    ...(metadata.stoppedReason !== undefined ? { stoppedReason: metadata.stoppedReason } : {}),\n    ...(resourceUri !== undefined ? { resourceUri } : {}),\n    ...(nextCursor !== undefined ? { nextCursor } : {}),\n  };\n}\n\nasync function handleSearchFiles(\n  args: z.infer<typeof SearchFilesInputSchema>,\n  ctx: ToolCtx,\n): Promise<{\n  structured: z.infer<typeof SearchFilesOutputSchema>;\n  link?: ReturnType<typeof putJsonResource>['link'];\n}> {\n  const requestedBasePath = ctx.fs.pathGuard.resolvePathOrRoot(args.path);\n  const queryKey = searchFilesQueryKey(args, requestedBasePath);\n  const { resourceStore } = ctx;\n\n  const paged = await paginate<SearchFileResult, SearchFilesPageMetadata, JsonResourceResult>({\n    store: ctx.pageStore,\n    queryKey,\n    cursor: args.cursor,\n    pageSize: args.maxResults,\n    produce: async () => {\n      const basePath = await ctx.fs.pathGuard.validateExistingDirectory(requestedBasePath);\n      const excludePatterns = args.includeIgnored ? [] : DEFAULT_EXCLUDE_PATTERNS;\n      const searchOptions: Parameters<typeof searchFiles>[3] = {\n        maxResults: MAX_SEARCH_RESULTS,\n        includeHidden: args.includeHidden,\n        sortBy: args.sortBy,\n        respectGitignore: !args.includeIgnored,\n        ...(args.maxDepth !== undefined ? { maxDepth: args.maxDepth } : {}),\n        signal: ctx.signal,\n      };\n      const result = await searchFiles(\n        basePath,\n        args.pattern,\n        excludePatterns,\n        searchOptions,\n        ctx.fs.pathGuard,\n      );\n      return {\n        items: buildRelativeResults(result.basePath, result.results),\n        metadata: {\n          root: result.basePath,\n          totalMatches: result.summary.matched,\n          filesScanned: result.summary.filesScanned,\n          ...(result.summary.skippedInaccessible\n            ? { skippedInaccessible: result.summary.skippedInaccessible }\n            : {}),\n          ...(result.summary.stoppedReason !== undefined &&\n          result.summary.stoppedReason !== 'maxFiles'\n            ? { stoppedReason: result.summary.stoppedReason }\n            : {}),\n        },\n        truncated: result.summary.truncated,\n      };\n    },\n    externalize: resourceStore\n      ? (results) => putJsonResource(resourceStore, `${args.pattern} files`, results)\n      : undefined,\n  });\n\n  return {\n    structured: searchFilesOutput(\n      paged.page,\n      paged.metadata,\n      paged.nextCursor,\n      paged.resource?.entry.uri,\n    ),\n    ...(paged.resource ? { link: paged.resource.link } : {}),\n  };\n}\n\nexport const SEARCH_FILES = defineTool({\n  name: 'find_files',\n  title: 'Find Files',\n  description:\n    'Find files matching a glob pattern. Returns matched paths with optional metadata. ' +\n    'Pagination cursors reference a query-bound snapshot that expires after 60 seconds. ' +\n    'For content search use search_text; for bulk regex replacements use replace_text with the same glob.',\n  input: SearchFilesInputSchema,\n  output: SearchFilesOutputSchema,\n  annotations: {\n    readOnlyHint: true,\n    idempotentHint: true,\n    destructiveHint: false,\n    openWorldHint: false,\n  },\n  timeoutMs: DEFAULT_SEARCH_TIMEOUT_MS,\n  defaultErrorCode: ErrorCode.UNKNOWN,\n  progress: (args) => ({\n    label: 'Find',\n    subject: truncateProgressPattern(args.pattern),\n  }),\n  progressDone: (_args, result) => ({\n    detail: formatCount(result.totalMatches ?? 0, 'match', 'matches'),\n  }),\n  accessPaths: (args) => (args.path ? [args.path] : []),\n  run: async (args, ctx) => {\n    const { structured, link } = await handleSearchFiles(args, ctx);\n    const text =\n      structured.results.length > 0\n        ? structured.results.map((r) => r.path).join('\\n')\n        : `No files matching '${args.pattern}'`;\n    if (link) {\n      return { structured, text, resources: [link] };\n    }\n    return { structured, text };\n  },\n});\n"]}

package/dist/tools/stat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stat.d.ts","sourceRoot":"","sources":["../../src/tools/stat.ts"],"names":[],"mappings":"AA+LA,eAAO,MAAM,aAAa,mCAsExB,CAAC"}
+{"version":3,"file":"stat.d.ts","sourceRoot":"","sources":["../../src/tools/stat.ts"],"names":[],"mappings":"AA+LA,eAAO,MAAM,aAAa,mCAuExB,CAAC"}

package/dist/tools/stat.js

@@ -6,7 +6,7 @@ import { detectMimeType } from '../core/mime.js';
 import { FileInfoSchema, NonNegInt, OperationSummarySchema, PerFileErrorSchema, singleOrBatchAccessPaths, singleOrBatchPathsInput, } from '../core/schema.js';
 import { putJsonResource } from '../core/store.js';
 import { DEFAULT_SEARCH_TIMEOUT_MS } from '../core/util.js';
-import { runOverPaths } from './batch.js';
+import { isTotalFailure, runOverPaths } from './batch.js';
 import { defineTool } from './define.js';
 const StatInputSchema = singleOrBatchPathsInput({ extra: {} });
 const StatPerPathSchema = z.strictObject({
@@ -187,6 +187,7 @@ export const GET_FILE_INFO = defineTool({
                 dirCount,
                 ...(resourceUri ? { resourceUri } : {}),
             },
+            isError: isTotalFailure(batch.summary),
             ...(resources.length > 0 ? { resources } : {}),
         };
     },