@octocodeai/octocode-core 4.0.0 → 4.1.0

package/dist/index.js

@@ -1 +1 @@
-import{config as e}from"./configLoader.js";export const octocodeConfig=e;export const completeMetadata={instructions:e.instructions,toolNames:e.toolNames,baseSchema:{mainResearchGoal:e.baseSchema.mainResearchGoal,researchGoal:e.baseSchema.researchGoal,reasoning:e.baseSchema.reasoning,...e.baseSchema.verbosity&&{verbosity:e.baseSchema.verbosity}},tools:e.tools,baseHints:e.baseHints??{},genericErrorHints:e.genericErrorHints??[]};
+import{config as e}from"./configLoader.js";export const octocodeConfig=e;export const completeMetadata={instructions:e.instructions,toolNames:e.toolNames,baseSchema:{id:e.baseSchema.id,mainResearchGoal:e.baseSchema.mainResearchGoal,researchGoal:e.baseSchema.researchGoal,reasoning:e.baseSchema.reasoning,...e.baseSchema.verbose&&{verbose:e.baseSchema.verbose}},tools:e.tools,baseHints:e.baseHints??{},genericErrorHints:e.genericErrorHints??[]};

package/dist/schemas/extraTypes.d.ts

@@ -9,13 +9,13 @@
  *   - provider-mapper shapes (`GitHubRepositoryOutput`,
  *     `GitHubSearchRepositoriesData`).
  */
