@octocodeai/octocode-core 4.2.0 → 16.1.0

package/dist/schemas/outputs.js

@@ -1 +1 @@
-import{z as t}from"zod";import{STATUS_VALUES as o}from"../types/index.js";export const ErrorDataSchema=t.object({id:t.string().optional(),error:t.string(),hints:t.array(t.string()).optional()});const n=t.object({currentPage:t.number(),totalPages:t.number(),hasMore:t.boolean(),perPage:t.number().optional(),totalMatches:t.number().optional(),totalFiles:t.number().optional(),totalEntries:t.number().optional(),totalResults:t.number().optional(),entriesPerPage:t.number().optional(),filesPerPage:t.number().optional(),matchesPerPage:t.number().optional()}),a=t.object({currentPage:t.number(),totalPages:t.number(),hasMore:t.boolean(),charOffset:t.number(),charLength:t.number(),totalChars:t.number()}),i=t.array(t.string()).optional(),r=t.array(t.union([t.string(),t.object({kind:t.string()}).passthrough()])).optional(),e=t.enum([...o]),s=t.object({line:t.number(),value:t.string().optional(),column:t.number().optional()}),p=t.object({path:t.string(),matchCount:t.number(),matches:t.array(s).optional(),modified:t.string().optional()});export const LocalSearchCodeOutputSchema=t.object({status:e.optional(),data:t.object({files:t.array(p),pagination:n.optional(),searchEngine:t.string().optional()}).optional(),files:t.array(p).optional(),pagination:n.optional(),searchEngine:t.string().optional(),hints:i,warnings:r,error:t.string().optional()}).passthrough();const l=t.object({path:t.string(),type:t.string().optional(),size:t.number().optional(),modified:t.string().optional(),permissions:t.string().optional()});export const LocalFindFilesOutputSchema=t.object({status:e.optional(),data:t.object({files:t.array(l),pagination:n.optional()}).optional(),files:t.array(l).optional(),pagination:n.optional(),hints:i,warnings:r,error:t.string().optional()}).passthrough();const g=t.object({path:t.string(),name:t.string(),type:t.string(),size:t.number().optional(),modified:t.string().optional()});export const LocalViewStructureOutputSchema=t.object({status:e.optional(),data:t.object({entries:t.array(g),summary:t.string().optional(),pagination:n.optional()}).optional(),entries:t.array(g).optional(),summary:t.string().optional(),pagination:n.optional(),hints:i,warnings:r,error:t.string().optional()}).passthrough();export const LocalGetFileContentOutputSchema=t.object({status:e.optional(),data:t.object({path:t.string(),content:t.string(),totalLines:t.number().optional(),startLine:t.number().optional(),endLine:t.number().optional(),isPartial:t.boolean().optional(),matchRanges:t.array(t.array(t.number())).optional(),pagination:a.optional(),lastModified:t.string().optional(),lastModifiedBy:t.string().optional()}).optional(),path:t.string().optional(),content:t.string().optional(),pagination:a.optional(),hints:i,warnings:r,error:t.string().optional()}).passthrough();const c=t.object({start:t.object({line:t.number(),character:t.number()}),end:t.object({line:t.number(),character:t.number()})}),u=t.object({uri:t.string(),range:c,content:t.string().optional()});export const LspGotoDefinitionOutputSchema=t.object({status:e.optional(),data:t.object({locations:t.array(u),lspMode:t.string().optional()}).optional(),locations:t.array(u).optional(),lspMode:t.string().optional(),hints:i,warnings:r,error:t.string().optional()}).passthrough();export const LspFindReferencesOutputSchema=t.object({status:e.optional(),data:t.object({locations:t.array(u),pagination:n.optional(),lspMode:t.string().optional()}).optional(),locations:t.array(u).optional(),pagination:n.optional(),lspMode:t.string().optional(),hints:i,warnings:r,error:t.string().optional()}).passthrough();export const LspCallHierarchyOutputSchema=t.object({status:e.optional(),data:t.object({item:t.object({name:t.string(),uri:t.string(),range:c,content:t.string().optional()}).optional(),incomingCalls:t.array(t.object({from:t.object({name:t.string(),uri:t.string(),range:c,content:t.string().optional()}).optional(),to:t.object({name:t.string(),uri:t.string(),range:c,content:t.string().optional()}).optional(),fromRanges:t.array(c).optional()}).passthrough()).optional(),outgoingCalls:t.array(t.object({from:t.object({name:t.string(),uri:t.string(),range:c,content:t.string().optional()}).optional(),to:t.object({name:t.string(),uri:t.string(),range:c,content:t.string().optional()}).optional(),fromRanges:t.array(c).optional()}).passthrough()).optional(),direction:t.string().optional(),depth:t.number().optional(),pagination:n.optional(),lspMode:t.string().optional()}).optional(),pagination:n.optional(),hints:i,warnings:r,error:t.string().optional()}).passthrough();const h=t.object({owner:t.string().optional(),repo:t.string().optional(),full_name:t.string().optional(),url:t.string().optional(),stars:t.number().optional(),language:t.string().optional(),pushed_at:t.string().optional(),description:t.string().optional(),topics:t.array(t.string()).optional(),license:t.string().optional()}).passthrough();export const GitHubSearchRepositoriesOutputSchema=t.object({status:e.optional(),data:t.object({repositories:t.array(h),pagination:n.optional()}).optional(),repositories:t.array(h).optional(),pagination:n.optional(),hints:i,warnings:r,error:t.string().optional()}).passthrough();const b=t.object({number:t.number(),title:t.string(),url:t.string().optional(),state:t.string().optional(),draft:t.boolean().optional(),merged:t.boolean().optional(),created_at:t.string().optional(),updated_at:t.string().optional(),closed_at:t.string().optional(),merged_at:t.string().optional(),author:t.string().optional(),head_ref:t.string().optional(),base_ref:t.string().optional()}).passthrough(),m=t.object({path:t.string(),value:t.string().optional()}).passthrough(),d=t.object({id:t.string(),owner:t.string(),repo:t.string(),matches:t.array(m)}).passthrough();export const GitHubSearchCodeOutputSchema=t.object({status:e.optional(),data:t.object({results:t.array(d),pagination:n.optional()}).optional(),results:t.array(d).optional(),pagination:n.optional(),hints:i,warnings:r,error:t.string().optional()}).passthrough();export const GitHubSearchPullRequestsOutputSchema=t.object({status:e.optional(),data:t.object({pull_requests:t.array(b),total_count:t.number().optional(),pagination:n.optional()}).optional(),pull_requests:t.array(b).optional(),pagination:n.optional(),hints:i,warnings:r,error:t.string().optional()}).passthrough();const j=t.object({path:t.string(),name:t.string().optional(),type:t.string().optional(),size:t.number().optional()}).passthrough();export const GitHubFileContentOutputSchema=t.object({status:e.optional(),data:t.object({path:t.string(),content:t.string(),totalLines:t.number().optional(),startLine:t.number().optional(),endLine:t.number().optional(),isPartial:t.boolean().optional(),resolvedBranch:t.string().optional(),pagination:a.optional(),lastModified:t.string().optional(),lastModifiedBy:t.string().optional()}).optional(),path:t.string().optional(),content:t.string().optional(),pagination:a.optional(),hints:i,warnings:r,error:t.string().optional()}).passthrough();export const GitHubViewRepoStructureOutputSchema=t.object({status:e.optional(),data:t.object({entries:t.array(j),pagination:n.optional()}).optional(),entries:t.array(j).optional(),pagination:n.optional(),hints:i,warnings:r,error:t.string().optional()}).passthrough();export const GitHubCloneRepoOutputSchema=t.object({status:e.optional(),data:t.object({localPath:t.string(),branch:t.string(),cached:t.boolean(),sparsePath:t.string().optional(),cloneTimeMs:t.number().optional(),totalSize:t.number().optional(),fileCount:t.number().optional()}).optional(),localPath:t.string().optional(),branch:t.string().optional(),cached:t.boolean().optional(),hints:i,warnings:r,error:t.string().optional()}).passthrough();const y=t.object({name:t.string(),version:t.string().optional(),repository:t.string().optional(),license:t.string().optional(),description:t.string().optional(),deprecated:t.union([t.boolean(),t.string()]).optional(),downloads:t.number().optional(),recentVersions:t.array(t.string()).optional()}).passthrough();export const PackageSearchOutputSchema=t.object({status:e.optional(),data:t.object({packages:t.array(y)}).optional(),packages:t.array(y).optional(),hints:i,warnings:r,error:t.string().optional()}).passthrough();
+import{z as t}from"zod";import{STATUS_VALUES as o}from"../types/index.js";export const ErrorDataSchema=t.object({id:t.string().optional(),error:t.string(),hints:t.array(t.string()).optional()});const n=t.object({currentPage:t.number(),totalPages:t.number(),hasMore:t.boolean(),perPage:t.number().optional(),totalMatches:t.number().optional(),totalFiles:t.number().optional(),totalEntries:t.number().optional(),totalResults:t.number().optional(),entriesPerPage:t.number().optional(),filesPerPage:t.number().optional(),matchesPerPage:t.number().optional()}),a=t.object({currentPage:t.number(),totalPages:t.number(),hasMore:t.boolean(),charOffset:t.number(),charLength:t.number(),totalChars:t.number()}),i=t.enum(["none","standard","symbols"]),r=t.array(t.string()).optional(),e=t.array(t.union([t.string(),t.object({kind:t.string()}).passthrough()])).optional(),s=t.enum([...o]),p=t.object({line:t.number(),value:t.string().optional(),column:t.number().optional()}),l=t.object({path:t.string(),matchCount:t.number(),matches:t.array(p).optional(),modified:t.string().optional()});export const LocalSearchCodeOutputSchema=t.object({status:s.optional(),data:t.object({files:t.array(l),pagination:n.optional(),searchEngine:t.string().optional()}).optional(),files:t.array(l).optional(),pagination:n.optional(),searchEngine:t.string().optional(),hints:r,warnings:e,error:t.string().optional()}).passthrough();const g=t.object({path:t.string(),type:t.string().optional(),size:t.number().optional(),modified:t.string().optional(),permissions:t.string().optional()});export const LocalFindFilesOutputSchema=t.object({status:s.optional(),data:t.object({files:t.array(g),pagination:n.optional()}).optional(),files:t.array(g).optional(),pagination:n.optional(),hints:r,warnings:e,error:t.string().optional()}).passthrough();const c=t.object({path:t.string(),name:t.string(),type:t.string(),size:t.number().optional(),modified:t.string().optional()});export const LocalViewStructureOutputSchema=t.object({status:s.optional(),data:t.object({path:t.string().optional(),files:t.array(t.string()).optional(),folders:t.array(t.string()).optional(),links:t.array(t.string()).optional(),entries:t.array(c).optional(),summary:t.string().optional(),pagination:n.optional()}).optional(),path:t.string().optional(),files:t.array(t.string()).optional(),folders:t.array(t.string()).optional(),links:t.array(t.string()).optional(),entries:t.array(c).optional(),summary:t.string().optional(),pagination:n.optional(),hints:r,warnings:e,error:t.string().optional()}).passthrough();export const LocalGetFileContentOutputSchema=t.object({status:s.optional(),data:t.object({path:t.string(),content:t.string(),contentView:i.optional(),isSkeleton:t.boolean().optional(),totalLines:t.number().optional(),startLine:t.number().optional(),endLine:t.number().optional(),isPartial:t.boolean().optional(),matchRanges:t.array(t.array(t.number())).optional(),pagination:a.optional(),lastModified:t.string().optional(),lastModifiedBy:t.string().optional()}).optional(),path:t.string().optional(),content:t.string().optional(),contentView:i.optional(),isSkeleton:t.boolean().optional(),pagination:a.optional(),hints:r,warnings:e,error:t.string().optional()}).passthrough();const u=t.object({start:t.object({line:t.number(),character:t.number()}),end:t.object({line:t.number(),character:t.number()})}),h=t.object({uri:t.string(),range:u,content:t.string().optional()});export const LspGotoDefinitionOutputSchema=t.object({status:s.optional(),data:t.object({locations:t.array(h),lspMode:t.string().optional()}).optional(),locations:t.array(h).optional(),lspMode:t.string().optional(),hints:r,warnings:e,error:t.string().optional()}).passthrough();export const LspFindReferencesOutputSchema=t.object({status:s.optional(),data:t.object({locations:t.array(h),pagination:n.optional(),lspMode:t.string().optional()}).optional(),locations:t.array(h).optional(),pagination:n.optional(),lspMode:t.string().optional(),hints:r,warnings:e,error:t.string().optional()}).passthrough();export const LspCallHierarchyOutputSchema=t.object({status:s.optional(),data:t.object({item:t.object({name:t.string(),uri:t.string(),range:u,content:t.string().optional()}).optional(),incomingCalls:t.array(t.object({from:t.object({name:t.string(),uri:t.string(),range:u,content:t.string().optional()}).optional(),to:t.object({name:t.string(),uri:t.string(),range:u,content:t.string().optional()}).optional(),fromRanges:t.array(u).optional()}).passthrough()).optional(),outgoingCalls:t.array(t.object({from:t.object({name:t.string(),uri:t.string(),range:u,content:t.string().optional()}).optional(),to:t.object({name:t.string(),uri:t.string(),range:u,content:t.string().optional()}).optional(),fromRanges:t.array(u).optional()}).passthrough()).optional(),direction:t.string().optional(),depth:t.number().optional(),pagination:n.optional(),lspMode:t.string().optional()}).optional(),pagination:n.optional(),hints:r,warnings:e,error:t.string().optional()}).passthrough();const b=t.object({owner:t.string().optional(),repo:t.string().optional(),full_name:t.string().optional(),url:t.string().optional(),stars:t.number().optional(),language:t.string().optional(),pushed_at:t.string().optional(),description:t.string().optional(),topics:t.array(t.string()).optional(),license:t.string().optional()}).passthrough();export const GitHubSearchRepositoriesOutputSchema=t.object({status:s.optional(),data:t.object({repositories:t.array(b),pagination:n.optional()}).optional(),repositories:t.array(b).optional(),pagination:n.optional(),hints:r,warnings:e,error:t.string().optional()}).passthrough();const m=t.object({number:t.number(),title:t.string(),url:t.string().optional(),state:t.string().optional(),draft:t.boolean().optional(),merged:t.boolean().optional(),created_at:t.string().optional(),updated_at:t.string().optional(),closed_at:t.string().optional(),merged_at:t.string().optional(),author:t.string().optional(),head_ref:t.string().optional(),base_ref:t.string().optional()}).passthrough(),d=t.object({path:t.string(),value:t.string().optional()}).passthrough(),j=t.object({id:t.string(),owner:t.string(),repo:t.string(),matches:t.array(d)}).passthrough();export const GitHubSearchCodeOutputSchema=t.object({status:s.optional(),data:t.object({results:t.array(j),pagination:n.optional()}).optional(),results:t.array(j).optional(),pagination:n.optional(),hints:r,warnings:e,error:t.string().optional()}).passthrough();export const GitHubSearchPullRequestsOutputSchema=t.object({status:s.optional(),data:t.object({pull_requests:t.array(m),total_count:t.number().optional(),pagination:n.optional()}).optional(),pull_requests:t.array(m).optional(),pagination:n.optional(),hints:r,warnings:e,error:t.string().optional()}).passthrough();const y=t.object({path:t.string(),name:t.string().optional(),type:t.string().optional(),size:t.number().optional()}).passthrough();export const GitHubFileContentOutputSchema=t.object({status:s.optional(),data:t.object({path:t.string(),content:t.string(),contentView:i.optional(),isSkeleton:t.boolean().optional(),totalLines:t.number().optional(),startLine:t.number().optional(),endLine:t.number().optional(),isPartial:t.boolean().optional(),resolvedBranch:t.string().optional(),pagination:a.optional(),lastModified:t.string().optional(),lastModifiedBy:t.string().optional()}).optional(),path:t.string().optional(),content:t.string().optional(),contentView:i.optional(),isSkeleton:t.boolean().optional(),pagination:a.optional(),hints:r,warnings:e,error:t.string().optional()}).passthrough();export const GitHubViewRepoStructureOutputSchema=t.object({status:s.optional(),data:t.object({entries:t.array(y),pagination:n.optional()}).optional(),entries:t.array(y).optional(),pagination:n.optional(),hints:r,warnings:e,error:t.string().optional()}).passthrough();export const GitHubCloneRepoOutputSchema=t.object({status:s.optional(),data:t.object({localPath:t.string(),branch:t.string(),cached:t.boolean(),sparsePath:t.string().optional(),cloneTimeMs:t.number().optional(),totalSize:t.number().optional(),fileCount:t.number().optional()}).optional(),localPath:t.string().optional(),branch:t.string().optional(),cached:t.boolean().optional(),hints:r,warnings:e,error:t.string().optional()}).passthrough();const f=t.object({name:t.string(),version:t.string().optional(),repository:t.string().optional(),license:t.string().optional(),description:t.string().optional(),deprecated:t.union([t.boolean(),t.string()]).optional(),downloads:t.number().optional(),recentVersions:t.array(t.string()).optional()}).passthrough();export const PackageSearchOutputSchema=t.object({status:s.optional(),data:t.object({packages:t.array(f)}).optional(),packages:t.array(f).optional(),hints:r,warnings:e,error:t.string().optional()}).passthrough();

