@octocodeai/octocode-core 16.2.1 → 16.4.0

package/dist/schemas.d.ts

@@ -0,0 +1,490 @@
+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";
+            modified: "modified";
+            accessed: "accessed";
+        }>>;
+        sortReverse: z.ZodOptional<z.ZodBoolean>;
+        langType: z.ZodOptional<z.ZodString>;
+        countLinesPerFile: z.ZodOptional<z.ZodBoolean>;
+        countMatchesPerFile: z.ZodOptional<z.ZodBoolean>;
+        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";
+            identify: "identify";
+            extract: "extract";
+            decompress: "decompress";
+            strings: "strings";
+            unpack: "unpack";
+        }>;
+        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>;
+        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

@@ -1,15 +1,15 @@
 export interface ToolNames {
-    GITHUB_FETCH_CONTENT: "ghGetFileContent";
     GITHUB_SEARCH_CODE: "ghSearchCode";
-    GITHUB_SEARCH_PULL_REQUESTS: "ghHistoryResearch";
-    GITHUB_SEARCH_REPOSITORIES: "ghSearchRepos";
+    GITHUB_FETCH_CONTENT: "ghGetFileContent";
     GITHUB_VIEW_REPO_STRUCTURE: "ghViewRepoStructure";
+    GITHUB_SEARCH_REPOSITORIES: "ghSearchRepos";
+    GITHUB_SEARCH_PULL_REQUESTS: "ghHistoryResearch";
     PACKAGE_SEARCH: "npmSearch";
     GITHUB_CLONE_REPO: "ghCloneRepo";
     LOCAL_RIPGREP: "localSearchCode";
-    LOCAL_FETCH_CONTENT: "localGetFileContent";
-    LOCAL_FIND_FILES: "localFindFiles";
     LOCAL_VIEW_STRUCTURE: "localViewStructure";
+    LOCAL_FIND_FILES: "localFindFiles";
+    LOCAL_FETCH_CONTENT: "localGetFileContent";
     LSP_GET_SEMANTIC_CONTENT: "lspGetSemantics";
     LOCAL_BINARY_INSPECT: "localBinaryInspect";
 }
@@ -19,8 +19,30 @@ export interface ToolHints {
 export interface ToolSchema {
     readonly [param: string]: string;
 }
+/**
+ * The backing data source a tool operates against. Drives grouping in the
+ * agent-facing toolset: GitHub repo/PR/commit tools, npm registry lookup, and
+ * local-filesystem tools.
+ */
+export type ToolType = "Github" | "Local" | "NPM";
 export interface ToolSpec {
     readonly name: string;
+    /** The data source this tool operates against. */
+    readonly type: ToolType;
+    /** One-line summary of what the tool does, for agents scanning the toolset. */
+    readonly shortDescription: string;
+    /**
+     * How to drive the tool: mode/option selection, output signals, cross-tool
+     * handoffs, and best practices. Per-parameter contracts live in `schema`, not
+     * here — keep this free of detail the schema already carries.
+     */
+    readonly instructions: string;
+    /**
+     * Client-facing description, composed as
+     * `"{type} | {shortDescription} | {instructions}"` by `defineTool`. Kept so
+     * consumers that only read `description` (e.g. the MCP tool registry) still
+     * get the full text. Do not author directly.
+     */
     readonly description: string;
     readonly schema: ToolSchema;
     readonly hints?: ToolHints;
@@ -28,6 +50,33 @@ export interface ToolSpec {
 export interface ToolMetadata extends ToolSpec {
     readonly hints: ToolHints;
 }
+/**
+ * A single flag/option on a CLI command. `hasValue` distinguishes a value
+ * option (`--page <n>`) from a boolean switch (`--json`); `default` is the
+ * value applied when the option is omitted.
+ */
+export interface CLIOption {
+    readonly name: string;
+    readonly description: string;
+    readonly hasValue?: boolean;
+    readonly default?: string | boolean;
+}
+/**
+ * Agent/user-facing content for one Octocode CLI command — the documentation
+ * layer (description, usage line, argument scheme, when-to-use guidance,
+ * examples, and option list), independent of the runtime handler that lives in
+ * the CLI package. Each command's spec is authored as its own file under
+ * `resources/cli/<command>.ts`, mirroring `resources/tools/<tool>.ts`.
+ */
+export interface CLICommandSpec {
+    readonly name: string;
+    readonly description: string;
+    readonly usage?: string;
+    readonly scheme?: readonly string[];
+    readonly whenToUse?: readonly string[];
+    readonly examples?: readonly string[];
+    readonly options?: readonly CLIOption[];
+}
 export interface BaseSchema {
     readonly id: string;
     readonly mainResearchGoal: string;
@@ -36,15 +85,19 @@ export interface BaseSchema {
     readonly verbose?: string;
 }
 export interface OctocodeConfig {
-    readonly instructions: string;
+    /** Top-level agent system prompt shipped with the config. */
+    readonly systemPrompt: string;
     readonly toolNames: ToolNames;
     readonly baseSchema: BaseSchema;
     readonly tools: Record<ToolNames[keyof ToolNames], ToolSpec | ToolMetadata>;
+    /** Agent/user-facing content for the smart CLI commands. */
+    readonly cli?: readonly CLICommandSpec[];
     readonly baseHints?: Readonly<Record<string, readonly string[]>>;
     readonly genericErrorHints?: readonly string[];
 }
 export interface CompleteMetadata {
-    readonly instructions: string;
+    /** Top-level agent system prompt shipped with the config. */
+    readonly systemPrompt: string;
     readonly toolNames: ToolNames;
     readonly baseSchema: BaseSchema;
     readonly tools: Record<string, ToolSpec | ToolMetadata>;

package/package.json

@@ -1,19 +1,24 @@
 {
   "name": "@octocodeai/octocode-core",
-  "version": "16.2.1",
-  "description": "Core config, prompts, tools, and schemas for Octocode MCP",
+  "version": "16.4.0",
+  "description": "Compressed MCP tool specs, CLI command specs, and Zod query schemas for Octocode (exposed via /mcp, /cli, and /schemas)",
   "type": "module",
-  "main": "dist/index.js",
-  "module": "dist/index.js",
-  "types": "dist/index.d.ts",
   "exports": {
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
     },
+    "./cli": {
+      "import": "./dist/cli.js",
+      "types": "./dist/cli.d.ts"
+    },
+    "./mcp": {
+      "import": "./dist/mcp.js",
+      "types": "./dist/mcp.d.ts"
+    },
     "./schemas": {
-      "import": "./dist/schemas/index.js",
-      "types": "./dist/schemas/index.d.ts"
+      "import": "./dist/schemas.js",
+      "types": "./dist/schemas.d.ts"
     },
     "./schemas/outputs": {
       "import": "./dist/schemas/outputs.js",
@@ -35,7 +40,6 @@
   "files": [
     "dist/**/*.js",
     "dist/**/*.d.ts",
-    "dist/**/*.json",
     "README.md"
   ],
   "publishConfig": {
@@ -48,7 +52,7 @@
     "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",
+    "typecheck": "yarn compress && tsc --noEmit -p tsconfig.typecheck.json",
     "test": "yarn compress && vitest run",
     "test:watch": "yarn compress && vitest --watch",
     "prepublishOnly": "yarn lint && yarn typecheck && yarn test && yarn build"