-import type { CharPagination, LspRange, LspLocation, LspMode, Verbosity, PaginationInfo, LocalSearchCodeFile, LocalFindFilesEntry, GitHubRepositoryItem, GitHubPullRequestItem, GitHubSearchCodeGroup, GitHubFileContentData } from "../types/index.js";
+import type { CharPagination, LspRange, LspLocation, LspMode, PaginationInfo, LocalSearchCodeFile, LocalFindFilesEntry, GitHubRepositoryItem, GitHubPullRequestItem, GitHubSearchCodeGroup, GitHubFileContentData } from "../types/index.js";
 export interface BaseQuery {
     id?: string;
     mainResearchGoal?: string;
     researchGoal?: string;
     reasoning?: string;
-    verbosity?: Verbosity;
+    verbose?: boolean;
 }
 /** Local-tool flavour — adds the conventional `path` field. */
 export interface BaseQueryLocal extends BaseQuery {
@@ -59,12 +59,10 @@ export interface LocalSearchCodeToolResult extends BaseToolResult {
     files?: LocalSearchCodeFile[];
     pagination?: PaginationInfo;
     searchEngine?: string;
-    charPagination?: CharPagination;
 }
 export interface LocalFindFilesToolResult extends BaseToolResult {
     files?: LocalFindFilesEntry[];
     pagination?: PaginationInfo;
-    charPagination?: CharPagination | PaginationInfo;
 }
 /** Char-range pair carried by `LocalGetFileContentToolResult.matchRanges`. */
 export interface MatchRange {
@@ -102,7 +100,6 @@ export interface LocalViewStructureToolResult extends BaseToolResult {
     entries?: LocalViewStructureEntryFlat[];
     summary?: string | Record<string, unknown>;
     pagination?: PaginationInfo;
-    charPagination?: CharPagination;
 }
 export interface LspGotoDefinitionToolResult extends BaseToolResult {
     locations?: LspLocation[];
@@ -113,7 +110,6 @@ export interface LspFindReferencesToolResult extends BaseToolResult {
     references?: LspLocation[];
     pagination?: PaginationInfo;
     lspMode?: LspMode;
-    charPagination?: CharPagination;
 }
 export interface LspCallHierarchyToolResult extends BaseToolResult {
     item?: LspCallHierarchyItem;
@@ -123,7 +119,6 @@ export interface LspCallHierarchyToolResult extends BaseToolResult {
     depth?: number;
     pagination?: PaginationInfo;
     lspMode?: LspMode;
-    charPagination?: CharPagination;
 }
 export interface GitHubRepoStructureDirectoryEntry {
     files: string[];

package/dist/schemas/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * Zod input schemas — the canonical schemas every tool exposes to MCP
  * clients. The mcp-host overlay extends these with default pagination
- * values, verbosity, and meta fields (id/researchGoal/etc.).
+ * values, detail controls, and meta fields (id/researchGoal/etc.).
  *
  * All schemas are intentionally loose at this layer:
  *   - String enums use `z.string()` so the overlay can tighten via
@@ -60,11 +60,6 @@ export declare const RipgrepQuerySchema: z.ZodObject<{
     noUnicode: z.ZodOptional<z.ZodBoolean>;
     threads: z.ZodOptional<z.ZodNumber>;
     mmap: z.ZodOptional<z.ZodBoolean>;
-    verbosity: z.ZodOptional<z.ZodEnum<{
-        basic: import("../types/index.js").Verbosity.Basic;
-        compact: import("../types/index.js").Verbosity.Compact;
-        concise: import("../types/index.js").Verbosity.Concise;
-    }>>;
     id: z.ZodOptional<z.ZodString>;
     mainResearchGoal: z.ZodOptional<z.ZodString>;
     researchGoal: z.ZodOptional<z.ZodString>;
@@ -97,14 +92,7 @@ export declare const FindFilesQuerySchema: z.ZodObject<{
     filesPerPage: z.ZodOptional<z.ZodNumber>;
     filePageNumber: z.ZodOptional<z.ZodNumber>;
     showFileLastModified: z.ZodOptional<z.ZodBoolean>;
-    charOffset: z.ZodOptional<z.ZodNumber>;
-    charLength: z.ZodOptional<z.ZodNumber>;
     sortBy: z.ZodOptional<z.ZodString>;
-    verbosity: z.ZodOptional<z.ZodEnum<{
-        basic: import("../types/index.js").Verbosity.Basic;
-        compact: import("../types/index.js").Verbosity.Compact;
-        concise: import("../types/index.js").Verbosity.Concise;
-    }>>;
     id: z.ZodOptional<z.ZodString>;
     mainResearchGoal: z.ZodOptional<z.ZodString>;
     researchGoal: z.ZodOptional<z.ZodString>;
@@ -127,14 +115,7 @@ export declare const ViewStructureQuerySchema: z.ZodObject<{
     depth: z.ZodOptional<z.ZodNumber>;
     recursive: z.ZodOptional<z.ZodBoolean>;
     limit: z.ZodOptional<z.ZodNumber>;
-    charOffset: z.ZodOptional<z.ZodNumber>;
-    charLength: z.ZodOptional<z.ZodNumber>;
     showFileLastModified: z.ZodOptional<z.ZodBoolean>;
-    verbosity: z.ZodOptional<z.ZodEnum<{
-        basic: import("../types/index.js").Verbosity.Basic;
-        compact: import("../types/index.js").Verbosity.Compact;
-        concise: import("../types/index.js").Verbosity.Concise;
-    }>>;
     id: z.ZodOptional<z.ZodString>;
     mainResearchGoal: z.ZodOptional<z.ZodString>;
     researchGoal: z.ZodOptional<z.ZodString>;
@@ -147,15 +128,8 @@ export declare const FetchContentQuerySchema: z.ZodObject<{
     matchStringContextLines: z.ZodOptional<z.ZodNumber>;
     matchStringIsRegex: z.ZodOptional<z.ZodBoolean>;
     matchStringCaseSensitive: z.ZodOptional<z.ZodBoolean>;
-    charOffset: z.ZodOptional<z.ZodNumber>;
-    charLength: z.ZodOptional<z.ZodNumber>;
     startLine: z.ZodOptional<z.ZodNumber>;
     endLine: z.ZodOptional<z.ZodNumber>;
-    verbosity: z.ZodOptional<z.ZodEnum<{
-        basic: import("../types/index.js").Verbosity.Basic;
-        compact: import("../types/index.js").Verbosity.Compact;
-        concise: import("../types/index.js").Verbosity.Concise;
-    }>>;
     id: z.ZodOptional<z.ZodString>;
     mainResearchGoal: z.ZodOptional<z.ZodString>;
     researchGoal: z.ZodOptional<z.ZodString>;
@@ -173,15 +147,8 @@ export declare const FileContentQuerySchema: z.ZodObject<{
     matchStringContextLines: z.ZodOptional<z.ZodNumber>;
     matchStringIsRegex: z.ZodOptional<z.ZodBoolean>;
     matchStringCaseSensitive: z.ZodOptional<z.ZodBoolean>;
-    charOffset: z.ZodOptional<z.ZodNumber>;
-    charLength: z.ZodOptional<z.ZodNumber>;
     forceRefresh: z.ZodOptional<z.ZodBoolean>;
     type: z.ZodOptional<z.ZodString>;
-    verbosity: z.ZodOptional<z.ZodEnum<{
-        basic: import("../types/index.js").Verbosity.Basic;
-        compact: import("../types/index.js").Verbosity.Compact;
-        concise: import("../types/index.js").Verbosity.Concise;
-    }>>;
     id: z.ZodOptional<z.ZodString>;
     mainResearchGoal: z.ZodOptional<z.ZodString>;
     researchGoal: z.ZodOptional<z.ZodString>;
@@ -200,11 +167,6 @@ export declare const GitHubCodeSearchQuerySchema: z.ZodObject<{
     }>>;
     limit: z.ZodOptional<z.ZodNumber>;
     page: z.ZodOptional<z.ZodNumber>;
-    verbosity: z.ZodOptional<z.ZodEnum<{
-        basic: import("../types/index.js").Verbosity.Basic;
-        compact: import("../types/index.js").Verbosity.Compact;
-        concise: import("../types/index.js").Verbosity.Concise;
-    }>>;
     id: z.ZodOptional<z.ZodString>;
     mainResearchGoal: z.ZodOptional<z.ZodString>;
     researchGoal: z.ZodOptional<z.ZodString>;
@@ -227,11 +189,6 @@ export declare const GitHubReposSearchSingleQuerySchema: z.ZodObject<{
     sort: z.ZodOptional<z.ZodString>;
     limit: z.ZodOptional<z.ZodNumber>;
     page: z.ZodOptional<z.ZodNumber>;
-    verbosity: z.ZodOptional<z.ZodEnum<{
-        basic: import("../types/index.js").Verbosity.Basic;
-        compact: import("../types/index.js").Verbosity.Compact;
-        concise: import("../types/index.js").Verbosity.Concise;
-    }>>;
     id: z.ZodOptional<z.ZodString>;
     mainResearchGoal: z.ZodOptional<z.ZodString>;
     researchGoal: z.ZodOptional<z.ZodString>;
@@ -274,18 +231,11 @@ export declare const GitHubPullRequestSearchQuerySchema: z.ZodObject<{
     withComments: z.ZodOptional<z.ZodBoolean>;
     withCommits: z.ZodOptional<z.ZodBoolean>;
     type: z.ZodOptional<z.ZodString>;
-    charOffset: z.ZodOptional<z.ZodNumber>;
-    charLength: z.ZodOptional<z.ZodNumber>;
     partialContentMetadata: z.ZodOptional<z.ZodArray<z.ZodObject<{
         file: z.ZodString;
         additions: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
         deletions: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
     }, z.core.$strip>>>;
-    verbosity: z.ZodOptional<z.ZodEnum<{
-        basic: import("../types/index.js").Verbosity.Basic;
-        compact: import("../types/index.js").Verbosity.Compact;
-        concise: import("../types/index.js").Verbosity.Concise;
-    }>>;
     id: z.ZodOptional<z.ZodString>;
     mainResearchGoal: z.ZodOptional<z.ZodString>;
     researchGoal: z.ZodOptional<z.ZodString>;
@@ -299,11 +249,6 @@ export declare const GitHubViewRepoStructureQuerySchema: z.ZodObject<{
     depth: z.ZodOptional<z.ZodNumber>;
     entriesPerPage: z.ZodOptional<z.ZodNumber>;
     entryPageNumber: z.ZodOptional<z.ZodNumber>;
-    verbosity: z.ZodOptional<z.ZodEnum<{
-        basic: import("../types/index.js").Verbosity.Basic;
-        compact: import("../types/index.js").Verbosity.Compact;
-        concise: import("../types/index.js").Verbosity.Concise;
-    }>>;
     id: z.ZodOptional<z.ZodString>;
     mainResearchGoal: z.ZodOptional<z.ZodString>;
     researchGoal: z.ZodOptional<z.ZodString>;
@@ -314,11 +259,6 @@ export declare const NpmPackageQuerySchema: z.ZodObject<{
     name: z.ZodString;
     searchLimit: z.ZodOptional<z.ZodNumber>;
     npmFetchMetadata: z.ZodOptional<z.ZodBoolean>;
-    verbosity: z.ZodOptional<z.ZodEnum<{
-        basic: import("../types/index.js").Verbosity.Basic;
-        compact: import("../types/index.js").Verbosity.Compact;
-        concise: import("../types/index.js").Verbosity.Concise;
-    }>>;
     id: z.ZodOptional<z.ZodString>;
     mainResearchGoal: z.ZodOptional<z.ZodString>;
     researchGoal: z.ZodOptional<z.ZodString>;
@@ -330,13 +270,6 @@ export declare const CloneRepoQuerySchema: z.ZodObject<{
     branch: z.ZodOptional<z.ZodString>;
     sparse_path: z.ZodOptional<z.ZodString>;
     forceRefresh: z.ZodOptional<z.ZodBoolean>;
-    charOffset: z.ZodOptional<z.ZodNumber>;
-    charLength: z.ZodOptional<z.ZodNumber>;
-    verbosity: z.ZodOptional<z.ZodEnum<{
-        basic: import("../types/index.js").Verbosity.Basic;
-        compact: import("../types/index.js").Verbosity.Compact;
-        concise: import("../types/index.js").Verbosity.Concise;
-    }>>;
     id: z.ZodOptional<z.ZodString>;
     mainResearchGoal: z.ZodOptional<z.ZodString>;
     researchGoal: z.ZodOptional<z.ZodString>;
@@ -349,13 +282,6 @@ export declare const BulkCloneRepoSchema: z.ZodObject<{
         branch: z.ZodOptional<z.ZodString>;
         sparse_path: z.ZodOptional<z.ZodString>;
         forceRefresh: z.ZodOptional<z.ZodBoolean>;
-        charOffset: z.ZodOptional<z.ZodNumber>;
-        charLength: z.ZodOptional<z.ZodNumber>;
-        verbosity: z.ZodOptional<z.ZodEnum<{
-            basic: import("../types/index.js").Verbosity.Basic;
-            compact: import("../types/index.js").Verbosity.Compact;
-            concise: import("../types/index.js").Verbosity.Concise;
-        }>>;
         id: z.ZodOptional<z.ZodString>;
         mainResearchGoal: z.ZodOptional<z.ZodString>;
         researchGoal: z.ZodOptional<z.ZodString>;
@@ -364,13 +290,6 @@ export declare const BulkCloneRepoSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const LSPGotoDefinitionQuerySchema: z.ZodObject<{
     contextLines: z.ZodOptional<z.ZodNumber>;
-    charOffset: z.ZodOptional<z.ZodNumber>;
-    charLength: z.ZodOptional<z.ZodNumber>;
-    verbosity: z.ZodOptional<z.ZodEnum<{
-        basic: import("../types/index.js").Verbosity.Basic;
-        compact: import("../types/index.js").Verbosity.Compact;
-        concise: import("../types/index.js").Verbosity.Concise;
-    }>>;
     uri: z.ZodString;
     symbolName: z.ZodString;
     lineHint: z.ZodNumber;
@@ -388,13 +307,6 @@ export declare const LSPFindReferencesQuerySchema: z.ZodObject<{
     groupByFile: z.ZodOptional<z.ZodBoolean>;
     includePattern: z.ZodOptional<z.ZodArray<z.ZodString>>;
     excludePattern: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    charOffset: z.ZodOptional<z.ZodNumber>;
-    charLength: z.ZodOptional<z.ZodNumber>;
-    verbosity: z.ZodOptional<z.ZodEnum<{
-        basic: import("../types/index.js").Verbosity.Basic;
-        compact: import("../types/index.js").Verbosity.Compact;
-        concise: import("../types/index.js").Verbosity.Concise;
-    }>>;
     uri: z.ZodString;
     symbolName: z.ZodString;
     lineHint: z.ZodNumber;
@@ -413,13 +325,6 @@ export declare const LSPCallHierarchyQuerySchema: z.ZodObject<{
     contextLines: z.ZodOptional<z.ZodNumber>;
     callsPerPage: z.ZodOptional<z.ZodNumber>;
     page: z.ZodOptional<z.ZodNumber>;
-    charOffset: z.ZodOptional<z.ZodNumber>;
-    charLength: z.ZodOptional<z.ZodNumber>;
-    verbosity: z.ZodOptional<z.ZodEnum<{
-        basic: import("../types/index.js").Verbosity.Basic;
-        compact: import("../types/index.js").Verbosity.Compact;
-        concise: import("../types/index.js").Verbosity.Concise;
-    }>>;
     uri: z.ZodString;
     symbolName: z.ZodString;
     lineHint: z.ZodNumber;

package/dist/schemas/index.js

@@ -1 +1 @@
-import{z as o}from"zod";import{VERBOSITY_VALUES as n}from"../types/index.js";const t=o.enum([...n]).optional(),e=o.array(o.string()).optional(),i={id:o.string().optional(),mainResearchGoal:o.string().optional(),researchGoal:o.string().optional(),reasoning:o.string().optional()};export const RipgrepQuerySchema=o.object({...i,pattern:o.string(),path:o.string(),mode:o.string().optional(),fixedString:o.boolean().optional(),perlRegex:o.boolean().optional(),smartCase:o.boolean().optional(),caseInsensitive:o.boolean().optional(),caseSensitive:o.boolean().optional(),wholeWord:o.boolean().optional(),invertMatch:o.boolean().optional(),type:o.string().optional(),include:e,exclude:e,excludeDir:e,noIgnore:o.boolean().optional(),hidden:o.boolean().optional(),followSymlinks:o.boolean().optional(),filesOnly:o.boolean().optional(),filesWithoutMatch:o.boolean().optional(),count:o.boolean().optional(),countMatches:o.boolean().optional(),contextLines:o.number().int().optional(),beforeContext:o.number().int().optional(),afterContext:o.number().int().optional(),matchContentLength:o.number().int().optional(),maxMatchesPerFile:o.number().int().optional(),maxFiles:o.number().int().optional(),filesPerPage:o.number().int().optional(),filePageNumber:o.number().int().optional(),matchesPerPage:o.number().int().optional(),multiline:o.boolean().optional(),multilineDotall:o.boolean().optional(),binaryFiles:o.string().optional(),includeStats:o.boolean().optional(),encoding:o.string().optional(),sort:o.string().optional(),sortReverse:o.boolean().optional(),noMessages:o.boolean().optional(),lineRegexp:o.boolean().optional(),passthru:o.boolean().optional(),debug:o.boolean().optional(),showFileLastModified:o.boolean().optional(),noUnicode:o.boolean().optional(),threads:o.number().int().optional(),mmap:o.boolean().optional(),verbosity:t});export const FindFilesQuerySchema=o.object({...i,path:o.string(),maxDepth:o.number().int().optional(),minDepth:o.number().int().optional(),name:o.string().optional(),iname:o.string().optional(),names:e,pathPattern:o.string().optional(),regex:o.string().optional(),regexType:o.string().optional(),type:o.string().optional(),empty:o.boolean().optional(),modifiedWithin:o.string().optional(),modifiedBefore:o.string().optional(),accessedWithin:o.string().optional(),sizeGreater:o.string().optional(),sizeLess:o.string().optional(),permissions:o.string().optional(),executable:o.boolean().optional(),readable:o.boolean().optional(),writable:o.boolean().optional(),excludeDir:e,limit:o.number().int().optional(),details:o.boolean().optional(),filesPerPage:o.number().int().optional(),filePageNumber:o.number().int().optional(),showFileLastModified:o.boolean().optional(),charOffset:o.number().int().optional(),charLength:o.number().int().optional(),sortBy:o.string().optional(),verbosity:t});export const ViewStructureQuerySchema=o.object({...i,path:o.string(),details:o.boolean().optional(),hidden:o.boolean().optional(),humanReadable:o.boolean().optional(),sortBy:o.string().optional(),reverse:o.boolean().optional(),entriesPerPage:o.number().int().optional(),entryPageNumber:o.number().int().optional(),pattern:o.string().optional(),directoriesOnly:o.boolean().optional(),filesOnly:o.boolean().optional(),extension:o.string().optional(),extensions:e,depth:o.number().int().optional(),recursive:o.boolean().optional(),limit:o.number().int().optional(),charOffset:o.number().int().optional(),charLength:o.number().int().optional(),showFileLastModified:o.boolean().optional(),verbosity:t});export const FetchContentQuerySchema=o.object({...i,path:o.string(),fullContent:o.boolean().optional(),matchString:o.string().optional(),matchStringContextLines:o.number().int().optional(),matchStringIsRegex:o.boolean().optional(),matchStringCaseSensitive:o.boolean().optional(),charOffset:o.number().int().optional(),charLength:o.number().int().optional(),startLine:o.number().int().optional(),endLine:o.number().int().optional(),verbosity:t});export const FileContentQuerySchema=o.object({...i,owner:o.string(),repo:o.string(),branch:o.string().optional(),path:o.string(),startLine:o.number().int().optional(),endLine:o.number().int().optional(),fullContent:o.boolean().optional(),matchString:o.string().optional(),matchStringContextLines:o.number().int().optional(),matchStringIsRegex:o.boolean().optional(),matchStringCaseSensitive:o.boolean().optional(),charOffset:o.number().int().optional(),charLength:o.number().int().optional(),forceRefresh:o.boolean().optional(),type:o.string().optional(),verbosity:t});export const GitHubCodeSearchQuerySchema=o.object({...i,keywordsToSearch:e,owner:o.string().optional(),repo:o.string().optional(),extension:o.string().optional(),filename:o.string().optional(),path:o.string().optional(),match:o.enum(["file","path"]).optional(),limit:o.number().int().optional(),page:o.number().int().optional(),verbosity:t});export const GitHubReposSearchSingleQuerySchema=o.object({...i,keywordsToSearch:e,topicsToSearch:e,language:o.string().optional(),owner:o.string().optional(),stars:o.string().optional(),size:o.string().optional(),created:o.string().optional(),updated:o.string().optional(),match:o.array(o.enum(["name","description","readme"])).optional(),sort:o.string().optional(),limit:o.number().int().optional(),page:o.number().int().optional(),verbosity:t});export const GitHubPullRequestSearchQuerySchema=o.object({...i,query:o.string().optional(),prNumber:o.number().int().optional(),owner:o.string().optional(),repo:o.string().optional(),state:o.string().optional(),assignee:o.string().optional(),author:o.string().optional(),commenter:o.string().optional(),involves:o.string().optional(),mentions:o.string().optional(),"review-requested":o.string().optional(),"reviewed-by":o.string().optional(),label:o.union([o.string(),o.array(o.string())]).optional(),"no-label":o.boolean().optional(),"no-milestone":o.boolean().optional(),"no-project":o.boolean().optional(),"no-assignee":o.boolean().optional(),head:o.string().optional(),base:o.string().optional(),created:o.string().optional(),updated:o.string().optional(),closed:o.string().optional(),"merged-at":o.string().optional(),comments:o.string().optional(),reactions:o.string().optional(),interactions:o.string().optional(),draft:o.boolean().optional(),merged:o.boolean().optional(),matchScope:e,sort:o.string().optional(),order:o.string().optional(),limit:o.number().int().optional(),page:o.number().int().optional(),withComments:o.boolean().optional(),withCommits:o.boolean().optional(),type:o.string().optional(),charOffset:o.number().int().optional(),charLength:o.number().int().optional(),partialContentMetadata:o.array(o.object({file:o.string(),additions:o.array(o.number().int()).optional(),deletions:o.array(o.number().int()).optional()})).optional(),verbosity:t});export const GitHubViewRepoStructureQuerySchema=o.object({...i,owner:o.string(),repo:o.string(),branch:o.string().optional(),path:o.string().optional(),depth:o.number().int().optional(),entriesPerPage:o.number().int().optional(),entryPageNumber:o.number().int().optional(),verbosity:t});export const NpmPackageQuerySchema=o.object({...i,ecosystem:o.literal("npm").optional(),name:o.string(),searchLimit:o.number().int().optional(),npmFetchMetadata:o.boolean().optional(),verbosity:t});export const CloneRepoQuerySchema=o.object({...i,owner:o.string(),repo:o.string(),branch:o.string().optional(),sparse_path:o.string().optional(),forceRefresh:o.boolean().optional(),charOffset:o.number().int().optional(),charLength:o.number().int().optional(),verbosity:t});export const BulkCloneRepoSchema=o.object({queries:o.array(CloneRepoQuerySchema).min(1)});const a={...i,uri:o.string(),symbolName:o.string(),lineHint:o.number().int(),orderHint:o.number().int().optional()};export const LSPGotoDefinitionQuerySchema=o.object({...a,contextLines:o.number().int().optional(),charOffset:o.number().int().optional(),charLength:o.number().int().optional(),verbosity:t});export const LSPFindReferencesQuerySchema=o.object({...a,includeDeclaration:o.boolean().optional(),contextLines:o.number().int().optional(),referencesPerPage:o.number().int().optional(),page:o.number().int().optional(),groupByFile:o.boolean().optional(),includePattern:e,excludePattern:e,charOffset:o.number().int().optional(),charLength:o.number().int().optional(),verbosity:t});export const LSPCallHierarchyQuerySchema=o.object({...a,direction:o.enum(["incoming","outgoing"]),depth:o.number().int().optional(),contextLines:o.number().int().optional(),callsPerPage:o.number().int().optional(),page:o.number().int().optional(),charOffset:o.number().int().optional(),charLength:o.number().int().optional(),verbosity:t});
+import{z as o}from"zod";const n=o.array(o.string()).optional(),t={id:o.string().optional(),mainResearchGoal:o.string().optional(),researchGoal:o.string().optional(),reasoning:o.string().optional()};export const RipgrepQuerySchema=o.object({...t,pattern:o.string(),path:o.string(),mode:o.string().optional(),fixedString:o.boolean().optional(),perlRegex:o.boolean().optional(),smartCase:o.boolean().optional(),caseInsensitive:o.boolean().optional(),caseSensitive:o.boolean().optional(),wholeWord:o.boolean().optional(),invertMatch:o.boolean().optional(),type:o.string().optional(),include:n,exclude:n,excludeDir:n,noIgnore:o.boolean().optional(),hidden:o.boolean().optional(),followSymlinks:o.boolean().optional(),filesOnly:o.boolean().optional(),filesWithoutMatch:o.boolean().optional(),count:o.boolean().optional(),countMatches:o.boolean().optional(),contextLines:o.number().int().optional(),beforeContext:o.number().int().optional(),afterContext:o.number().int().optional(),matchContentLength:o.number().int().optional(),maxMatchesPerFile:o.number().int().optional(),maxFiles:o.number().int().optional(),filesPerPage:o.number().int().optional(),filePageNumber:o.number().int().optional(),matchesPerPage:o.number().int().optional(),multiline:o.boolean().optional(),multilineDotall:o.boolean().optional(),binaryFiles:o.string().optional(),includeStats:o.boolean().optional(),encoding:o.string().optional(),sort:o.string().optional(),sortReverse:o.boolean().optional(),noMessages:o.boolean().optional(),lineRegexp:o.boolean().optional(),passthru:o.boolean().optional(),debug:o.boolean().optional(),showFileLastModified:o.boolean().optional(),noUnicode:o.boolean().optional(),threads:o.number().int().optional(),mmap:o.boolean().optional()});export const FindFilesQuerySchema=o.object({...t,path:o.string(),maxDepth:o.number().int().optional(),minDepth:o.number().int().optional(),name:o.string().optional(),iname:o.string().optional(),names:n,pathPattern:o.string().optional(),regex:o.string().optional(),regexType:o.string().optional(),type:o.string().optional(),empty:o.boolean().optional(),modifiedWithin:o.string().optional(),modifiedBefore:o.string().optional(),accessedWithin:o.string().optional(),sizeGreater:o.string().optional(),sizeLess:o.string().optional(),permissions:o.string().optional(),executable:o.boolean().optional(),readable:o.boolean().optional(),writable:o.boolean().optional(),excludeDir:n,limit:o.number().int().optional(),details:o.boolean().optional(),filesPerPage:o.number().int().optional(),filePageNumber:o.number().int().optional(),showFileLastModified:o.boolean().optional(),sortBy:o.string().optional()});export const ViewStructureQuerySchema=o.object({...t,path:o.string(),details:o.boolean().optional(),hidden:o.boolean().optional(),humanReadable:o.boolean().optional(),sortBy:o.string().optional(),reverse:o.boolean().optional(),entriesPerPage:o.number().int().optional(),entryPageNumber:o.number().int().optional(),pattern:o.string().optional(),directoriesOnly:o.boolean().optional(),filesOnly:o.boolean().optional(),extension:o.string().optional(),extensions:n,depth:o.number().int().optional(),recursive:o.boolean().optional(),limit:o.number().int().optional(),showFileLastModified:o.boolean().optional()});export const FetchContentQuerySchema=o.object({...t,path:o.string(),fullContent:o.boolean().optional(),matchString:o.string().optional(),matchStringContextLines:o.number().int().optional(),matchStringIsRegex:o.boolean().optional(),matchStringCaseSensitive:o.boolean().optional(),startLine:o.number().int().optional(),endLine:o.number().int().optional()});export const FileContentQuerySchema=o.object({...t,owner:o.string(),repo:o.string(),branch:o.string().optional(),path:o.string(),startLine:o.number().int().optional(),endLine:o.number().int().optional(),fullContent:o.boolean().optional(),matchString:o.string().optional(),matchStringContextLines:o.number().int().optional(),matchStringIsRegex:o.boolean().optional(),matchStringCaseSensitive:o.boolean().optional(),forceRefresh:o.boolean().optional(),type:o.string().optional()});export const GitHubCodeSearchQuerySchema=o.object({...t,keywordsToSearch:n,owner:o.string().optional(),repo:o.string().optional(),extension:o.string().optional(),filename:o.string().optional(),path:o.string().optional(),match:o.enum(["file","path"]).optional(),limit:o.number().int().optional(),page:o.number().int().optional()});export const GitHubReposSearchSingleQuerySchema=o.object({...t,keywordsToSearch:n,topicsToSearch:n,language:o.string().optional(),owner:o.string().optional(),stars:o.string().optional(),size:o.string().optional(),created:o.string().optional(),updated:o.string().optional(),match:o.array(o.enum(["name","description","readme"])).optional(),sort:o.string().optional(),limit:o.number().int().optional(),page:o.number().int().optional()});export const GitHubPullRequestSearchQuerySchema=o.object({...t,query:o.string().optional(),prNumber:o.number().int().optional(),owner:o.string().optional(),repo:o.string().optional(),state:o.string().optional(),assignee:o.string().optional(),author:o.string().optional(),commenter:o.string().optional(),involves:o.string().optional(),mentions:o.string().optional(),"review-requested":o.string().optional(),"reviewed-by":o.string().optional(),label:o.union([o.string(),o.array(o.string())]).optional(),"no-label":o.boolean().optional(),"no-milestone":o.boolean().optional(),"no-project":o.boolean().optional(),"no-assignee":o.boolean().optional(),head:o.string().optional(),base:o.string().optional(),created:o.string().optional(),updated:o.string().optional(),closed:o.string().optional(),"merged-at":o.string().optional(),comments:o.string().optional(),reactions:o.string().optional(),interactions:o.string().optional(),draft:o.boolean().optional(),merged:o.boolean().optional(),matchScope:n,sort:o.string().optional(),order:o.string().optional(),limit:o.number().int().optional(),page:o.number().int().optional(),withComments:o.boolean().optional(),withCommits:o.boolean().optional(),type:o.string().optional(),partialContentMetadata:o.array(o.object({file:o.string(),additions:o.array(o.number().int()).optional(),deletions:o.array(o.number().int()).optional()})).optional()});export const GitHubViewRepoStructureQuerySchema=o.object({...t,owner:o.string(),repo:o.string(),branch:o.string().optional(),path:o.string().optional(),depth:o.number().int().optional(),entriesPerPage:o.number().int().optional(),entryPageNumber:o.number().int().optional()});export const NpmPackageQuerySchema=o.object({...t,ecosystem:o.literal("npm").optional(),name:o.string(),searchLimit:o.number().int().optional(),npmFetchMetadata:o.boolean().optional()});export const CloneRepoQuerySchema=o.object({...t,owner:o.string(),repo:o.string(),branch:o.string().optional(),sparse_path:o.string().optional(),forceRefresh:o.boolean().optional()});export const BulkCloneRepoSchema=o.object({queries:o.array(CloneRepoQuerySchema).min(1)});const e={...t,uri:o.string(),symbolName:o.string(),lineHint:o.number().int(),orderHint:o.number().int().optional()};export const LSPGotoDefinitionQuerySchema=o.object({...e,contextLines:o.number().int().optional()});export const LSPFindReferencesQuerySchema=o.object({...e,includeDeclaration:o.boolean().optional(),contextLines:o.number().int().optional(),referencesPerPage:o.number().int().optional(),page:o.number().int().optional(),groupByFile:o.boolean().optional(),includePattern:n,excludePattern:n});export const LSPCallHierarchyQuerySchema=o.object({...e,direction:o.enum(["incoming","outgoing"]),depth:o.number().int().optional(),contextLines:o.number().int().optional(),callsPerPage:o.number().int().optional(),page:o.number().int().optional()});

package/dist/types/index.d.ts

@@ -21,20 +21,22 @@ export interface ToolNames {
 }
 export interface ToolHints {
     readonly empty: readonly string[];
-    readonly dynamic?: Readonly<Record<string, readonly string[] | undefined>>;
 }
 export interface ToolSchema {
     readonly [param: string]: string;
 }
 /**
- * Authoring type for resource files — carries only the static definition
- * (name, description, schema).  Runtime hints are supplied separately by the
- * MCP host; they are intentionally absent here.
+ * Authoring type for resource files — carries the static definition
+ * (name, description, schema) plus optional empty-result hints authored
+ * alongside the tool. Runtime hints from the MCP server response layer
+ * are additive; these provide pre-call and empty-result guidance.
  */
 export interface ToolSpec {
     readonly name: string;
     readonly description: string;
     readonly schema: ToolSchema;
+    /** Hints authored in the resource file. Defaults to `{ empty: [] }` when absent. */
+    readonly hints?: ToolHints;
 }
 /**
  * Full tool descriptor stored in the config blob and consumed by MCP clients.
@@ -50,41 +52,19 @@ export interface ToolMetadata extends ToolSpec {
      */
     readonly hints: ToolHints;
 }
-/**
- * Canonical verbosity enum values. Mirrored at runtime as `VERBOSITY_VALUES`
- * so consumers can `import { VERBOSITY_VALUES, Verbosity } from
- * '@octocodeai/octocode-core'` instead of re-declaring locally.
- *
- *   basic   — full content + full hints/metadata (default).
- *   compact — full content + trimmed hints/metadata.
- *   concise   — counts/top refs only, snippets dropped.
- */
-export declare enum Verbosity {
-    Basic = "basic",
-    Compact = "compact",
-    Concise = "concise"
-}
-export declare const VERBOSITY_VALUES: readonly [Verbosity.Basic, Verbosity.Compact, Verbosity.Concise];
-export interface VerbosityEnum {
-    readonly enum: readonly [
-        Verbosity.Basic,
-        Verbosity.Compact,
-        Verbosity.Concise
-    ];
-    readonly default: Verbosity.Basic;
-    readonly description: string;
-}
 export interface BaseSchema {
+    readonly id: string;
     readonly mainResearchGoal: string;
     readonly researchGoal: string;
     readonly reasoning: string;
-    readonly verbosity?: VerbosityEnum;
+    /** Description string for the boolean verbose field shown in tool schemas. */
+    readonly verbose?: string;
 }
 export interface OctocodeConfig {
     readonly instructions: string;
     readonly toolNames: ToolNames;
     readonly baseSchema: BaseSchema;
-    readonly tools: Record<ToolNames[keyof ToolNames], ToolSpec>;
+    readonly tools: Record<ToolNames[keyof ToolNames], ToolSpec | ToolMetadata>;
     readonly baseHints?: Readonly<Record<string, readonly string[]>>;
     readonly genericErrorHints?: readonly string[];
 }
@@ -143,7 +123,7 @@ export declare const LSP_MODES: readonly [LspMode.Semantic, LspMode.Fallback];
  * agent-facing wire contract stable across consumers.
  */
 export interface ToolWarning {
-    readonly kind: "match-value-truncated" | "content-truncated" | "verbosity-downgrade";
+    readonly kind: "match-value-truncated" | "content-truncated";
     readonly truncatedAt?: number;
     readonly field?: string;
     readonly path?: string;

package/dist/types/index.js

@@ -1 +1 @@
-export var Verbosity;!function(o){o.Basic="basic",o.Compact="compact",o.Concise="concise"}(Verbosity||(Verbosity={}));export const VERBOSITY_VALUES=[Verbosity.Basic,Verbosity.Compact,Verbosity.Concise];export var ToolStatus;!function(o){o.Empty="empty",o.Error="error"}(ToolStatus||(ToolStatus={}));export const STATUS_VALUES=[ToolStatus.Empty,ToolStatus.Error];export var LspMode;!function(o){o.Semantic="semantic",o.Fallback="fallback"}(LspMode||(LspMode={}));export const LSP_MODES=[LspMode.Semantic,LspMode.Fallback];
+export var ToolStatus;!function(o){o.Empty="empty",o.Error="error"}(ToolStatus||(ToolStatus={}));export const STATUS_VALUES=[ToolStatus.Empty,ToolStatus.Error];export var LspMode;!function(o){o.Semantic="semantic",o.Fallback="fallback"}(LspMode||(LspMode={}));export const LSP_MODES=[LspMode.Semantic,LspMode.Fallback];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octocodeai/octocode-core",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "Core config, prompts, tools, and schemas for Octocode MCP",
   "type": "module",
   "main": "dist/index.js",
@@ -44,7 +44,7 @@
   "scripts": {
     "generate": "tsx src/octocode-scripts/generateDefaultJson.ts",
     "compress": "yarn generate && node scripts/compress-config.mjs",
-    "build": "yarn generate && node scripts/compress-config.mjs && tsc && node scripts/minify-dist.mjs",
+    "build": "rm -rf dist && yarn generate && node scripts/compress-config.mjs && tsc && node scripts/minify-dist.mjs",
     "lint": "eslint src/**/*.ts",
     "lint:fix": "eslint src/**/*.ts --fix",
     "typecheck": "yarn compress && tsc --noEmit",
@@ -75,6 +75,7 @@
     "eslint-plugin-prettier": "^5.4.1",
     "prettier": "^3.5.3",
     "terser": "^5.46.1",
+    "tiktoken": "^1.0.22",
     "tsx": "^4.19.2",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",

package/dist/schemas/descriptions.d.ts

@@ -1,17 +0,0 @@
-/**
- * Tool description constants — the verbatim `description` text each
- * `ToolSpec` exposes in `src/resources/tools/*.ts`. The resources tree
- * is excluded from the build (`src/resources/**` in tsconfig), so the
- * canonical strings live here and the resource files import these
- * constants when generating the compressed config blob.
- *
- * Keep these in sync with `src/resources/tools/*.ts`.
- */
-export declare const LOCAL_RIPGREP_DESCRIPTION = "## Search code patterns [LOCAL: ripgrep]\n  <when>\n  - Find local code by text, regex, symbol, import, or constant\n  - Get file paths and lineHint values for LSP tools\n  - Discover matching files fast with filesOnly=true\n  </when>\n  <fromTool>\n  - localViewStructure: after identifying candidate directories\n  - localFindFiles: after narrowing by filename/metadata\n  </fromTool>\n  <toTool>\n  - lspGotoDefinition: jump to a definition using returned lineHint\n  - lspFindReferences: semantic usages of the matched symbol\n  - lspCallHierarchy: trace callers/callees of matched functions/methods\n  - localGetFileContent: read matches when LSP isn't needed\n  </toTool>";
-export declare const LOCAL_FIND_FILES_DESCRIPTION = "## Find files by metadata [LOCAL: filesystem]\n  <when>\n  - Find files/dirs by name, path, time, size, type, or permissions\n  - Narrow scope before content search\n  - Locate recently changed files with modifiedWithin\n  </when>";
-export declare const LOCAL_VIEW_STRUCTURE_DESCRIPTION = "## View directory structure [LOCAL: filesystem]\n  <when>\n  - Understand local directory layout\n  - Discover candidate source/test/config/docs paths\n  - Inspect siblings around a known path\n  </when>";
-export declare const LOCAL_FETCH_CONTENT_DESCRIPTION = "## Read file content [LOCAL: filesystem]\n  <when>\n  - Read a known local path after discovery or LSP navigation\n  - Extract a section via matchString or line range\n  - Read small config/docs/manifest/JSON/Markdown/YAML directly\n  </when>";
-export declare const GITHUB_CLONE_REPO_DESCRIPTION = "## Clone GitHub repository to local filesystem\n  <when>\n  - Need full local access to a repository (large-scale analysis, offline work)\n  - Want to run LSP tools against an external GitHub repository\n  - Repository is too large to explore efficiently via GitHub API\n  </when>";
-export declare const LSP_GOTO_DEFINITION_DESCRIPTION = "## Navigate to symbol definition [LOCAL: LSP]\n  <when>\n  - Jump from a usage to its definition/declaration\n  - Resolve imports, exports, classes, methods, variables, or types\n  - Confirm canonical implementation before reading source\n  </when>";
-export declare const LSP_FIND_REFERENCES_DESCRIPTION = "## Find all usages of a symbol [LOCAL: LSP]\n  <when>\n  - Find semantic refs to a function, class, variable, type, property, or interface\n  - Assess impact before changing a symbol\n  - Separate real refs from same-text matches\n  </when>";
-export declare const LSP_CALL_HIERARCHY_DESCRIPTION = "## Trace function call relationships [LOCAL: LSP]\n  <when>\n  - \"Who calls this function/method?\" \u2192 direction=\"incoming\"\n  - \"What does this function/method call?\" \u2192 direction=\"outgoing\"\n  - Trace execution flow or impact\n  </when>";

package/dist/schemas/descriptions.js

@@ -1 +0,0 @@
-export const LOCAL_RIPGREP_DESCRIPTION="## Search code patterns [LOCAL: ripgrep]\n  <when>\n  - Find local code by text, regex, symbol, import, or constant\n  - Get file paths and lineHint values for LSP tools\n  - Discover matching files fast with filesOnly=true\n  </when>\n  <fromTool>\n  - localViewStructure: after identifying candidate directories\n  - localFindFiles: after narrowing by filename/metadata\n  </fromTool>\n  <toTool>\n  - lspGotoDefinition: jump to a definition using returned lineHint\n  - lspFindReferences: semantic usages of the matched symbol\n  - lspCallHierarchy: trace callers/callees of matched functions/methods\n  - localGetFileContent: read matches when LSP isn't needed\n  </toTool>";export const LOCAL_FIND_FILES_DESCRIPTION="## Find files by metadata [LOCAL: filesystem]\n  <when>\n  - Find files/dirs by name, path, time, size, type, or permissions\n  - Narrow scope before content search\n  - Locate recently changed files with modifiedWithin\n  </when>";export const LOCAL_VIEW_STRUCTURE_DESCRIPTION="## View directory structure [LOCAL: filesystem]\n  <when>\n  - Understand local directory layout\n  - Discover candidate source/test/config/docs paths\n  - Inspect siblings around a known path\n  </when>";export const LOCAL_FETCH_CONTENT_DESCRIPTION="## Read file content [LOCAL: filesystem]\n  <when>\n  - Read a known local path after discovery or LSP navigation\n  - Extract a section via matchString or line range\n  - Read small config/docs/manifest/JSON/Markdown/YAML directly\n  </when>";export const GITHUB_CLONE_REPO_DESCRIPTION="## Clone GitHub repository to local filesystem\n  <when>\n  - Need full local access to a repository (large-scale analysis, offline work)\n  - Want to run LSP tools against an external GitHub repository\n  - Repository is too large to explore efficiently via GitHub API\n  </when>";export const LSP_GOTO_DEFINITION_DESCRIPTION="## Navigate to symbol definition [LOCAL: LSP]\n  <when>\n  - Jump from a usage to its definition/declaration\n  - Resolve imports, exports, classes, methods, variables, or types\n  - Confirm canonical implementation before reading source\n  </when>";export const LSP_FIND_REFERENCES_DESCRIPTION="## Find all usages of a symbol [LOCAL: LSP]\n  <when>\n  - Find semantic refs to a function, class, variable, type, property, or interface\n  - Assess impact before changing a symbol\n  - Separate real refs from same-text matches\n  </when>";export const LSP_CALL_HIERARCHY_DESCRIPTION='## Trace function call relationships [LOCAL: LSP]\n  <when>\n  - "Who calls this function/method?" → direction="incoming"\n  - "What does this function/method call?" → direction="outgoing"\n  - Trace execution flow or impact\n  </when>';