package/dist/schemas/runtime.js

@@ -1 +1 @@
-export function validateRipgrepQuery(e){const t=[],n=[];return e&&"object"==typeof e?(e.pattern&&"string"==typeof e.pattern||t.push("`pattern` is required"),e.filesOnly&&e.filesWithoutMatch&&t.push("`filesOnly` and `filesWithoutMatch` are mutually exclusive"),e.count&&e.countMatches&&n.push("Both `count` and `countMatches` set — `countMatches` takes precedence"),e.fixedString&&e.perlRegex&&t.push("`fixedString` and `perlRegex` are mutually exclusive"),{isValid:0===t.length,errors:t,warnings:n}):(t.push("Query must be an object"),{isValid:!1,errors:t,warnings:n})}export function applyWorkflowMode(e){if(!e||"object"!=typeof e)return e;const t=e.mode;if(!t||"string"!=typeof t)return e;const n={...e};return"discovery"===t?void 0===n.filesOnly&&(n.filesOnly=!0):"detailed"===t&&void 0===n.contextLines&&(n.contextLines=3),n}
+export function validateRipgrepQuery(e){const i=[],t=[];return e&&"object"==typeof e?(e.keywords&&"string"==typeof e.keywords||i.push("`keywords` is required"),e.filesOnly&&e.filesWithoutMatch&&i.push("`filesOnly` and `filesWithoutMatch` are mutually exclusive"),e.countLinesPerFile&&e.countMatchesPerFile&&i.push("`countLinesPerFile` and `countMatchesPerFile` are mutually exclusive"),e.fixedString&&e.perlRegex&&i.push("`fixedString` and `perlRegex` are mutually exclusive"),e.caseSensitive&&e.caseInsensitive&&i.push("`caseSensitive` and `caseInsensitive` are mutually exclusive"),e.multilineDotall&&!e.multiline&&i.push("`multilineDotall` requires `multiline=true`"),{isValid:0===i.length,errors:i,warnings:t}):(i.push("Query must be an object"),{isValid:!1,errors:i,warnings:t})}export function applyWorkflowMode(e){if(!e||"object"!=typeof e)return e;const i=e.mode;if(!i||"string"!=typeof i)return e;const t={...e};return"discovery"===i?void 0===t.filesOnly&&(t.filesOnly=!0):"detailed"===i&&void 0===t.contextLines&&(t.contextLines=3),t}

