@octocodeai/octocode-tools-core 17.0.2 → 18.0.1

package/dist/tools/local_ripgrep/scheme.d.ts

@@ -1,6 +1,8 @@
 import { z } from 'zod';
+import type { LocalItemPagination, ToolContinuation } from '../../scheme/pagination.js';
+import type { BulkToolOutput } from '../../types/toolOutput.js';
 export declare const LocalRipgrepQuerySchema: z.ZodObject<{
-    keywords: z.ZodOptional<z.ZodString>;
+    searchText: z.ZodOptional<z.ZodString>;
     path: z.ZodString;
     mode: z.ZodDefault<z.ZodEnum<{
         paginated: "paginated";
@@ -10,10 +12,16 @@ export declare const LocalRipgrepQuerySchema: z.ZodObject<{
     }>>;
     pattern: z.ZodOptional<z.ZodString>;
     rule: z.ZodOptional<z.ZodString>;
-    fixedString: z.ZodOptional<z.ZodBoolean>;
-    perlRegex: z.ZodOptional<z.ZodBoolean>;
-    caseInsensitive: z.ZodOptional<z.ZodBoolean>;
-    caseSensitive: z.ZodOptional<z.ZodBoolean>;
+    regex: z.ZodDefault<z.ZodEnum<{
+        fixed: "fixed";
+        smart: "smart";
+        perl: "perl";
+    }>>;
+    caseMode: z.ZodDefault<z.ZodEnum<{
+        smart: "smart";
+        sensitive: "sensitive";
+        insensitive: "insensitive";
+    }>>;
     wholeWord: z.ZodOptional<z.ZodBoolean>;
     invertMatch: z.ZodOptional<z.ZodBoolean>;
     include: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -21,14 +29,15 @@ export declare const LocalRipgrepQuerySchema: z.ZodObject<{
     excludeDir: z.ZodOptional<z.ZodArray<z.ZodString>>;
     noIgnore: z.ZodOptional<z.ZodBoolean>;
     hidden: z.ZodOptional<z.ZodBoolean>;
-    filesOnly: z.ZodOptional<z.ZodBoolean>;
-    filesWithoutMatch: z.ZodOptional<z.ZodBoolean>;
     contextLines: z.ZodOptional<z.ZodNumber>;
     matchContentLength: z.ZodDefault<z.ZodNumber>;
     maxMatchesPerFile: z.ZodOptional<z.ZodNumber>;
     maxFiles: z.ZodOptional<z.ZodNumber>;
-    multiline: z.ZodOptional<z.ZodBoolean>;
-    multilineDotall: z.ZodOptional<z.ZodBoolean>;
+    multiline: z.ZodDefault<z.ZodEnum<{
+        off: "off";
+        on: "on";
+        dotall: "dotall";
+    }>>;
     sort: z.ZodDefault<z.ZodEnum<{
         path: "path";
         created: "created";
@@ -52,14 +61,21 @@ export declare const LocalRipgrepQuerySchema: z.ZodObject<{
         yaml: "yaml";
         generic: "generic";
     }>>;
-    debugRanking: z.ZodOptional<z.ZodBoolean>;
-    semanticRanking: z.ZodOptional<z.ZodBoolean>;
     langType: z.ZodOptional<z.ZodString>;
-    countLinesPerFile: z.ZodOptional<z.ZodBoolean>;
-    countMatchesPerFile: z.ZodOptional<z.ZodBoolean>;
-    onlyMatching: z.ZodOptional<z.ZodBoolean>;
-    unique: z.ZodOptional<z.ZodBoolean>;
-    countUnique: z.ZodOptional<z.ZodBoolean>;
+    captureText: z.ZodOptional<z.ZodBoolean>;
+    output: z.ZodDefault<z.ZodEnum<{
+        content: "content";
+        files: "files";
+        filesWithout: "filesWithout";
+        countLines: "countLines";
+        countMatches: "countMatches";
+        matchOnly: "matchOnly";
+    }>>;
+    unique: z.ZodDefault<z.ZodEnum<{
+        list: "list";
+        off: "off";
+        count: "count";
+    }>>;
     matchWindow: z.ZodOptional<z.ZodNumber>;
     matchPage: z.ZodOptional<z.ZodNumber>;
     itemsPerPage: z.ZodOptional<z.ZodNumber>;
@@ -69,182 +85,65 @@ export declare const LocalRipgrepQuerySchema: z.ZodObject<{
     researchGoal: z.ZodOptional<z.ZodString>;
     reasoning: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export type RipgrepQuery = z.infer<typeof LocalRipgrepQuerySchema> & {
-    unique?: boolean;
-    countUnique?: boolean;
-};
+export type RipgrepQuery = z.infer<typeof LocalRipgrepQuerySchema>;
 export declare const LocalRipgrepBulkQuerySchema: z.ZodObject<{
     responseCharOffset: z.ZodOptional<z.ZodPreprocess<z.ZodNumber>>;
     responseCharLength: z.ZodOptional<z.ZodPreprocess<z.ZodNumber>>;
     queries: z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
 }, z.core.$strip>;
-export declare const LocalSearchCodeOutputSchema: z.ZodObject<{
-    results: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        status: z.ZodOptional<z.ZodEnum<{
-            empty: "empty";
-            error: "error";
-        }>>;
-        data: z.ZodObject<{
-            files: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                path: z.ZodString;
-                matches: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                    line: z.ZodNumber;
-                    endLine: z.ZodOptional<z.ZodNumber>;
-                    value: z.ZodOptional<z.ZodString>;
-                    column: z.ZodOptional<z.ZodNumber>;
-                    endColumn: z.ZodOptional<z.ZodNumber>;
-                    count: z.ZodOptional<z.ZodNumber>;
-                    kind: z.ZodOptional<z.ZodString>;
-                    scoreHint: z.ZodOptional<z.ZodNumber>;
-                    metavars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
-                    metavarRanges: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
-                        text: z.ZodString;
-                        line: z.ZodNumber;
-                        column: z.ZodNumber;
-                        endLine: z.ZodNumber;
-                        endColumn: z.ZodNumber;
-                    }, z.core.$strip>>>>;
-                }, z.core.$strip>>>;
-                totalOccurrences: z.ZodOptional<z.ZodNumber>;
-                totalMatchedLines: z.ZodOptional<z.ZodNumber>;
-                totalMatchRows: z.ZodOptional<z.ZodNumber>;
-                returnedMatchRows: z.ZodOptional<z.ZodNumber>;
-                ranking: z.ZodOptional<z.ZodObject<{
-                    score: z.ZodNumber;
-                    profile: z.ZodOptional<z.ZodString>;
-                    pathRole: z.ZodOptional<z.ZodString>;
-                    reasons: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                }, z.core.$strip>>;
-                matchPagination: z.ZodOptional<z.ZodObject<{
-                    currentPage: z.ZodNumber;
-                    totalPages: z.ZodNumber;
-                    hasMore: z.ZodBoolean;
-                    nextPage: z.ZodOptional<z.ZodNumber>;
-                    pageSize: z.ZodOptional<z.ZodNumber>;
-                    totalItems: z.ZodOptional<z.ZodNumber>;
-                    perPage: z.ZodOptional<z.ZodNumber>;
-                    totalFound: z.ZodOptional<z.ZodNumber>;
-                    returned: z.ZodOptional<z.ZodNumber>;
-                    reportedTotalMatches: z.ZodOptional<z.ZodNumber>;
-                    reachableTotalMatches: z.ZodOptional<z.ZodNumber>;
-                    totalMatchesKind: z.ZodOptional<z.ZodEnum<{
-                        exact: "exact";
-                        reported: "reported";
-                        lowerBound: "lowerBound";
-                    }>>;
-                    totalMatchesCapped: z.ZodOptional<z.ZodBoolean>;
-                    totalResults: z.ZodOptional<z.ZodNumber>;
-                    itemsPerPage: z.ZodOptional<z.ZodNumber>;
-                    filesPerPage: z.ZodOptional<z.ZodNumber>;
-                    entriesPerPage: z.ZodOptional<z.ZodNumber>;
-                    matchesPerPage: z.ZodOptional<z.ZodNumber>;
-                    totalFiles: z.ZodOptional<z.ZodNumber>;
-                    totalEntries: z.ZodOptional<z.ZodNumber>;
-                    totalMatches: z.ZodOptional<z.ZodNumber>;
-                    totalFilesFound: z.ZodOptional<z.ZodNumber>;
-                    nextMatchPage: z.ZodOptional<z.ZodNumber>;
-                }, z.core.$strip>>;
-                pagination: z.ZodOptional<z.ZodObject<{
-                    currentPage: z.ZodNumber;
-                    totalPages: z.ZodNumber;
-                    hasMore: z.ZodBoolean;
-                    nextPage: z.ZodOptional<z.ZodNumber>;
-                    pageSize: z.ZodOptional<z.ZodNumber>;
-                    totalItems: z.ZodOptional<z.ZodNumber>;
-                    perPage: z.ZodOptional<z.ZodNumber>;
-                    totalFound: z.ZodOptional<z.ZodNumber>;
-                    returned: z.ZodOptional<z.ZodNumber>;
-                    reportedTotalMatches: z.ZodOptional<z.ZodNumber>;
-                    reachableTotalMatches: z.ZodOptional<z.ZodNumber>;
-                    totalMatchesKind: z.ZodOptional<z.ZodEnum<{
-                        exact: "exact";
-                        reported: "reported";
-                        lowerBound: "lowerBound";
-                    }>>;
-                    totalMatchesCapped: z.ZodOptional<z.ZodBoolean>;
-                    totalResults: z.ZodOptional<z.ZodNumber>;
-                    itemsPerPage: z.ZodOptional<z.ZodNumber>;
-                    filesPerPage: z.ZodOptional<z.ZodNumber>;
-                    entriesPerPage: z.ZodOptional<z.ZodNumber>;
-                    matchesPerPage: z.ZodOptional<z.ZodNumber>;
-                    totalFiles: z.ZodOptional<z.ZodNumber>;
-                    totalEntries: z.ZodOptional<z.ZodNumber>;
-                    totalMatches: z.ZodOptional<z.ZodNumber>;
-                    totalFilesFound: z.ZodOptional<z.ZodNumber>;
-                    nextMatchPage: z.ZodOptional<z.ZodNumber>;
-                }, z.core.$strip>>;
-                next: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-                    tool: z.ZodString;
-                    query: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-                    why: z.ZodOptional<z.ZodString>;
-                    confidence: z.ZodOptional<z.ZodEnum<{
-                        exact: "exact";
-                        heuristic: "heuristic";
-                    }>>;
-                }, z.core.$strip>>>;
-            }, z.core.$strip>>>;
-            summary: z.ZodOptional<z.ZodString>;
-            searchEngine: z.ZodOptional<z.ZodString>;
-            stats: z.ZodOptional<z.ZodObject<{
-                totalOccurrences: z.ZodOptional<z.ZodNumber>;
-                matchedLines: z.ZodOptional<z.ZodNumber>;
-                filesMatched: z.ZodOptional<z.ZodNumber>;
-                filesSearched: z.ZodOptional<z.ZodNumber>;
-                bytesSearched: z.ZodOptional<z.ZodNumber>;
-                searchTime: z.ZodOptional<z.ZodString>;
-            }, z.core.$loose>>;
-            pagination: z.ZodOptional<z.ZodObject<{
-                currentPage: z.ZodNumber;
-                totalPages: z.ZodNumber;
-                hasMore: z.ZodBoolean;
-                nextPage: z.ZodOptional<z.ZodNumber>;
-                pageSize: z.ZodOptional<z.ZodNumber>;
-                totalItems: z.ZodOptional<z.ZodNumber>;
-                perPage: z.ZodOptional<z.ZodNumber>;
-                totalFound: z.ZodOptional<z.ZodNumber>;
-                returned: z.ZodOptional<z.ZodNumber>;
-                reportedTotalMatches: z.ZodOptional<z.ZodNumber>;
-                reachableTotalMatches: z.ZodOptional<z.ZodNumber>;
-                totalMatchesKind: z.ZodOptional<z.ZodEnum<{
-                    exact: "exact";
-                    reported: "reported";
-                    lowerBound: "lowerBound";
-                }>>;
-                totalMatchesCapped: z.ZodOptional<z.ZodBoolean>;
-                totalResults: z.ZodOptional<z.ZodNumber>;
-                itemsPerPage: z.ZodOptional<z.ZodNumber>;
-                filesPerPage: z.ZodOptional<z.ZodNumber>;
-                entriesPerPage: z.ZodOptional<z.ZodNumber>;
-                matchesPerPage: z.ZodOptional<z.ZodNumber>;
-                totalFiles: z.ZodOptional<z.ZodNumber>;
-                totalEntries: z.ZodOptional<z.ZodNumber>;
-                totalMatches: z.ZodOptional<z.ZodNumber>;
-                totalFilesFound: z.ZodOptional<z.ZodNumber>;
-                nextMatchPage: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$strip>>;
-            next: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-                tool: z.ZodString;
-                query: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-                why: z.ZodOptional<z.ZodString>;
-                confidence: z.ZodOptional<z.ZodEnum<{
-                    exact: "exact";
-                    heuristic: "heuristic";
-                }>>;
-            }, z.core.$strip>>>;
-            warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>;
-    }, z.core.$strip>>;
-    base: z.ZodOptional<z.ZodString>;
-    shared: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
-    responsePagination: z.ZodOptional<z.ZodObject<{
-        currentPage: z.ZodNumber;
-        totalPages: z.ZodNumber;
-        hasMore: z.ZodBoolean;
-        charOffset: z.ZodNumber;
-        charLength: z.ZodNumber;
-        totalChars: z.ZodNumber;
-        nextCharOffset: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export type LocalSearchCodeOutput = z.infer<typeof LocalSearchCodeOutputSchema>;
+export interface LocalSearchMatch {
+    line: number;
+    endLine?: number;
+    value?: string;
+    column?: number;
+    endColumn?: number;
+    count?: number;
+    /** AST node-kind label when classifyMatches ran (declaration|callsite|…). */
+    kind?: string;
+    /** Deterministic hint derived from kind (0.0..1.0); not a ranker score. */
+    scoreHint?: number;
+    metavars?: Record<string, string[]>;
+    metavarRanges?: Record<string, Array<{
+        text: string;
+        line: number;
+        column: number;
+        endLine: number;
+        endColumn: number;
+    }>>;
+}
+export interface LocalSearchFile {
+    path: string;
+    absolutePath?: string;
+    uri?: string;
+    matches?: LocalSearchMatch[];
+    totalOccurrences?: number;
+    totalMatchedLines?: number;
+    totalMatchRows?: number;
+    returnedMatchRows?: number;
+    ranking?: {
+        score: number;
+        profile?: string;
+        pathRole?: string;
+        reasons?: string[];
+    };
+    matchPagination?: LocalItemPagination;
+    pagination?: LocalItemPagination;
+    next?: Record<string, ToolContinuation>;
+}
+export interface LocalSearchCodeData {
+    files?: LocalSearchFile[];
+    summary?: string;
+    searchEngine?: string;
+    stats?: {
+        totalOccurrences?: number;
+        matchedLines?: number;
+        filesMatched?: number;
+        filesSearched?: number;
+        bytesSearched?: number;
+        searchTime?: string;
+        [key: string]: unknown;
+    };
+    pagination?: LocalItemPagination;
+    next?: Record<string, ToolContinuation>;
+}
+export type LocalSearchCodeOutput = BulkToolOutput<LocalSearchCodeData>;

package/dist/tools/local_view_structure/execution.d.ts

@@ -1,5 +1,4 @@
 import { type CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 import { type ViewStructureQuery } from './scheme.js';
 import type { ToolExecutionArgs } from '../../types/execution.js';
-export { finalizeViewStructureResult } from './local_view_structure.js';
 export declare function executeViewStructure(args: ToolExecutionArgs<ViewStructureQuery>): Promise<CallToolResult>;

package/dist/tools/local_view_structure/local_view_structure.d.ts

@@ -3,5 +3,4 @@ import type { WithOptionalMeta } from '../../types/execution.js';
 import type { ViewStructureQuery as LocalViewStructureQuery } from './scheme.js';
 type ViewStructureQuery = WithOptionalMeta<LocalViewStructureQuery>;
 export declare function viewStructure(query: ViewStructureQuery): Promise<LocalViewStructureToolResult>;
-export declare function finalizeViewStructureResult(result: LocalViewStructureToolResult, _query: ViewStructureQuery): LocalViewStructureToolResult;
 export {};

package/dist/tools/local_view_structure/scheme.d.ts

@@ -1,7 +1,13 @@
 import { z } from 'zod';
+import type { LocalItemPagination, ToolContinuation } from '../../scheme/pagination.js';
+import type { BulkToolOutput } from '../../types/toolOutput.js';
 export declare const LocalViewStructureQuerySchema: z.ZodObject<{
     path: z.ZodString;
-    details: z.ZodOptional<z.ZodBoolean>;
+    detail: z.ZodDefault<z.ZodEnum<{
+        full: "full";
+        modified: "modified";
+        basic: "basic";
+    }>>;
     hidden: z.ZodOptional<z.ZodBoolean>;
     sortBy: z.ZodDefault<z.ZodEnum<{
         extension: "extension";
@@ -11,13 +17,14 @@ export declare const LocalViewStructureQuerySchema: z.ZodObject<{
     }>>;
     reverse: z.ZodOptional<z.ZodBoolean>;
     pattern: z.ZodOptional<z.ZodString>;
-    directoriesOnly: z.ZodOptional<z.ZodBoolean>;
-    filesOnly: z.ZodOptional<z.ZodBoolean>;
+    entryType: z.ZodOptional<z.ZodEnum<{
+        f: "f";
+        d: "d";
+    }>>;
     recursive: z.ZodOptional<z.ZodBoolean>;
     extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
     maxDepth: z.ZodOptional<z.ZodNumber>;
     limit: z.ZodOptional<z.ZodNumber>;
-    showFileLastModified: z.ZodOptional<z.ZodBoolean>;
     page: z.ZodDefault<z.ZodNumber>;
     itemsPerPage: z.ZodOptional<z.ZodNumber>;
     id: z.ZodOptional<z.ZodString>;
@@ -31,86 +38,26 @@ export declare const LocalViewStructureBulkQuerySchema: z.ZodObject<{
     responseCharLength: z.ZodOptional<z.ZodPreprocess<z.ZodNumber>>;
     queries: z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
 }, z.core.$strip>;
-export declare const LocalViewStructureOutputSchema: z.ZodObject<{
-    results: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        status: z.ZodOptional<z.ZodEnum<{
-            empty: "empty";
-            error: "error";
-        }>>;
-        data: z.ZodObject<{
-            path: z.ZodOptional<z.ZodString>;
-            entries: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                name: z.ZodOptional<z.ZodString>;
-                type: z.ZodEnum<{
-                    file: "file";
-                    link: "link";
-                    directory: "directory";
-                    dir: "dir";
-                    symlink: "symlink";
-                }>;
-                path: z.ZodOptional<z.ZodString>;
-                depth: z.ZodOptional<z.ZodNumber>;
-                size: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
-                sizeBytes: z.ZodOptional<z.ZodNumber>;
-                modified: z.ZodOptional<z.ZodString>;
-                permissions: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>>;
-            files: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            folders: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            links: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            summary: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
-            pagination: z.ZodOptional<z.ZodObject<{
-                currentPage: z.ZodNumber;
-                totalPages: z.ZodNumber;
-                hasMore: z.ZodBoolean;
-                nextPage: z.ZodOptional<z.ZodNumber>;
-                pageSize: z.ZodOptional<z.ZodNumber>;
-                totalItems: z.ZodOptional<z.ZodNumber>;
-                perPage: z.ZodOptional<z.ZodNumber>;
-                totalFound: z.ZodOptional<z.ZodNumber>;
-                returned: z.ZodOptional<z.ZodNumber>;
-                reportedTotalMatches: z.ZodOptional<z.ZodNumber>;
-                reachableTotalMatches: z.ZodOptional<z.ZodNumber>;
-                totalMatchesKind: z.ZodOptional<z.ZodEnum<{
-                    exact: "exact";
-                    reported: "reported";
-                    lowerBound: "lowerBound";
-                }>>;
-                totalMatchesCapped: z.ZodOptional<z.ZodBoolean>;
-                totalResults: z.ZodOptional<z.ZodNumber>;
-                itemsPerPage: z.ZodOptional<z.ZodNumber>;
-                filesPerPage: z.ZodOptional<z.ZodNumber>;
-                entriesPerPage: z.ZodOptional<z.ZodNumber>;
-                matchesPerPage: z.ZodOptional<z.ZodNumber>;
-                totalFiles: z.ZodOptional<z.ZodNumber>;
-                totalEntries: z.ZodOptional<z.ZodNumber>;
-                totalMatches: z.ZodOptional<z.ZodNumber>;
-                totalFilesFound: z.ZodOptional<z.ZodNumber>;
-                nextMatchPage: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$strip>>;
-            next: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-                tool: z.ZodString;
-                query: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-                why: z.ZodOptional<z.ZodString>;
-                confidence: z.ZodOptional<z.ZodEnum<{
-                    exact: "exact";
-                    heuristic: "heuristic";
-                }>>;
-            }, z.core.$strip>>>;
-            warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>;
-    }, z.core.$strip>>;
-    base: z.ZodOptional<z.ZodString>;
-    shared: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
-    responsePagination: z.ZodOptional<z.ZodObject<{
-        currentPage: z.ZodNumber;
-        totalPages: z.ZodNumber;
-        hasMore: z.ZodBoolean;
-        charOffset: z.ZodNumber;
-        charLength: z.ZodNumber;
-        totalChars: z.ZodNumber;
-        nextCharOffset: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export type LocalViewStructureOutput = z.infer<typeof LocalViewStructureOutputSchema>;
+export interface LocalViewStructureEntry {
+    name?: string;
+    type: 'file' | 'dir' | 'directory' | 'link' | 'symlink';
+    path?: string;
+    absolutePath?: string;
+    uri?: string;
+    depth?: number;
+    size?: number | string;
+    sizeBytes?: number;
+    modified?: string;
+    permissions?: string;
+}
+export interface LocalViewStructureData {
+    path?: string;
+    entries?: LocalViewStructureEntry[];
+    files?: string[];
+    folders?: string[];
+    links?: string[];
+    summary?: string | Record<string, unknown>;
+    pagination?: LocalItemPagination;
+    next?: Record<string, ToolContinuation>;
+}
+export type LocalViewStructureOutput = BulkToolOutput<LocalViewStructureData>;

package/dist/tools/local_view_structure/structureFilters.d.ts

@@ -9,11 +9,9 @@ export interface DirectoryEntry {
     extension?: string;
     depth?: number;
 }
-type EntryFilterQuery = Pick<{
+type EntryFilterQuery = {
     pattern?: string;
-    directoriesOnly?: boolean;
-    filesOnly?: boolean;
-}, 'pattern' | 'directoriesOnly' | 'filesOnly'>;
+};
 export declare function applyEntryFilters(entries: DirectoryEntry[], query: EntryFilterQuery): DirectoryEntry[];
 interface EntryOutput {
     type: 'file' | 'dir' | 'link';

package/dist/tools/local_view_structure/structureResponse.d.ts

@@ -22,6 +22,7 @@ export declare function paginateEntries(entries: DirectoryEntry[], query: {
         totalEntries: number;
         hasMore: boolean;
         nextPage?: number;
+        outOfRange?: boolean;
     };
 };
 export declare function buildEntryPaginationHints(entries: DirectoryEntry[], paginatedCount: number, pagination: {

package/dist/tools/local_view_structure/viewStructureNext.d.ts

@@ -0,0 +1,25 @@
+import type { DirectoryEntry } from './structureFilters.js';
+type ViewStructureNextCall = {
+    tool: 'localGetFileContent' | 'localViewStructure';
+    query: Record<string, unknown>;
+    why: string;
+    confidence?: 'exact' | 'high' | 'medium' | 'low';
+};
+export type ViewStructureNextMap = {
+    fetch?: ViewStructureNextCall;
+    viewDeeper?: ViewStructureNextCall;
+};
+/**
+ * Build per-result continuation hints for a localViewStructure response: read
+ * the first listed file, and/or descend into the first listed subdirectory.
+ * `nextPage` (pagination) is added separately by the caller.
+ *
+ * Queries carry each entry's absolute path, which the response
+ * path-relativizer deliberately leaves untouched inside `next` (see
+ * SKIP_TRAVERSAL_KEYS in utils/response/pathRelativize.ts), so hints stay
+ * directly callable with no manual path conversion. Meta-free by construction:
+ * queries are built from the entry path alone, never spread from the caller
+ * query, so no auto-filled id/researchGoal/reasoning can leak in.
+ */
+export declare function buildViewStructureNextMap(entries: readonly DirectoryEntry[]): ViewStructureNextMap | undefined;
+export {};

package/dist/tools/lsp/semantic_content/index.d.ts

@@ -1,2 +1,3 @@
 export { executeLspGetSemantics } from './execution.js';
-export { BulkLspGetSemanticsQuerySchema, LspGetSemanticsOutputSchema, LspGetSemanticsQuerySchema, } from './scheme.js';
+export { BulkLspGetSemanticsQuerySchema, LspGetSemanticsQuerySchema, } from './scheme.js';
+export type { LspGetSemanticsOutput } from './scheme.js';