@octocodeai/octocode-tools-core 16.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (193) hide show
  1. package/dist/commands/BaseCommandBuilder.d.ts +14 -0
  2. package/dist/commands/FindCommandBuilder.d.ts +23 -0
  3. package/dist/commands/LsCommandBuilder.d.ts +15 -0
  4. package/dist/commands/RipgrepCommandBuilder.d.ts +27 -0
  5. package/dist/config.d.ts +16 -0
  6. package/dist/direct.d.ts +3 -0
  7. package/dist/direct.js +53 -0
  8. package/dist/errors/ToolError.d.ts +21 -0
  9. package/dist/errors/domainErrors.d.ts +310 -0
  10. package/dist/errors/errorFactories.d.ts +12 -0
  11. package/dist/errors/localToolErrors.d.ts +29 -0
  12. package/dist/errors/pathUtils.d.ts +1 -0
  13. package/dist/github/client.d.ts +12 -0
  14. package/dist/github/codeSearch.d.ts +8 -0
  15. package/dist/github/directoryFetch.d.ts +5 -0
  16. package/dist/github/errorConstants.d.ts +81 -0
  17. package/dist/github/errors.d.ts +3 -0
  18. package/dist/github/fileContent.d.ts +4 -0
  19. package/dist/github/fileContentProcess.d.ts +11 -0
  20. package/dist/github/fileContentRaw.d.ts +12 -0
  21. package/dist/github/githubAPI.d.ts +237 -0
  22. package/dist/github/history.d.ts +16 -0
  23. package/dist/github/prByNumber.d.ts +5 -0
  24. package/dist/github/prContentFetcher.d.ts +5 -0
  25. package/dist/github/prTransformation.d.ts +109 -0
  26. package/dist/github/pullRequestSearch.d.ts +4 -0
  27. package/dist/github/queryBuilders.d.ts +12 -0
  28. package/dist/github/repoSearch.d.ts +25 -0
  29. package/dist/github/repoStructure.d.ts +7 -0
  30. package/dist/github/repoStructurePagination.d.ts +6 -0
  31. package/dist/github/repoStructureRecursive.d.ts +3 -0
  32. package/dist/github/responseHeaders.d.ts +1 -0
  33. package/dist/hints/dynamic.d.ts +6 -0
  34. package/dist/hints/index.d.ts +2 -0
  35. package/dist/hints/types.d.ts +1 -0
  36. package/dist/index.d.ts +187 -0
  37. package/dist/index.js +64 -0
  38. package/dist/providers/capabilities.d.ts +2 -0
  39. package/dist/providers/factory.d.ts +9 -0
  40. package/dist/providers/github/GitHubProvider.d.ts +14 -0
  41. package/dist/providers/github/githubContent.d.ts +9 -0
  42. package/dist/providers/github/githubPullRequests.d.ts +12 -0
  43. package/dist/providers/github/githubSearch.d.ts +12 -0
  44. package/dist/providers/github/githubStructure.d.ts +9 -0
  45. package/dist/providers/github/utils.d.ts +10 -0
  46. package/dist/providers/providerQueries.d.ts +111 -0
  47. package/dist/providers/providerResults.d.ts +175 -0
  48. package/dist/providers/types.d.ts +48 -0
  49. package/dist/responses.d.ts +47 -0
  50. package/dist/scheme/coreSchemas.d.ts +10 -0
  51. package/dist/scheme/fields.d.ts +13 -0
  52. package/dist/scheme/responseEnvelope.d.ts +16 -0
  53. package/dist/security/bridge.d.ts +10 -0
  54. package/dist/serverConfig.d.ts +23 -0
  55. package/dist/session.d.ts +25 -0
  56. package/dist/tools/directToolCatalog.d.ts +56 -0
  57. package/dist/tools/executionGuard.d.ts +14 -0
  58. package/dist/tools/github_clone_repo/cache.d.ts +21 -0
  59. package/dist/tools/github_clone_repo/cloneRepo.d.ts +6 -0
  60. package/dist/tools/github_clone_repo/execution.d.ts +8 -0
  61. package/dist/tools/github_clone_repo/hints.d.ts +2 -0
  62. package/dist/tools/github_clone_repo/scheme.d.ts +50 -0
  63. package/dist/tools/github_clone_repo/types.d.ts +19 -0
  64. package/dist/tools/github_fetch_content/execution.d.ts +7 -0
  65. package/dist/tools/github_fetch_content/finalizer.d.ts +10 -0
  66. package/dist/tools/github_fetch_content/hints.d.ts +2 -0
  67. package/dist/tools/github_fetch_content/scheme.d.ts +120 -0
  68. package/dist/tools/github_fetch_content/types.d.ts +66 -0
  69. package/dist/tools/github_search_code/execution.d.ts +8 -0
  70. package/dist/tools/github_search_code/finalizer.d.ts +6 -0
  71. package/dist/tools/github_search_code/hints.d.ts +2 -0
  72. package/dist/tools/github_search_code/scheme.d.ts +88 -0
  73. package/dist/tools/github_search_pull_requests/contentRequest.d.ts +52 -0
  74. package/dist/tools/github_search_pull_requests/contentResponse.d.ts +18 -0
  75. package/dist/tools/github_search_pull_requests/execution.d.ts +17 -0
  76. package/dist/tools/github_search_pull_requests/hints.d.ts +2 -0
  77. package/dist/tools/github_search_pull_requests/scheme.d.ts +224 -0
  78. package/dist/tools/github_search_pull_requests/types.d.ts +120 -0
  79. package/dist/tools/github_search_repos/execution.d.ts +17 -0
  80. package/dist/tools/github_search_repos/hints.d.ts +2 -0
  81. package/dist/tools/github_search_repos/scheme.d.ts +96 -0
  82. package/dist/tools/github_view_repo_structure/constants.d.ts +4 -0
  83. package/dist/tools/github_view_repo_structure/execution.d.ts +20 -0
  84. package/dist/tools/github_view_repo_structure/hints.d.ts +2 -0
  85. package/dist/tools/github_view_repo_structure/scheme.d.ts +81 -0
  86. package/dist/tools/github_view_repo_structure/types.d.ts +39 -0
  87. package/dist/tools/local_binary_inspect/archiveOps.d.ts +22 -0
  88. package/dist/tools/local_binary_inspect/binaryInspector.d.ts +49 -0
  89. package/dist/tools/local_binary_inspect/binaryOps.d.ts +18 -0
  90. package/dist/tools/local_binary_inspect/decompressOps.d.ts +16 -0
  91. package/dist/tools/local_binary_inspect/execution.d.ts +4 -0
  92. package/dist/tools/local_binary_inspect/scheme.d.ts +44 -0
  93. package/dist/tools/local_fetch_content/contentExtractor.d.ts +9 -0
  94. package/dist/tools/local_fetch_content/execution.d.ts +5 -0
  95. package/dist/tools/local_fetch_content/fetchContent.d.ts +4 -0
  96. package/dist/tools/local_fetch_content/hints.d.ts +2 -0
  97. package/dist/tools/local_fetch_content/scheme.d.ts +31 -0
  98. package/dist/tools/local_find_files/execution.d.ts +5 -0
  99. package/dist/tools/local_find_files/findFiles.d.ts +11 -0
  100. package/dist/tools/local_find_files/hints.d.ts +2 -0
  101. package/dist/tools/local_find_files/scheme.d.ts +9 -0
  102. package/dist/tools/local_ripgrep/execution.d.ts +5 -0
  103. package/dist/tools/local_ripgrep/grepFallbackExecutor.d.ts +3 -0
  104. package/dist/tools/local_ripgrep/hints.d.ts +2 -0
  105. package/dist/tools/local_ripgrep/patternValidation.d.ts +12 -0
  106. package/dist/tools/local_ripgrep/ripgrepExecutor.d.ts +3 -0
  107. package/dist/tools/local_ripgrep/ripgrepParser.d.ts +9 -0
  108. package/dist/tools/local_ripgrep/ripgrepResultBuilder.d.ts +9 -0
  109. package/dist/tools/local_ripgrep/scheme.d.ts +55 -0
  110. package/dist/tools/local_ripgrep/searchContentRipgrep.d.ts +5 -0
  111. package/dist/tools/local_ripgrep/structuralSearch.d.ts +9 -0
  112. package/dist/tools/local_view_structure/execution.d.ts +5 -0
  113. package/dist/tools/local_view_structure/hints.d.ts +2 -0
  114. package/dist/tools/local_view_structure/local_view_structure.d.ts +7 -0
  115. package/dist/tools/local_view_structure/scheme.d.ts +33 -0
  116. package/dist/tools/local_view_structure/structureFilters.d.ts +33 -0
  117. package/dist/tools/local_view_structure/structureParser.d.ts +3 -0
  118. package/dist/tools/local_view_structure/structureResponse.d.ts +32 -0
  119. package/dist/tools/local_view_structure/structureWalker.d.ts +24 -0
  120. package/dist/tools/lsp/semantic_content/execution.d.ts +4 -0
  121. package/dist/tools/lsp/semantic_content/hints.d.ts +4 -0
  122. package/dist/tools/lsp/semantic_content/index.d.ts +2 -0
  123. package/dist/tools/lsp/semantic_content/scheme.d.ts +509 -0
  124. package/dist/tools/lsp/shared/callHierarchyTraversal.d.ts +11 -0
  125. package/dist/tools/lsp/shared/resolveSymbolAnchor.d.ts +20 -0
  126. package/dist/tools/lsp/shared/semanticTypes.d.ts +134 -0
  127. package/dist/tools/package_search/execution.d.ts +7 -0
  128. package/dist/tools/package_search/hints.d.ts +2 -0
  129. package/dist/tools/package_search/scheme.d.ts +51 -0
  130. package/dist/tools/providerExecution.d.ts +51 -0
  131. package/dist/tools/providerMappers.d.ts +277 -0
  132. package/dist/tools/toolConfig.d.ts +41 -0
  133. package/dist/tools/toolMetadata/baseSchema.d.ts +2 -0
  134. package/dist/tools/toolMetadata/descriptions.d.ts +1 -0
  135. package/dist/tools/toolMetadata/gateway.d.ts +7 -0
  136. package/dist/tools/toolMetadata/metadataPresence.d.ts +1 -0
  137. package/dist/tools/toolMetadata/names.d.ts +2 -0
  138. package/dist/tools/toolMetadata/proxies.d.ts +10 -0
  139. package/dist/tools/toolMetadata/state.d.ts +5 -0
  140. package/dist/tools/toolMetadata/types.d.ts +2 -0
  141. package/dist/tools/toolNames.d.ts +2 -0
  142. package/dist/tools/utils.d.ts +27 -0
  143. package/dist/types/bulk.d.ts +41 -0
  144. package/dist/types/execution.d.ts +11 -0
  145. package/dist/types/metadata.d.ts +69 -0
  146. package/dist/types/promise.d.ts +12 -0
  147. package/dist/types/responseTypes.d.ts +57 -0
  148. package/dist/types/server.d.ts +15 -0
  149. package/dist/types/session.d.ts +29 -0
  150. package/dist/types/toolResults.d.ts +62 -0
  151. package/dist/utils/contextUtils.d.ts +31 -0
  152. package/dist/utils/core/bestEffort.d.ts +2 -0
  153. package/dist/utils/core/compare.d.ts +1 -0
  154. package/dist/utils/core/constants.d.ts +47 -0
  155. package/dist/utils/core/promise.d.ts +2 -0
  156. package/dist/utils/core/safeRegex.d.ts +5 -0
  157. package/dist/utils/core/types.d.ts +50 -0
  158. package/dist/utils/environment/environmentDetection.d.ts +5 -0
  159. package/dist/utils/exec/commandAvailability.d.ts +19 -0
  160. package/dist/utils/exec/npm.d.ts +16 -0
  161. package/dist/utils/exec/ripgrepBinary.d.ts +3 -0
  162. package/dist/utils/exec/safe.d.ts +2 -0
  163. package/dist/utils/exec/spawn.d.ts +34 -0
  164. package/dist/utils/file/byteOffset.d.ts +12 -0
  165. package/dist/utils/file/filters.d.ts +11 -0
  166. package/dist/utils/file/size.d.ts +2 -0
  167. package/dist/utils/file/toolHelpers.d.ts +28 -0
  168. package/dist/utils/http/cache.d.ts +16 -0
  169. package/dist/utils/http/circuitBreaker.d.ts +17 -0
  170. package/dist/utils/http/fetch.d.ts +13 -0
  171. package/dist/utils/package/common.d.ts +5 -0
  172. package/dist/utils/package/npm.d.ts +8 -0
  173. package/dist/utils/package/schemas.d.ts +60 -0
  174. package/dist/utils/package/types.d.ts +55 -0
  175. package/dist/utils/pagination/boundary.d.ts +11 -0
  176. package/dist/utils/pagination/charLimit.d.ts +3 -0
  177. package/dist/utils/pagination/core.d.ts +15 -0
  178. package/dist/utils/pagination/hints.d.ts +3 -0
  179. package/dist/utils/pagination/outputSizeLimit.d.ts +16 -0
  180. package/dist/utils/pagination/types.d.ts +43 -0
  181. package/dist/utils/parsers/diff.d.ts +2 -0
  182. package/dist/utils/parsers/ripgrep.d.ts +11 -0
  183. package/dist/utils/parsers/schemas.d.ts +72 -0
  184. package/dist/utils/response/bulk.d.ts +5 -0
  185. package/dist/utils/response/callToolResult.d.ts +3 -0
  186. package/dist/utils/response/charSavings.d.ts +3 -0
  187. package/dist/utils/response/error.d.ts +20 -0
  188. package/dist/utils/response/groupedFinalizer.d.ts +37 -0
  189. package/dist/utils/response/pathRelativize.d.ts +9 -0
  190. package/dist/utils/response/structuredPagination.d.ts +9 -0
  191. package/dist/zod.d.ts +1 -0
  192. package/dist/zod.js +8 -0
  193. package/package.json +66 -0