package/dist/types/index.d.ts

@@ -15,9 +15,7 @@ export interface ToolNames {
     LOCAL_FETCH_CONTENT: "localGetFileContent";
     LOCAL_FIND_FILES: "localFindFiles";
     LOCAL_VIEW_STRUCTURE: "localViewStructure";
-    LSP_GOTO_DEFINITION: "lspGotoDefinition";
-    LSP_FIND_REFERENCES: "lspFindReferences";
-    LSP_CALL_HIERARCHY: "lspCallHierarchy";
+    LSP_GET_SEMANTIC_CONTENT: "lspGetSemanticContent";
 }
 export interface ToolHints {
     readonly empty: readonly string[];
@@ -110,6 +108,13 @@ export interface CharPagination {
     readonly charOffset: number;
     readonly charLength: number;
     readonly totalChars: number;
+    /** How the page boundary was chosen.
+     *  `'semantic'`   — snapped to a tree-sitter/heuristic block boundary.
+     *  `'char-limit'` — fixed char-size cut; may end mid-block (see nextBlockChar). */
+    readonly chunkMode?: "semantic" | "char-limit";
+    /** Set when `chunkMode` is `'char-limit'` and the cut is mid-block.
+     *  Char offset of the next top-level block start; extend charLength to reach it. */
+    readonly nextBlockChar?: number;
 }
 /** LSP semantic vs. fallback mode marker. */
 export declare enum LspMode {
@@ -137,6 +142,7 @@ export interface ToolResultEnvelope<TData> {
     readonly warnings?: readonly ToolWarning[];
     readonly error?: string;
 }
+export type ContentView = "none" | "standard" | "symbols";
 /** Per-file match pagination — for paging matches *within* a single file. */
 export interface LocalSearchCodeMatchPagination {
     readonly currentPage: number;
@@ -152,8 +158,10 @@ export interface LocalSearchCodeMatch {
 }
 export interface LocalSearchCodeFile {
     path: string;
-    matchCount: number;
-    matches: LocalSearchCodeMatch[];
+    /** Omitted in filesOnly/discovery mode — rg -l reports no per-file counts. */
+    matchCount?: number;
+    /** Omitted in discovery/filesOnly mode — empty arrays are noise. */
+    matches?: LocalSearchCodeMatch[];
     modified?: string;
     pagination?: LocalSearchCodeMatchPagination;
 }
@@ -179,6 +187,8 @@ export interface LocalFindFilesData {
 export interface LocalGetFileContentData {
     readonly path: string;
     readonly content: string;
+    readonly contentView?: ContentView;
+    readonly isSkeleton?: boolean;
     readonly totalLines?: number;
     readonly startLine?: number;
     readonly endLine?: number;
@@ -268,6 +278,8 @@ export interface GitHubSearchCodeData {
 export interface GitHubFileContentData {
     readonly path: string;
     readonly content: string;
+    readonly contentView?: ContentView;
+    readonly isSkeleton?: boolean;
     readonly totalLines?: number;
     readonly startLine?: number;
     readonly endLine?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octocodeai/octocode-core",
-  "version": "4.2.0",
+  "version": "16.1.0",
   "description": "Core config, prompts, tools, and schemas for Octocode MCP",
   "type": "module",
   "main": "dist/index.js",
@@ -43,6 +43,7 @@
   },
   "scripts": {
     "generate": "tsx src/octocode-scripts/generateDefaultJson.ts",
+    "dump:agent-context": "tsx src/octocode-scripts/dumpAgentContext.ts",
     "compress": "yarn generate && node scripts/compress-config.mjs",
     "build": "rm -rf dist && yarn generate && node scripts/compress-config.mjs && tsc && node scripts/minify-dist.mjs",
     "lint": "eslint src/**/*.ts",