@octocodeai/octocode-core 16.3.0 → 16.5.0

package/dist/schemas/outputs.js

@@ -0,0 +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.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(),count:t.number().optional(),kind:t.string().optional(),scoreHint: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 NpmSearchOutputSchema=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.d.ts

@@ -0,0 +1,11 @@
+import type { z } from "zod";
+import { RipgrepQuerySchema } from "../schemas.js";
+type RuntimeRipgrepQuery = z.infer<typeof RipgrepQuerySchema>;
+export interface RipgrepValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export declare function validateRipgrepQuery(query: RuntimeRipgrepQuery): RipgrepValidationResult;
+export declare function applyWorkflowMode<T extends RuntimeRipgrepQuery>(query: T): T;
+export {};

package/dist/schemas/runtime.js

@@ -0,0 +1 @@
+export function validateRipgrepQuery(e){const i=[],t=[];return e&&"object"==typeof e?("structural"===e.mode||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`"),void 0===e.matchWindow||e.onlyMatching||i.push("`matchWindow` requires `onlyMatching:true`"),e.unique&&!e.onlyMatching&&i.push("`unique` requires `onlyMatching:true`"),e.countUnique&&!e.onlyMatching&&i.push("`countUnique` requires `onlyMatching: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/schemas.d.ts

@@ -0,0 +1,514 @@
+import type { z } from "zod";
+import { GitHubCodeSearchQuerySchema } from "./resources/tools/ghSearchCode.js";
+import { FileContentQuerySchema } from "./resources/tools/ghGetFileContent.js";
+import { GitHubViewRepoStructureQuerySchema } from "./resources/tools/ghViewRepoStructure.js";
+import { GitHubReposSearchSingleQuerySchema } from "./resources/tools/ghSearchRepos.js";
+import { GitHubPullRequestSearchQuerySchema } from "./resources/tools/ghHistoryResearch.js";
+import { NpmPackageQuerySchema } from "./resources/tools/npmSearch.js";
+import { CloneRepoQuerySchema, BulkCloneRepoSchema } from "./resources/tools/ghCloneRepo.js";
+import { RipgrepQuerySchema } from "./resources/tools/localSearchCode.js";
+import { ViewStructureQuerySchema } from "./resources/tools/localViewStructure.js";
+import { FindFilesQuerySchema } from "./resources/tools/localFindFiles.js";
+import { FetchContentQuerySchema } from "./resources/tools/localGetFileContent.js";
+import { LspGetSemanticsQuerySchema, LSPGotoDefinitionQuerySchema, LSPFindReferencesQuerySchema, LSPCallHierarchyQuerySchema } from "./resources/tools/lspGetSemantics.js";
+import { LocalBinaryInspectQuerySchema } from "./resources/tools/localBinaryInspect.js";
+export { baseSchema, baseSchemaDescriptions, toolNames, } from "./resources/global.js";
+export type { BaseSchemaShape } from "./resources/global.js";
+export { MAX_CONTEXT_LINES, MAX_PAGE_NUMBER, MAX_CHAR_OFFSET, MAX_CHAR_LENGTH, MAX_LINE_NUMBER, MAX_ORDER_HINT, MAX_LOCAL_DEPTH, MAX_FIND_DEPTH, MAX_LOCAL_LIMIT, MAX_LOCAL_ITEMS_PER_PAGE, MAX_GITHUB_SEARCH_LIMIT, DEFAULT_GITHUB_SEARCH_LIMIT, MAX_GITHUB_STRUCTURE_ITEMS_PER_PAGE, DEFAULT_GITHUB_STRUCTURE_ITEMS_PER_PAGE, MAX_PR_ITEMS_PER_PAGE, DEFAULT_PR_ITEMS_PER_PAGE, MAX_MATCH_CONTENT_LENGTH, DEFAULT_MATCH_CONTENT_LENGTH, MAX_MATCH_COUNT, MAX_SEARCH_ITEMS_PER_PAGE, MAX_LSP_DEPTH, MAX_LSP_ITEMS_PER_PAGE, MAX_GITHUB_STRUCTURE_DEPTH, MAX_BINARY_ENTRIES, DEFAULT_BINARY_ENTRIES, MAX_BINARY_ENTRIES_PER_PAGE, MAX_BINARY_CONTEXT_LINES, DEFAULT_BINARY_CONTEXT_LINES, MAX_STRINGS_MIN_LENGTH, DEFAULT_STRINGS_MIN_LENGTH, } from "./resources/tools/_toolkit.js";
+export { GitHubCodeSearchQuerySchema, FileContentQuerySchema, GitHubViewRepoStructureQuerySchema, GitHubReposSearchSingleQuerySchema, GitHubPullRequestSearchQuerySchema, NpmPackageQuerySchema, CloneRepoQuerySchema, BulkCloneRepoSchema, RipgrepQuerySchema, ViewStructureQuerySchema, FindFilesQuerySchema, FetchContentQuerySchema, LspGetSemanticsQuerySchema, LSPGotoDefinitionQuerySchema, LSPFindReferencesQuerySchema, LSPCallHierarchyQuerySchema, LocalBinaryInspectQuerySchema, };
+export declare const toolSchemas: {
+    readonly ghSearchCode: z.ZodObject<{
+        keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        owner: z.ZodOptional<z.ZodString>;
+        repo: z.ZodOptional<z.ZodString>;
+        extension: z.ZodOptional<z.ZodString>;
+        filename: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        language: z.ZodOptional<z.ZodString>;
+        match: z.ZodDefault<z.ZodEnum<{
+            file: "file";
+            path: "path";
+        }>>;
+        limit: z.ZodDefault<z.ZodNumber>;
+        page: z.ZodDefault<z.ZodNumber>;
+        concise: z.ZodOptional<z.ZodBoolean>;
+        id: z.ZodOptional<z.ZodString>;
+        mainResearchGoal: z.ZodOptional<z.ZodString>;
+        researchGoal: z.ZodOptional<z.ZodString>;
+        reasoning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly ghGetFileContent: z.ZodObject<{
+        owner: z.ZodString;
+        repo: z.ZodString;
+        branch: z.ZodOptional<z.ZodString>;
+        path: z.ZodString;
+        startLine: z.ZodOptional<z.ZodNumber>;
+        endLine: z.ZodOptional<z.ZodNumber>;
+        fullContent: z.ZodOptional<z.ZodBoolean>;
+        matchString: z.ZodOptional<z.ZodString>;
+        matchStringIsRegex: z.ZodOptional<z.ZodBoolean>;
+        matchStringCaseSensitive: z.ZodOptional<z.ZodBoolean>;
+        forceRefresh: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodDefault<z.ZodEnum<{
+            file: "file";
+            directory: "directory";
+        }>>;
+        contextLines: z.ZodDefault<z.ZodNumber>;
+        charOffset: z.ZodOptional<z.ZodNumber>;
+        charLength: z.ZodOptional<z.ZodNumber>;
+        minify: z.ZodDefault<z.ZodEnum<{
+            none: "none";
+            standard: "standard";
+            symbols: "symbols";
+        }>>;
+        id: z.ZodOptional<z.ZodString>;
+        mainResearchGoal: z.ZodOptional<z.ZodString>;
+        researchGoal: z.ZodOptional<z.ZodString>;
+        reasoning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly ghViewRepoStructure: z.ZodObject<{
+        owner: z.ZodString;
+        repo: z.ZodString;
+        branch: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        maxDepth: z.ZodOptional<z.ZodNumber>;
+        page: z.ZodDefault<z.ZodNumber>;
+        itemsPerPage: z.ZodDefault<z.ZodNumber>;
+        includeSizes: z.ZodOptional<z.ZodBoolean>;
+        id: z.ZodOptional<z.ZodString>;
+        mainResearchGoal: z.ZodOptional<z.ZodString>;
+        researchGoal: z.ZodOptional<z.ZodString>;
+        reasoning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly ghSearchRepos: z.ZodObject<{
+        keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        topicsToSearch: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        language: z.ZodOptional<z.ZodString>;
+        owner: z.ZodOptional<z.ZodString>;
+        stars: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodString>;
+        created: z.ZodOptional<z.ZodString>;
+        updated: z.ZodOptional<z.ZodString>;
+        match: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            description: "description";
+            name: "name";
+            readme: "readme";
+        }>>>;
+        sort: z.ZodDefault<z.ZodEnum<{
+            stars: "stars";
+            updated: "updated";
+            forks: "forks";
+            "help-wanted-issues": "help-wanted-issues";
+            "best-match": "best-match";
+        }>>;
+        limit: z.ZodDefault<z.ZodNumber>;
+        page: z.ZodDefault<z.ZodNumber>;
+        archived: z.ZodOptional<z.ZodBoolean>;
+        visibility: z.ZodOptional<z.ZodEnum<{
+            public: "public";
+            private: "private";
+        }>>;
+        forks: z.ZodOptional<z.ZodString>;
+        license: z.ZodOptional<z.ZodString>;
+        goodFirstIssues: z.ZodOptional<z.ZodString>;
+        concise: z.ZodOptional<z.ZodBoolean>;
+        id: z.ZodOptional<z.ZodString>;
+        mainResearchGoal: z.ZodOptional<z.ZodString>;
+        researchGoal: z.ZodOptional<z.ZodString>;
+        reasoning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly ghHistoryResearch: z.ZodObject<{
+        type: z.ZodDefault<z.ZodEnum<{
+            prs: "prs";
+            commits: "commits";
+        }>>;
+        since: z.ZodOptional<z.ZodString>;
+        until: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        branch: z.ZodOptional<z.ZodString>;
+        perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        includeDiff: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        keywordsToSearch: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        query: z.ZodOptional<z.ZodString>;
+        prNumber: z.ZodOptional<z.ZodNumber>;
+        owner: z.ZodOptional<z.ZodString>;
+        repo: z.ZodOptional<z.ZodString>;
+        concise: z.ZodOptional<z.ZodBoolean>;
+        state: z.ZodOptional<z.ZodEnum<{
+            open: "open";
+            closed: "closed";
+            merged: "merged";
+        }>>;
+        assignee: z.ZodOptional<z.ZodString>;
+        author: z.ZodOptional<z.ZodString>;
+        commenter: z.ZodOptional<z.ZodString>;
+        involves: z.ZodOptional<z.ZodString>;
+        mentions: z.ZodOptional<z.ZodString>;
+        "review-requested": z.ZodOptional<z.ZodString>;
+        "reviewed-by": z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+        milestone: z.ZodOptional<z.ZodString>;
+        language: z.ZodOptional<z.ZodString>;
+        checks: z.ZodOptional<z.ZodEnum<{
+            success: "success";
+            failure: "failure";
+            pending: "pending";
+        }>>;
+        review: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            approved: "approved";
+            changes_requested: "changes_requested";
+            required: "required";
+        }>>;
+        locked: z.ZodOptional<z.ZodBoolean>;
+        visibility: z.ZodOptional<z.ZodEnum<{
+            public: "public";
+            private: "private";
+        }>>;
+        "team-mentions": z.ZodOptional<z.ZodString>;
+        project: z.ZodOptional<z.ZodString>;
+        "no-label": z.ZodOptional<z.ZodBoolean>;
+        "no-milestone": z.ZodOptional<z.ZodBoolean>;
+        "no-project": z.ZodOptional<z.ZodBoolean>;
+        "no-assignee": z.ZodOptional<z.ZodBoolean>;
+        head: z.ZodOptional<z.ZodString>;
+        base: z.ZodOptional<z.ZodString>;
+        created: z.ZodOptional<z.ZodString>;
+        updated: z.ZodOptional<z.ZodString>;
+        closed: z.ZodOptional<z.ZodString>;
+        "merged-at": z.ZodOptional<z.ZodString>;
+        comments: z.ZodOptional<z.ZodString>;
+        reactions: z.ZodOptional<z.ZodString>;
+        interactions: z.ZodOptional<z.ZodString>;
+        draft: z.ZodOptional<z.ZodBoolean>;
+        match: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            comments: "comments";
+            title: "title";
+            body: "body";
+        }>>>;
+        sort: z.ZodOptional<z.ZodEnum<{
+            created: "created";
+            updated: "updated";
+            "best-match": "best-match";
+            comments: "comments";
+            reactions: "reactions";
+        }>>;
+        order: z.ZodOptional<z.ZodEnum<{
+            asc: "asc";
+            desc: "desc";
+        }>>;
+        limit: z.ZodDefault<z.ZodNumber>;
+        page: z.ZodDefault<z.ZodNumber>;
+        archived: z.ZodOptional<z.ZodBoolean>;
+        filePage: z.ZodOptional<z.ZodNumber>;
+        commentPage: z.ZodOptional<z.ZodNumber>;
+        commitPage: z.ZodOptional<z.ZodNumber>;
+        itemsPerPage: z.ZodDefault<z.ZodNumber>;
+        reviewMode: z.ZodOptional<z.ZodLiteral<"full">>;
+        content: z.ZodOptional<z.ZodObject<{
+            metadata: z.ZodOptional<z.ZodBoolean>;
+            body: z.ZodOptional<z.ZodBoolean>;
+            changedFiles: z.ZodOptional<z.ZodBoolean>;
+            patches: z.ZodOptional<z.ZodObject<{
+                mode: z.ZodDefault<z.ZodEnum<{
+                    none: "none";
+                    selected: "selected";
+                    all: "all";
+                }>>;
+                files: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                ranges: 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>>>;
+            }, z.core.$strip>>;
+            comments: z.ZodOptional<z.ZodObject<{
+                discussion: z.ZodOptional<z.ZodBoolean>;
+                reviewInline: z.ZodOptional<z.ZodBoolean>;
+                includeBots: z.ZodDefault<z.ZodBoolean>;
+                file: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            reviews: z.ZodOptional<z.ZodBoolean>;
+            commits: z.ZodOptional<z.ZodObject<{
+                list: z.ZodOptional<z.ZodBoolean>;
+                includeFiles: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        matchString: z.ZodOptional<z.ZodString>;
+        commentBodyOffset: z.ZodOptional<z.ZodNumber>;
+        charOffset: z.ZodOptional<z.ZodNumber>;
+        charLength: z.ZodOptional<z.ZodNumber>;
+        minify: z.ZodDefault<z.ZodEnum<{
+            none: "none";
+            standard: "standard";
+        }>>;
+        id: z.ZodOptional<z.ZodString>;
+        mainResearchGoal: z.ZodOptional<z.ZodString>;
+        researchGoal: z.ZodOptional<z.ZodString>;
+        reasoning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly npmSearch: z.ZodObject<{
+        packageName: z.ZodString;
+        page: z.ZodDefault<z.ZodNumber>;
+        id: z.ZodOptional<z.ZodString>;
+        mainResearchGoal: z.ZodOptional<z.ZodString>;
+        researchGoal: z.ZodOptional<z.ZodString>;
+        reasoning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly ghCloneRepo: z.ZodObject<{
+        owner: z.ZodString;
+        repo: z.ZodString;
+        branch: z.ZodOptional<z.ZodString>;
+        sparsePath: z.ZodOptional<z.ZodString>;
+        forceRefresh: z.ZodOptional<z.ZodBoolean>;
+        id: z.ZodOptional<z.ZodString>;
+        mainResearchGoal: z.ZodOptional<z.ZodString>;
+        researchGoal: z.ZodOptional<z.ZodString>;
+        reasoning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly localSearchCode: z.ZodObject<{
+        keywords: z.ZodOptional<z.ZodString>;
+        path: z.ZodString;
+        mode: z.ZodDefault<z.ZodEnum<{
+            paginated: "paginated";
+            discovery: "discovery";
+            detailed: "detailed";
+            structural: "structural";
+        }>>;
+        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>;
+        wholeWord: z.ZodOptional<z.ZodBoolean>;
+        invertMatch: z.ZodOptional<z.ZodBoolean>;
+        include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        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>;
+        sort: z.ZodDefault<z.ZodEnum<{
+            path: "path";
+            created: "created";
+            relevance: "relevance";
+            matchCount: "matchCount";
+            modified: "modified";
+            accessed: "accessed";
+        }>>;
+        sortReverse: z.ZodOptional<z.ZodBoolean>;
+        rankingProfile: z.ZodDefault<z.ZodEnum<{
+            auto: "auto";
+            typescript: "typescript";
+            javascript: "javascript";
+            rust: "rust";
+            python: "python";
+            go: "go";
+            java: "java";
+            scala: "scala";
+            markdown: "markdown";
+            json: "json";
+            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>;
+        matchWindow: z.ZodOptional<z.ZodNumber>;
+        matchPage: z.ZodOptional<z.ZodNumber>;
+        itemsPerPage: z.ZodOptional<z.ZodNumber>;
+        page: z.ZodDefault<z.ZodNumber>;
+        id: z.ZodOptional<z.ZodString>;
+        mainResearchGoal: z.ZodOptional<z.ZodString>;
+        researchGoal: z.ZodOptional<z.ZodString>;
+        reasoning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly localViewStructure: z.ZodObject<{
+        path: z.ZodString;
+        details: z.ZodOptional<z.ZodBoolean>;
+        hidden: z.ZodOptional<z.ZodBoolean>;
+        sortBy: z.ZodDefault<z.ZodEnum<{
+            extension: "extension";
+            size: "size";
+            name: "name";
+            time: "time";
+        }>>;
+        reverse: z.ZodOptional<z.ZodBoolean>;
+        pattern: z.ZodOptional<z.ZodString>;
+        directoriesOnly: z.ZodOptional<z.ZodBoolean>;
+        filesOnly: z.ZodOptional<z.ZodBoolean>;
+        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>;
+        mainResearchGoal: z.ZodOptional<z.ZodString>;
+        researchGoal: z.ZodOptional<z.ZodString>;
+        reasoning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly localFindFiles: z.ZodObject<{
+        path: z.ZodString;
+        maxDepth: z.ZodOptional<z.ZodNumber>;
+        minDepth: z.ZodOptional<z.ZodNumber>;
+        names: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        pathPattern: z.ZodOptional<z.ZodString>;
+        regex: z.ZodOptional<z.ZodString>;
+        empty: z.ZodOptional<z.ZodBoolean>;
+        modifiedWithin: z.ZodOptional<z.ZodString>;
+        modifiedBefore: z.ZodOptional<z.ZodString>;
+        accessedWithin: z.ZodOptional<z.ZodString>;
+        sizeGreater: z.ZodOptional<z.ZodString>;
+        sizeLess: z.ZodOptional<z.ZodString>;
+        permissions: z.ZodOptional<z.ZodString>;
+        executable: z.ZodOptional<z.ZodBoolean>;
+        readable: z.ZodOptional<z.ZodBoolean>;
+        writable: z.ZodOptional<z.ZodBoolean>;
+        excludeDir: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        details: z.ZodOptional<z.ZodBoolean>;
+        showFileLastModified: z.ZodOptional<z.ZodBoolean>;
+        sortBy: z.ZodDefault<z.ZodEnum<{
+            path: "path";
+            size: "size";
+            name: "name";
+            modified: "modified";
+        }>>;
+        entryType: z.ZodOptional<z.ZodEnum<{
+            f: "f";
+            d: "d";
+        }>>;
+        page: z.ZodDefault<z.ZodNumber>;
+        itemsPerPage: z.ZodOptional<z.ZodNumber>;
+        id: z.ZodOptional<z.ZodString>;
+        mainResearchGoal: z.ZodOptional<z.ZodString>;
+        researchGoal: z.ZodOptional<z.ZodString>;
+        reasoning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly localGetFileContent: z.ZodObject<{
+        path: z.ZodString;
+        fullContent: z.ZodOptional<z.ZodBoolean>;
+        matchString: z.ZodOptional<z.ZodString>;
+        matchStringIsRegex: z.ZodOptional<z.ZodBoolean>;
+        matchStringCaseSensitive: z.ZodOptional<z.ZodBoolean>;
+        startLine: z.ZodOptional<z.ZodNumber>;
+        endLine: z.ZodOptional<z.ZodNumber>;
+        contextLines: z.ZodDefault<z.ZodNumber>;
+        charOffset: z.ZodOptional<z.ZodNumber>;
+        charLength: z.ZodOptional<z.ZodNumber>;
+        minify: z.ZodDefault<z.ZodEnum<{
+            none: "none";
+            standard: "standard";
+            symbols: "symbols";
+        }>>;
+        id: z.ZodOptional<z.ZodString>;
+        mainResearchGoal: z.ZodOptional<z.ZodString>;
+        researchGoal: z.ZodOptional<z.ZodString>;
+        reasoning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly lspGetSemantics: z.ZodObject<{
+        uri: z.ZodString;
+        type: z.ZodDefault<z.ZodEnum<{
+            definition: "definition";
+            references: "references";
+            callers: "callers";
+            callees: "callees";
+            callHierarchy: "callHierarchy";
+            hover: "hover";
+            documentSymbols: "documentSymbols";
+            typeDefinition: "typeDefinition";
+            implementation: "implementation";
+        }>>;
+        symbolName: z.ZodOptional<z.ZodString>;
+        lineHint: z.ZodOptional<z.ZodNumber>;
+        orderHint: z.ZodDefault<z.ZodNumber>;
+        depth: z.ZodOptional<z.ZodNumber>;
+        includeDeclaration: z.ZodDefault<z.ZodBoolean>;
+        groupByFile: z.ZodOptional<z.ZodBoolean>;
+        page: z.ZodDefault<z.ZodNumber>;
+        itemsPerPage: z.ZodOptional<z.ZodNumber>;
+        contextLines: z.ZodOptional<z.ZodNumber>;
+        format: z.ZodDefault<z.ZodEnum<{
+            structured: "structured";
+            compact: "compact";
+        }>>;
+        workspaceRoot: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+        mainResearchGoal: z.ZodOptional<z.ZodString>;
+        researchGoal: z.ZodOptional<z.ZodString>;
+        reasoning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly localBinaryInspect: z.ZodObject<{
+        path: z.ZodString;
+        mode: z.ZodEnum<{
+            list: "list";
+            inspect: "inspect";
+            extract: "extract";
+            decompress: "decompress";
+            strings: "strings";
+            unpack: "unpack";
+        }>;
+        detailed: z.ZodOptional<z.ZodBoolean>;
+        verbose: z.ZodOptional<z.ZodBoolean>;
+        maxEntries: z.ZodDefault<z.ZodNumber>;
+        entriesPerPage: z.ZodOptional<z.ZodNumber>;
+        entryPageNumber: z.ZodDefault<z.ZodNumber>;
+        archiveFile: z.ZodOptional<z.ZodString>;
+        matchString: z.ZodOptional<z.ZodString>;
+        matchStringContextLines: z.ZodDefault<z.ZodNumber>;
+        charOffset: z.ZodOptional<z.ZodNumber>;
+        charLength: z.ZodOptional<z.ZodNumber>;
+        format: z.ZodDefault<z.ZodEnum<{
+            auto: "auto";
+            gzip: "gzip";
+            bzip2: "bzip2";
+            xz: "xz";
+            lzma: "lzma";
+            zstd: "zstd";
+            lz4: "lz4";
+            brotli: "brotli";
+            lzfse: "lzfse";
+        }>>;
+        minLength: z.ZodDefault<z.ZodNumber>;
+        includeOffsets: z.ZodOptional<z.ZodBoolean>;
+        scanOffset: z.ZodOptional<z.ZodNumber>;
+        id: z.ZodOptional<z.ZodString>;
+        mainResearchGoal: z.ZodOptional<z.ZodString>;
+        researchGoal: z.ZodOptional<z.ZodString>;
+        reasoning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+};
+/** Look up the Zod query schema for a canonical tool name. */
+export declare function findToolSchema(name: string): z.ZodTypeAny | undefined;
+export type GitHubCodeSearchQuery = z.infer<typeof GitHubCodeSearchQuerySchema>;
+export type FileContentQuery = z.infer<typeof FileContentQuerySchema>;
+export type GitHubViewRepoStructureQuery = z.infer<typeof GitHubViewRepoStructureQuerySchema>;
+export type GitHubReposSearchSingleQuery = z.infer<typeof GitHubReposSearchSingleQuerySchema>;
+export type GitHubPullRequestSearchQuery = z.infer<typeof GitHubPullRequestSearchQuerySchema>;
+export type NpmPackageQuery = z.infer<typeof NpmPackageQuerySchema>;
+export type CloneRepoQuery = z.infer<typeof CloneRepoQuerySchema>;
+export type BulkCloneRepoQuery = z.infer<typeof BulkCloneRepoSchema>;
+export type RipgrepQuery = z.infer<typeof RipgrepQuerySchema>;
+export type ViewStructureQuery = z.infer<typeof ViewStructureQuerySchema>;
+export type FindFilesQuery = z.infer<typeof FindFilesQuerySchema>;
+export type FetchContentQuery = z.infer<typeof FetchContentQuerySchema>;
+export type LspGetSemanticsQuery = z.infer<typeof LspGetSemanticsQuerySchema>;
+export type LSPGotoDefinitionQuery = z.infer<typeof LSPGotoDefinitionQuerySchema>;
+export type LSPFindReferencesQuery = z.infer<typeof LSPFindReferencesQuerySchema>;
+export type LSPCallHierarchyQuery = z.infer<typeof LSPCallHierarchyQuerySchema>;
+export type LocalBinaryInspectQuery = z.infer<typeof LocalBinaryInspectQuerySchema>;

package/dist/schemas.js

@@ -0,0 +1 @@
+import{GitHubCodeSearchQuerySchema as o}from"./resources/tools/ghSearchCode.js";import{FileContentQuerySchema as e}from"./resources/tools/ghGetFileContent.js";import{GitHubViewRepoStructureQuerySchema as r}from"./resources/tools/ghViewRepoStructure.js";import{GitHubReposSearchSingleQuerySchema as _}from"./resources/tools/ghSearchRepos.js";import{GitHubPullRequestSearchQuerySchema as s}from"./resources/tools/ghHistoryResearch.js";import{NpmPackageQuerySchema as t}from"./resources/tools/npmSearch.js";import{CloneRepoQuerySchema as E,BulkCloneRepoSchema as T}from"./resources/tools/ghCloneRepo.js";import{RipgrepQuerySchema as A}from"./resources/tools/localSearchCode.js";import{ViewStructureQuerySchema as c}from"./resources/tools/localViewStructure.js";import{FindFilesQuerySchema as l}from"./resources/tools/localFindFiles.js";import{FetchContentQuerySchema as S}from"./resources/tools/localGetFileContent.js";import{LspGetSemanticsQuerySchema as R,LSPGotoDefinitionQuerySchema as M,LSPFindReferencesQuerySchema as m,LSPCallHierarchyQuerySchema as I}from"./resources/tools/lspGetSemantics.js";import{LocalBinaryInspectQuerySchema as i}from"./resources/tools/localBinaryInspect.js";export{baseSchema,baseSchemaDescriptions,toolNames}from"./resources/global.js";export{MAX_CONTEXT_LINES,MAX_PAGE_NUMBER,MAX_CHAR_OFFSET,MAX_CHAR_LENGTH,MAX_LINE_NUMBER,MAX_ORDER_HINT,MAX_LOCAL_DEPTH,MAX_FIND_DEPTH,MAX_LOCAL_LIMIT,MAX_LOCAL_ITEMS_PER_PAGE,MAX_GITHUB_SEARCH_LIMIT,DEFAULT_GITHUB_SEARCH_LIMIT,MAX_GITHUB_STRUCTURE_ITEMS_PER_PAGE,DEFAULT_GITHUB_STRUCTURE_ITEMS_PER_PAGE,MAX_PR_ITEMS_PER_PAGE,DEFAULT_PR_ITEMS_PER_PAGE,MAX_MATCH_CONTENT_LENGTH,DEFAULT_MATCH_CONTENT_LENGTH,MAX_MATCH_COUNT,MAX_SEARCH_ITEMS_PER_PAGE,MAX_LSP_DEPTH,MAX_LSP_ITEMS_PER_PAGE,MAX_GITHUB_STRUCTURE_DEPTH,MAX_BINARY_ENTRIES,DEFAULT_BINARY_ENTRIES,MAX_BINARY_ENTRIES_PER_PAGE,MAX_BINARY_CONTEXT_LINES,DEFAULT_BINARY_CONTEXT_LINES,MAX_STRINGS_MIN_LENGTH,DEFAULT_STRINGS_MIN_LENGTH}from"./resources/tools/_toolkit.js";export{o as GitHubCodeSearchQuerySchema,e as FileContentQuerySchema,r as GitHubViewRepoStructureQuerySchema,_ as GitHubReposSearchSingleQuerySchema,s as GitHubPullRequestSearchQuerySchema,t as NpmPackageQuerySchema,E as CloneRepoQuerySchema,T as BulkCloneRepoSchema,A as RipgrepQuerySchema,c as ViewStructureQuerySchema,l as FindFilesQuerySchema,S as FetchContentQuerySchema,R as LspGetSemanticsQuerySchema,M as LSPGotoDefinitionQuerySchema,m as LSPFindReferencesQuerySchema,I as LSPCallHierarchyQuerySchema,i as LocalBinaryInspectQuerySchema};export const toolSchemas={ghSearchCode:o,ghGetFileContent:e,ghViewRepoStructure:r,ghSearchRepos:_,ghHistoryResearch:s,npmSearch:t,ghCloneRepo:E,localSearchCode:A,localViewStructure:c,localFindFiles:l,localGetFileContent:S,lspGetSemantics:R,localBinaryInspect:i};export function findToolSchema(o){return toolSchemas[o]}

package/dist/types/index.d.ts

@@ -163,6 +163,15 @@ export interface LocalSearchCodeMatch {
     line: number;
     value?: string;
     column?: number;
+    count?: number;
+    /**
+     * AST node-kind label from the engine (declaration|import|export|callsite|
+     * identifier|comment|string|configKey|heading) when AST classification ran.
+     * Preferred over regex line heuristics by the relevance ranker.
+     */
+    kind?: string;
+    /** Deterministic relevance hint (0.0..1.0) derived from `kind`. */
+    scoreHint?: number;
 }
 export interface LocalSearchCodeFile {
     path: string;

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "@octocodeai/octocode-core",
-  "version": "16.3.0",
-  "description": "Compressed MCP tool specs and CLI command specs for Octocode (exposed via /mcp and /cli)",
+  "version": "16.5.0",
+  "description": "Compressed MCP tool specs, CLI command specs, and Zod query schemas for Octocode (exposed via /mcp, /cli, and /schemas)",
   "type": "module",
   "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
     "./cli": {
       "import": "./dist/cli.js",
       "types": "./dist/cli.d.ts"
@@ -11,6 +15,26 @@
     "./mcp": {
       "import": "./dist/mcp.js",
       "types": "./dist/mcp.d.ts"
+    },
+    "./schemas": {
+      "import": "./dist/schemas.js",
+      "types": "./dist/schemas.d.ts"
+    },
+    "./schemas/outputs": {
+      "import": "./dist/schemas/outputs.js",
+      "types": "./dist/schemas/outputs.d.ts"
+    },
+    "./schemas/runtime": {
+      "import": "./dist/schemas/runtime.js",
+      "types": "./dist/schemas/runtime.d.ts"
+    },
+    "./types": {
+      "import": "./dist/types/index.js",
+      "types": "./dist/types/index.d.ts"
+    },
+    "./extra-types": {
+      "import": "./dist/schemas/extraTypes.js",
+      "types": "./dist/schemas/extraTypes.d.ts"
     }
   },
   "files": [