@@ -0,0 +1,14 @@
1
+ export declare abstract class BaseCommandBuilder {
2
+ protected command: string;
3
+ protected args: string[];
4
+ constructor(command: string);
5
+ addFlag(flag: string): this;
6
+ protected addOption(option: string, value: string | number): this;
7
+ protected addArg(arg: string): this;
8
+ build(): {
9
+ command: string;
10
+ args: string[];
11
+ };
12
+ reset(): this;
13
+ getArgs(): string[];
14
+ }
@@ -0,0 +1,23 @@
1
+ import { BaseCommandBuilder } from './BaseCommandBuilder.js';
2
+ import type { FindFilesQuery } from '../tools/local_find_files/scheme.js';
3
+ export declare class FindCommandBuilder extends BaseCommandBuilder {
4
+ private isMacOS;
5
+ private isLinux;
6
+ private isWindows;
7
+ constructor();
8
+ fromQuery(query: Partial<FindFilesQuery> & Pick<FindFilesQuery, 'path'>): this;
9
+ private buildExcludeDirPrune;
10
+ private addFilters;
11
+ simple(path: string, name: string): this;
12
+ entryType(entryType: 'f' | 'd' | 'l'): this;
13
+ name(pattern: string): this;
14
+ maxDepth(depth: number): this;
15
+ minDepth(depth: number): this;
16
+ size(size: string): this;
17
+ mtime(time: string): this;
18
+ path(path: string): this;
19
+ private normalizeRegexForFullPath;
20
+ private parseTimeString;
21
+ private parseTimeStringAccess;
22
+ private normalizeSizeForPlatform;
23
+ }
@@ -0,0 +1,15 @@
1
+ import { BaseCommandBuilder } from './BaseCommandBuilder.js';
2
+ import type { ViewStructureQuery } from '../tools/local_view_structure/scheme.js';
3
+ export declare class LsCommandBuilder extends BaseCommandBuilder {
4
+ constructor();
5
+ fromQuery(query: Partial<ViewStructureQuery> & Pick<ViewStructureQuery, 'path'>): this;
6
+ simple(path: string): this;
7
+ detailed(): this;
8
+ all(): this;
9
+ humanReadable(): this;
10
+ recursive(): this;
11
+ sortBySize(): this;
12
+ sortByTime(): this;
13
+ reverse(): this;
14
+ path(path: string): this;
15
+ }
@@ -0,0 +1,27 @@
1
+ import { BaseCommandBuilder } from './BaseCommandBuilder.js';
2
+ import type { RipgrepQuery } from '../tools/local_ripgrep/scheme.js';
3
+ export declare class RipgrepCommandBuilder extends BaseCommandBuilder {
4
+ constructor();
5
+ simple(pattern: string, path: string): this;
6
+ filesOnly(): this;
7
+ context(lines: number): this;
8
+ include(pattern: string): this;
9
+ exclude(pattern: string): this;
10
+ excludeDir(dir: string): this;
11
+ type(fileType: string): this;
12
+ fixedString(): this;
13
+ perlRegex(): this;
14
+ maxMatches(count: number): this;
15
+ fromQuery(query: RipgrepQuery): this;
16
+ private _isPlainTextOutput;
17
+ private _applyMatchFlags;
18
+ private _applyContextFlags;
19
+ private _applyOutputModeFlags;
20
+ private _applyFilterFlags;
21
+ private _applyExecutionFlags;
22
+ private _applySortFlags;
23
+ private _applyDiagnosticFlags;
24
+ private _consolidateGlobs;
25
+ private clearSortOption;
26
+ private clearSortrOption;
27
+ }
@@ -0,0 +1,16 @@
1
+ export declare const GITHUB_SEARCH_DEFAULT_LIMIT = 30;
2
+ export declare const GITHUB_SEARCH_MAX_LIMIT = 100;
3
+ export declare const GITHUB_SEARCH_MAX_PAGES = 10;
4
+ export declare const GITHUB_STRUCTURE_DEFAULT_ENTRIES_PER_PAGE = 100;
5
+ export declare const GITHUB_STRUCTURE_MAX_ENTRIES_PER_PAGE = 200;
6
+ export declare const PR_CONTENT_DEFAULT_ITEMS_PER_PAGE = 20;
7
+ export declare const PR_CONTENT_MAX_ITEMS_PER_PAGE = 100;
8
+ export declare const LOCAL_DEFAULT_FILES_PER_PAGE = 20;
9
+ export declare const LOCAL_MAX_FILES_PER_PAGE = 50;
10
+ export declare const LOCAL_MAX_LIMIT = 10000;
11
+ export declare const LOCAL_MAX_DEPTH = 20;
12
+ export declare const MAX_PAGE_NUMBER = 1000;
13
+ export declare const MAX_CONTEXT_LINES = 100;
14
+ export declare const MAX_CHAR_LENGTH = 50000;
15
+ export declare const GITHUB_FILE_CONTENT_DEFAULT_CHAR_LENGTH = 8000;
16
+ export declare const MAX_MATCH_CONTENT_LENGTH = 100000;
@@ -0,0 +1,3 @@
1
+ export { buildDirectToolExampleQuery, DIRECT_TOOL_CATEGORIES, DIRECT_TOOL_DEFINITIONS, DirectToolInputError, executeDirectTool, findDirectToolDefinition, formatDirectToolMetadataSchemaText, formatDirectToolOutputSchemaText, formatDirectToolSchemaText, getDirectToolAutoFilledFields, getDirectToolCategory, getDirectToolDescription, getDirectToolDisplayFields, getDirectToolOutputFields, prepareDirectToolInput, prepareDirectToolInputFromJsonText, sortDirectToolNames, type DirectToolCategory, type DirectToolDefinition, type DirectToolDisplayField, type DirectToolInput, type DirectToolMetadata, type DirectToolOutputField, type PrepareDirectToolInputOptions, } from './tools/directToolCatalog.js';
2
+ export { loadToolContent } from './tools/toolMetadata/state.js';
3
+ export { formatCallToolResultForOutput, type CallToolResultOutputMode, } from './responses.js';