@octocodeai/octocode-core 1.0.1 → 2.0.0

package/dist/lib/deep-merge.d.ts

@@ -1,7 +0,0 @@
-/**
- * Deep merge two objects.
- * - Objects are merged recursively.
- * - Arrays and primitives in source replace those in target.
- * - Source properties override target properties.
- */
-export declare function deepMerge<T>(target: T, source: unknown): T;

package/dist/lib/deep-merge.js

@@ -1 +0,0 @@
-export function deepMerge(r,e){if("object"!=typeof r||null===r||"object"!=typeof e||null===e)return e;if(Array.isArray(r)||Array.isArray(e))return e;const t={...r},o=e;for(const r of Object.keys(o)){const e=t[r],y=o[r];"object"!=typeof e||null===e||"object"!=typeof y||null===y||Array.isArray(e)||Array.isArray(y)?t[r]=y:t[r]=deepMerge(e,y)}return t}

package/dist/metadata-types/metadata.d.ts

@@ -1,44 +0,0 @@
-import type { ToolNames, BaseHints } from "../types.js";
-export interface ToolMetadata {
-    name: string;
-    description: string;
-    schema: Record<string, string>;
-    hints: {
-        hasResults: readonly string[];
-        empty: readonly string[];
-        dynamic?: Record<string, string[] | undefined>;
-    };
-}
-export interface PromptArgument {
-    name: string;
-    description: string;
-    required?: boolean;
-}
-export interface PromptMetadata {
-    name: string;
-    description: string;
-    content: string;
-    args?: PromptArgument[];
-}
-export interface CompleteMetadata {
-    instructions: string;
-    prompts: Record<string, PromptMetadata>;
-    toolNames: ToolNames;
-    baseSchema: {
-        mainResearchGoal: string;
-        researchGoal: string;
-        reasoning: string;
-        bulkQuery: (toolName: string) => string;
-    };
-    tools: Record<string, ToolMetadata>;
-    baseHints: BaseHints;
-    genericErrorHints: readonly string[];
-    bulkOperations?: {
-        instructions?: {
-            base?: string;
-            hasResults?: string;
-            empty?: string;
-            error?: string;
-        };
-    };
-}

package/dist/schemes/base/baseSchema.d.ts

@@ -1,24 +0,0 @@
-import { z } from "zod/v4";
-export declare const BaseQuerySchema: z.ZodObject<{
-    id: z.ZodString;
-    mainResearchGoal: z.ZodString;
-    researchGoal: z.ZodString;
-    reasoning: z.ZodString;
-}, z.core.$strip>;
-export declare const BaseQuerySchemaLocal: z.ZodObject<{
-    id: z.ZodString;
-    researchGoal: z.ZodString;
-    reasoning: z.ZodString;
-}, z.core.$strip>;
-export type BaseQuery = z.infer<typeof BaseQuerySchema>;
-export type BaseQueryLocal = z.infer<typeof BaseQuerySchemaLocal>;
-interface BulkQuerySchemaOptions {
-    maxQueries?: number;
-    descriptionPrefix?: string;
-}
-export declare function createBulkQuerySchema<T extends z.ZodType<object>>(toolName: string, singleQuerySchema: T, options?: BulkQuerySchemaOptions): z.ZodObject<{
-    queries: z.ZodArray<T>;
-    responseCharOffset: z.ZodOptional<z.ZodNumber>;
-    responseCharLength: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strict>;
-export {};

package/dist/schemes/base/baseSchema.js

@@ -1 +0,0 @@
-import{z as e}from"zod/v4";import{config as r}from"../../configLoader.js";const s=r.baseSchema,a=e.string().min(1).max(120).regex(/^[A-Za-z0-9._:-]+$/,"id must contain only letters, numbers, dot, underscore, colon, or dash").describe('Stable query identifier used to match each result to its input query. Required for every query. Use a short meaningful string like "react_hooks_search" or "router_prs".');export const BaseQuerySchema=e.object({id:a,mainResearchGoal:e.string().describe(s.mainResearchGoal),researchGoal:e.string().describe(s.researchGoal),reasoning:e.string().describe(s.reasoning)});export const BaseQuerySchemaLocal=e.object({id:a,researchGoal:e.string().describe(s.researchGoal),reasoning:e.string().describe(s.reasoning)});export function createBulkQuerySchema(r,a,i={}){const{maxQueries:o=3,descriptionPrefix:t}=i,n=t??(3===o?s.bulkQueryTemplate.replace("{toolName}",r):`Queries for ${r} (1–${o} per call). Review schema before use.`);return e.object({queries:e.array(a).min(1).max(o).describe(n),responseCharOffset:e.number().int().min(0).optional().describe("Character offset for top-level bulk response pagination across results[]. Use when a multi-query response was auto-paginated."),responseCharLength:e.number().int().min(1).max(5e4).optional().describe("Character budget for top-level bulk response pagination across results[]. Overrides the shared default for this call.")}).strict().superRefine((e,r)=>{const s=new Set;e.queries.forEach((e,a)=>{const i="object"==typeof e&&null!==e&&"id"in e&&"string"==typeof e.id?e.id:void 0;i&&(s.has(i)?r.addIssue({code:"custom",path:["queries",a,"id"],message:`Duplicate query id "${i}". Query ids must be unique within a single call.`}):s.add(i))})})}

package/dist/schemes/helpers/githubSchemaHelpers.d.ts

@@ -1,158 +0,0 @@
-export declare const GITHUB_FETCH_CONTENT: {
-    scope: {
-        owner: string;
-        repo: string;
-        branch: string;
-        path: string;
-    };
-    processing: {
-        sanitize: string;
-    };
-    range: {
-        startLine: string;
-        endLine: string;
-        fullContent: string;
-        matchString: string;
-        matchStringContextLines: string;
-    };
-    pagination: {
-        charOffset: string;
-        charLength: string;
-    };
-    validation: {
-        parameterConflict: string;
-    };
-};
-export declare const GITHUB_SEARCH_CODE: {
-    search: {
-        keywordsToSearch: string;
-    };
-    scope: {
-        owner: string;
-        repo: string;
-    };
-    filters: {
-        extension: string;
-        filename: string;
-        path: string;
-        match: string;
-    };
-    resultLimit: {
-        limit: string;
-    };
-    pagination: {
-        page: string;
-    };
-    processing: {
-        sanitize: string;
-    };
-};
-export declare const GITHUB_SEARCH_REPOS: {
-    search: {
-        keywordsToSearch: string;
-        topicsToSearch: string;
-    };
-    scope: {
-        owner: string;
-        repo: string;
-    };
-    filters: {
-        stars: string;
-        size: string;
-        created: string;
-        updated: string;
-        match: string;
-    };
-    sorting: {
-        sort: string;
-    };
-    resultLimit: {
-        limit: string;
-    };
-    pagination: {
-        page: string;
-    };
-};
-export declare const GITHUB_SEARCH_PULL_REQUESTS: {
-    search: {
-        query: string;
-    };
-    scope: {
-        prNumber: string;
-        owner: string;
-        repo: string;
-    };
-    filters: {
-        match: string;
-        created: string;
-        updated: string;
-        state: string;
-        assignee: string;
-        author: string;
-        commenter: string;
-        involves: string;
-        mentions: string;
-        "review-requested": string;
-        "reviewed-by": string;
-        label: string;
-        "no-label": string;
-        "no-milestone": string;
-        "no-project": string;
-        "no-assignee": string;
-        head: string;
-        base: string;
-        closed: string;
-        "merged-at": string;
-        comments: string;
-        reactions: string;
-        interactions: string;
-        merged: string;
-        draft: string;
-    };
-    sorting: {
-        sort: string;
-        order: string;
-    };
-    resultLimit: {
-        limit: string;
-    };
-    pagination: {
-        page: string;
-    };
-    outputShaping: {
-        withComments: string;
-        withCommits: string;
-        type: string;
-        partialContentMetadata: string;
-    };
-    outputLimit: {
-        charOffset: string;
-        charLength: string;
-    };
-};
-export declare const GITHUB_VIEW_REPO_STRUCTURE: {
-    scope: {
-        owner: string;
-        repo: string;
-        branch: string;
-        path: string;
-    };
-    range: {
-        depth: string;
-    };
-    pagination: {
-        entriesPerPage: string;
-        entryPageNumber: string;
-    };
-};
-export declare const PACKAGE_SEARCH: {
-    search: {
-        ecosystem: string;
-        name: string;
-    };
-    options: {
-        searchLimit: string;
-        npmFetchMetadata: string;
-        pythonFetchMetadata: string;
-    };
-};

package/dist/schemes/helpers/githubSchemaHelpers.js

@@ -1 +0,0 @@
-import{TOOL_NAMES as E}from"./schemaHelperFactory.js";import{createSchemaHelper as _}from"./schemaHelperFactory.js";export const GITHUB_FETCH_CONTENT=_(E.GITHUB_FETCH_CONTENT);export const GITHUB_SEARCH_CODE=_(E.GITHUB_SEARCH_CODE);export const GITHUB_SEARCH_REPOS=_(E.GITHUB_SEARCH_REPOSITORIES);export const GITHUB_SEARCH_PULL_REQUESTS=_(E.GITHUB_SEARCH_PULL_REQUESTS);export const GITHUB_VIEW_REPO_STRUCTURE=_(E.GITHUB_VIEW_REPO_STRUCTURE);export const PACKAGE_SEARCH=_(E.PACKAGE_SEARCH);

package/dist/schemes/helpers/localSchemaHelpers.d.ts

@@ -1,164 +0,0 @@
-export declare const LOCAL_RIPGREP: {
-    search: {
-        pattern: string;
-        path: string;
-        mode: string;
-    };
-    filters: {
-        type: string;
-        include: string;
-        exclude: string;
-        excludeDir: string;
-        binaryFiles: string;
-        noIgnore: string;
-        hidden: string;
-        followSymlinks: string;
-    };
-    options: {
-        smartCase: string;
-        caseInsensitive: string;
-        caseSensitive: string;
-        fixedString: string;
-        perlRegex: string;
-        wholeWord: string;
-        invertMatch: string;
-        multiline: string;
-        multilineDotall: string;
-    };
-    output: {
-        filesOnly: string;
-        filesWithoutMatch: string;
-        count: string;
-        countMatches: string;
-        jsonOutput: string;
-        vimgrepFormat: string;
-        includeStats: string;
-        includeDistribution: string;
-    };
-    context: {
-        contextLines: string;
-        beforeContext: string;
-        afterContext: string;
-        matchContentLength: string;
-        lineNumbers: string;
-        column: string;
-    };
-    pagination: {
-        filesPerPage: string;
-        filePageNumber: string;
-        matchesPerPage: string;
-        maxFiles: string;
-        maxMatchesPerFile: string;
-    };
-    advanced: {
-        threads: string;
-        mmap: string;
-        noUnicode: string;
-        encoding: string;
-        sort: string;
-        sortReverse: string;
-        noMessages: string;
-        lineRegexp: string;
-        passthru: string;
-        debug: string;
-        showFileLastModified: string;
-    };
-};
-export declare const LOCAL_FETCH_CONTENT: {
-    scope: {
-        path: string;
-    };
-    range: {
-        startLine: string;
-        endLine: string;
-    };
-    options: {
-        fullContent: string;
-        matchString: string;
-        matchStringContextLines: string;
-        matchStringIsRegex: string;
-        matchStringCaseSensitive: string;
-        minified: string;
-    };
-    pagination: {
-        charOffset: string;
-        charLength: string;
-    };
-};
-export declare const LOCAL_FIND_FILES: {
-    scope: {
-        path: string;
-    };
-    filters: {
-        name: string;
-        iname: string;
-        names: string;
-        pathPattern: string;
-        regex: string;
-        regexType: string;
-        type: string;
-        empty: string;
-        executable: string;
-        readable: string;
-        writable: string;
-        excludeDir: string;
-    };
-    time: {
-        modifiedWithin: string;
-        modifiedBefore: string;
-        accessedWithin: string;
-    };
-    size: {
-        sizeGreater: string;
-        sizeLess: string;
-    };
-    pagination: {
-        limit: string;
-        filesPerPage: string;
-        filePageNumber: string;
-        charOffset: string;
-        charLength: string;
-    };
-    sorting: {
-        sortBy: string;
-    };
-    options: {
-        maxDepth: string;
-        minDepth: string;
-        details: string;
-        permissions: string;
-        showFileLastModified: string;
-    };
-};
-export declare const LOCAL_VIEW_STRUCTURE: {
-    scope: {
-        path: string;
-    };
-    filters: {
-        pattern: string;
-        directoriesOnly: string;
-        filesOnly: string;
-        extension: string;
-        extensions: string;
-        hidden: string;
-    };
-    options: {
-        depth: string;
-        recursive: string;
-        details: string;
-        humanReadable: string;
-        summary: string;
-        showFileLastModified: string;
-    };
-    sorting: {
-        sortBy: string;
-        reverse: string;
-    };
-    pagination: {
-        limit: string;
-        entriesPerPage: string;
-        entryPageNumber: string;
-        charOffset: string;
-        charLength: string;
-    };
-};

package/dist/schemes/helpers/localSchemaHelpers.js

@@ -1 +0,0 @@
-import{TOOL_NAMES as L}from"./schemaHelperFactory.js";import{createSchemaHelper as o}from"./schemaHelperFactory.js";export const LOCAL_RIPGREP=o(L.LOCAL_RIPGREP);export const LOCAL_FETCH_CONTENT=o(L.LOCAL_FETCH_CONTENT);export const LOCAL_FIND_FILES=o(L.LOCAL_FIND_FILES);export const LOCAL_VIEW_STRUCTURE=o(L.LOCAL_VIEW_STRUCTURE);

package/dist/schemes/helpers/lspSchemaBuilders.d.ts

@@ -1,20 +0,0 @@
-import { z } from "zod/v4";
-interface LspSchemaDescriptions {
-    uri: string;
-    symbolName: string;
-    lineHint: string;
-    orderHint: string;
-    charOffset?: string;
-    charLength?: string;
-}
-export declare function createLspCoreQueryShape(descriptions: LspSchemaDescriptions): {
-    uri: z.ZodString;
-    symbolName: z.ZodString;
-    lineHint: z.ZodNumber;
-    orderHint: z.ZodDefault<z.ZodNumber>;
-};
-export declare function createLspOutputPaginationShape(descriptions: Pick<LspSchemaDescriptions, "charOffset" | "charLength">): {
-    charOffset: z.ZodOptional<z.ZodNumber>;
-    charLength: z.ZodOptional<z.ZodNumber>;
-};
-export {};

package/dist/schemes/helpers/lspSchemaBuilders.js

@@ -1 +0,0 @@
-import{z as e}from"zod/v4";import{LSP_QUERY_OUTPUT_PAGINATION as r}from"./lspSchemaDescriptions.js";export function createLspCoreQueryShape(r){return{uri:e.string().min(1).describe(r.uri),symbolName:e.string().min(1).max(255).describe(r.symbolName),lineHint:e.number().int().min(1).describe(r.lineHint),orderHint:e.number().int().min(0).default(0).describe(r.orderHint)}}export function createLspOutputPaginationShape(i){return{charOffset:e.number().int().min(0).optional().describe(i.charOffset||r.charOffset),charLength:e.number().int().min(1).max(5e4).optional().describe(i.charLength||r.charLength)}}

package/dist/schemes/helpers/lspSchemaDescriptions.d.ts

@@ -1,5 +0,0 @@
-export declare const LSP_QUERY_OUTPUT_PAGINATION: {
-    readonly charOffset: "Character offset for query-level output pagination. Use when this LSP result was auto-paginated and you need the next window.";
-    readonly charLength: "Character budget for query-level output pagination window.";
-};
-export declare function buildLspBulkQueryDescription(toolName: string, maxQueries: 3 | 5, guidance?: string): string;

package/dist/schemes/helpers/lspSchemaDescriptions.js

@@ -1 +0,0 @@
-export const LSP_QUERY_OUTPUT_PAGINATION={charOffset:"Character offset for query-level output pagination. Use when this LSP result was auto-paginated and you need the next window.",charLength:"Character budget for query-level output pagination window."};export function buildLspBulkQueryDescription(e,t,r){return`Queries for ${e} (1-${t} per call). Review schema before use.${r?` ${r}`:""}`}

package/dist/schemes/helpers/lspSchemaHelpers.d.ts

@@ -1,52 +0,0 @@
-export declare const LSP_GOTO_DEFINITION: {
-    scope: {
-        uri: string;
-        symbolName: string;
-        lineHint: string;
-    };
-    options: {
-        orderHint: string;
-        contextLines: string;
-    };
-};
-export declare const LSP_FIND_REFERENCES: {
-    scope: {
-        uri: string;
-        symbolName: string;
-        lineHint: string;
-    };
-    options: {
-        orderHint: string;
-        includeDeclaration: string;
-        contextLines: string;
-    };
-    pagination: {
-        referencesPerPage: string;
-        page: string;
-    };
-    filtering: {
-        includePattern: string;
-        excludePattern: string;
-    };
-};
-export declare const LSP_CALL_HIERARCHY: {
-    scope: {
-        uri: string;
-        symbolName: string;
-        lineHint: string;
-    };
-    options: {
-        orderHint: string;
-        direction: string;
-        depth: string;
-        contextLines: string;
-    };
-    pagination: {
-        callsPerPage: string;
-        page: string;
-    };
-    outputLimit: {
-        charOffset: string;
-        charLength: string;
-    };
-};

package/dist/schemes/helpers/lspSchemaHelpers.js

@@ -1 +0,0 @@
-import{TOOL_NAMES as o}from"./schemaHelperFactory.js";import{createSchemaHelper as E}from"./schemaHelperFactory.js";export const LSP_GOTO_DEFINITION=E(o.LSP_GOTO_DEFINITION);export const LSP_FIND_REFERENCES=E(o.LSP_FIND_REFERENCES);export const LSP_CALL_HIERARCHY=E(o.LSP_CALL_HIERARCHY);

package/dist/schemes/helpers/schemaHelperFactory.d.ts

@@ -1,3 +0,0 @@
-export declare function createSchemaHelper(toolName: string): {};
-export declare const TOOL_NAMES: import("../../types.js").ToolNames;
-export declare function getToolDescription(toolName: string): string;

package/dist/schemes/helpers/schemaHelperFactory.js

@@ -1 +0,0 @@
-import{config as o}from"../../configLoader.js";export function createSchemaHelper(e){return new Proxy({},{get:(t,r)=>new Proxy({},{get(t,r){const n=o.tools[e];return n?.schema?.[r]??""}})})}export const TOOL_NAMES=o.toolNames;export function getToolDescription(e){return o.tools[e]?.description??""}

package/dist/schemes/index.d.ts

@@ -1,25 +0,0 @@
-export { BaseQuerySchema, BaseQuerySchemaLocal, createBulkQuerySchema, type BaseQuery, type BaseQueryLocal, } from "./base/baseSchema.js";
-export { LOCAL_RIPGREP, LOCAL_FETCH_CONTENT, LOCAL_FIND_FILES, LOCAL_VIEW_STRUCTURE, } from "./helpers/localSchemaHelpers.js";
-export { LSP_GOTO_DEFINITION, LSP_FIND_REFERENCES, LSP_CALL_HIERARCHY, } from "./helpers/lspSchemaHelpers.js";
-export { GITHUB_FETCH_CONTENT, GITHUB_SEARCH_CODE, GITHUB_SEARCH_REPOS, GITHUB_SEARCH_PULL_REQUESTS, GITHUB_VIEW_REPO_STRUCTURE, PACKAGE_SEARCH, } from "./helpers/githubSchemaHelpers.js";
-export { createLspCoreQueryShape, createLspOutputPaginationShape, } from "./helpers/lspSchemaBuilders.js";
-export { buildLspBulkQueryDescription, LSP_QUERY_OUTPUT_PAGINATION, } from "./helpers/lspSchemaDescriptions.js";
-export { RipgrepQuerySchema, BulkRipgrepQuerySchema, LOCAL_RIPGREP_DESCRIPTION, applyWorkflowMode, validateRipgrepQuery, type RipgrepQuery, } from "./input/localSearchCode.js";
-export { FetchContentQuerySchema, BulkFetchContentSchema, LOCAL_FETCH_CONTENT_DESCRIPTION, type FetchContentQuery, } from "./input/localGetFileContent.js";
-export { FindFilesQuerySchema, BulkFindFilesSchema, LOCAL_FIND_FILES_DESCRIPTION, type FindFilesQuery, } from "./input/localFindFiles.js";
-export { ViewStructureQuerySchema, BulkViewStructureSchema, LOCAL_VIEW_STRUCTURE_DESCRIPTION, type ViewStructureQuery, } from "./input/localViewStructure.js";
-export { FileContentQuerySchema, FileContentBulkQuerySchema, type FileContentQuery, } from "./input/githubFetchContent.js";
-export { GitHubCodeSearchQuerySchema, GitHubCodeSearchBulkQuerySchema, type GitHubCodeSearchQuery, } from "./input/githubSearchCode.js";
-export { GitHubReposSearchSingleQuerySchema, GitHubReposSearchQuerySchema, type GitHubReposSearchQuery, } from "./input/githubSearchRepos.js";
-export { GitHubPullRequestSearchQuerySchema, GitHubPullRequestSearchBulkQuerySchema, type GitHubPullRequestSearchQuery, } from "./input/githubSearchPullRequests.js";
-export { GitHubViewRepoStructureQuerySchema, GitHubViewRepoStructureBulkQuerySchema, GITHUB_STRUCTURE_DEFAULTS, type GitHubViewRepoStructureQuery, } from "./input/githubViewRepoStructure.js";
-export { CloneRepoQuerySchema, BulkCloneRepoSchema, GITHUB_CLONE_REPO_DESCRIPTION, type CloneRepoQuery, } from "./input/githubCloneRepo.js";
-export { NpmPackageQuerySchema, PythonPackageQuerySchema, PackageSearchQuerySchema, PackageSearchBulkQuerySchema, type PackageSearchQuery, } from "./input/packageSearch.js";
-export { LSPGotoDefinitionQuerySchema, BulkLSPGotoDefinitionSchema, LSP_GOTO_DEFINITION_DESCRIPTION, type LSPGotoDefinitionQuery, } from "./input/lspGotoDefinition.js";
-export { LSPFindReferencesQuerySchema, BulkLSPFindReferencesSchema, LSP_FIND_REFERENCES_DESCRIPTION, type LSPFindReferencesQuery, } from "./input/lspFindReferences.js";
-export { LSPCallHierarchyQuerySchema, BulkLSPCallHierarchySchema, LSP_CALL_HIERARCHY_DESCRIPTION, type LSPCallHierarchyQuery, } from "./input/lspCallHierarchy.js";
-export { ErrorDataSchema, EmptyDataSchema, BulkToolOutputSchema, GitHubFetchContentDataSchema, GitHubFetchContentOutputSchema, GitHubSearchCodeDataSchema, GitHubSearchCodeOutputSchema, GitHubSearchPullRequestsDataSchema, GitHubSearchPullRequestsOutputSchema, GitHubSearchRepositoriesDataSchema, GitHubSearchRepositoriesOutputSchema, GitHubViewRepoStructureDataSchema, GitHubViewRepoStructureOutputSchema, GitHubCloneRepoDataSchema, GitHubCloneRepoOutputSchema, PackageSearchDataSchema, PackageSearchOutputSchema, LocalSearchCodeDataSchema, LocalSearchCodeOutputSchema, LocalGetFileContentDataSchema, LocalGetFileContentOutputSchema, LocalFindFilesDataSchema, LocalFindFilesOutputSchema, LocalViewStructureDataSchema, LocalViewStructureOutputSchema, LspGotoDefinitionDataSchema, LspGotoDefinitionOutputSchema, LspFindReferencesDataSchema, LspFindReferencesOutputSchema, LspCallHierarchyDataSchema, LspCallHierarchyOutputSchema, } from "./output/outputSchemas.js";
-export type { OutputStatus, ErrorOutputData, EmptyOutputData, ToolResult, } from "./output/outputTypes.js";
-export type { GitHubCloneRepoData, GitHubCloneRepoToolResult, GitHubFetchContentData, GitHubFetchContentToolResult, GitHubDirectoryFileEntry, GitHubSearchCodeData, GitHubSearchCodeToolResult, GitHubCodeSearchFile, GitHubSearchPullRequestsData, GitHubSearchPullRequestsToolResult, GitHubPullRequestOutput, GitHubSearchPullRequestsPagination, GitHubSearchRepositoriesData, GitHubSearchRepositoriesToolResult, GitHubRepositoryOutput, GitHubViewRepoStructureData, GitHubViewRepoStructureToolResult, GitHubRepoStructureDirectoryEntry, PackageSearchData, PackageSearchToolResult, PackageSearchPackage, } from "./output/outputTypes.js";
-export type { LocalSearchCodeData, LocalSearchCodeToolResult, LocalSearchCodeFile, LocalSearchCodeMatch, LocalSearchCodePagination, LocalSearchCodeMatchPagination, LocalGetFileContentData, LocalGetFileContentToolResult, LocalGetFileContentPagination, LocalGetFileContentMatchRange, LocalFindFilesData, LocalFindFilesToolResult, LocalFindFilesEntry, LocalFindFilesPagination, LocalViewStructureData, LocalViewStructureToolResult, LocalViewStructureEntry, LocalViewStructurePagination, } from "./output/outputTypes.js";
-export type { LspGotoDefinitionData, LspGotoDefinitionToolResult, LspExactPosition, LspCodeSnippet, LspRange, LspSymbolKind, LspFindReferencesData, LspFindReferencesToolResult, LspReferenceLocation, LspFindReferencesPagination, LspCallHierarchyData, LspCallHierarchyToolResult, LspCallHierarchyItem, LspIncomingCall, LspOutgoingCall, LspCallHierarchyPagination, } from "./output/outputTypes.js";

package/dist/schemes/index.js

@@ -1 +0,0 @@
-export{BaseQuerySchema,BaseQuerySchemaLocal,createBulkQuerySchema}from"./base/baseSchema.js";export{LOCAL_RIPGREP,LOCAL_FETCH_CONTENT,LOCAL_FIND_FILES,LOCAL_VIEW_STRUCTURE}from"./helpers/localSchemaHelpers.js";export{LSP_GOTO_DEFINITION,LSP_FIND_REFERENCES,LSP_CALL_HIERARCHY}from"./helpers/lspSchemaHelpers.js";export{GITHUB_FETCH_CONTENT,GITHUB_SEARCH_CODE,GITHUB_SEARCH_REPOS,GITHUB_SEARCH_PULL_REQUESTS,GITHUB_VIEW_REPO_STRUCTURE,PACKAGE_SEARCH}from"./helpers/githubSchemaHelpers.js";export{createLspCoreQueryShape,createLspOutputPaginationShape}from"./helpers/lspSchemaBuilders.js";export{buildLspBulkQueryDescription,LSP_QUERY_OUTPUT_PAGINATION}from"./helpers/lspSchemaDescriptions.js";export{RipgrepQuerySchema,BulkRipgrepQuerySchema,LOCAL_RIPGREP_DESCRIPTION,applyWorkflowMode,validateRipgrepQuery}from"./input/localSearchCode.js";export{FetchContentQuerySchema,BulkFetchContentSchema,LOCAL_FETCH_CONTENT_DESCRIPTION}from"./input/localGetFileContent.js";export{FindFilesQuerySchema,BulkFindFilesSchema,LOCAL_FIND_FILES_DESCRIPTION}from"./input/localFindFiles.js";export{ViewStructureQuerySchema,BulkViewStructureSchema,LOCAL_VIEW_STRUCTURE_DESCRIPTION}from"./input/localViewStructure.js";export{FileContentQuerySchema,FileContentBulkQuerySchema}from"./input/githubFetchContent.js";export{GitHubCodeSearchQuerySchema,GitHubCodeSearchBulkQuerySchema}from"./input/githubSearchCode.js";export{GitHubReposSearchSingleQuerySchema,GitHubReposSearchQuerySchema}from"./input/githubSearchRepos.js";export{GitHubPullRequestSearchQuerySchema,GitHubPullRequestSearchBulkQuerySchema}from"./input/githubSearchPullRequests.js";export{GitHubViewRepoStructureQuerySchema,GitHubViewRepoStructureBulkQuerySchema,GITHUB_STRUCTURE_DEFAULTS}from"./input/githubViewRepoStructure.js";export{CloneRepoQuerySchema,BulkCloneRepoSchema,GITHUB_CLONE_REPO_DESCRIPTION}from"./input/githubCloneRepo.js";export{NpmPackageQuerySchema,PythonPackageQuerySchema,PackageSearchQuerySchema,PackageSearchBulkQuerySchema}from"./input/packageSearch.js";export{LSPGotoDefinitionQuerySchema,BulkLSPGotoDefinitionSchema,LSP_GOTO_DEFINITION_DESCRIPTION}from"./input/lspGotoDefinition.js";export{LSPFindReferencesQuerySchema,BulkLSPFindReferencesSchema,LSP_FIND_REFERENCES_DESCRIPTION}from"./input/lspFindReferences.js";export{LSPCallHierarchyQuerySchema,BulkLSPCallHierarchySchema,LSP_CALL_HIERARCHY_DESCRIPTION}from"./input/lspCallHierarchy.js";export{ErrorDataSchema,EmptyDataSchema,BulkToolOutputSchema,GitHubFetchContentDataSchema,GitHubFetchContentOutputSchema,GitHubSearchCodeDataSchema,GitHubSearchCodeOutputSchema,GitHubSearchPullRequestsDataSchema,GitHubSearchPullRequestsOutputSchema,GitHubSearchRepositoriesDataSchema,GitHubSearchRepositoriesOutputSchema,GitHubViewRepoStructureDataSchema,GitHubViewRepoStructureOutputSchema,GitHubCloneRepoDataSchema,GitHubCloneRepoOutputSchema,PackageSearchDataSchema,PackageSearchOutputSchema,LocalSearchCodeDataSchema,LocalSearchCodeOutputSchema,LocalGetFileContentDataSchema,LocalGetFileContentOutputSchema,LocalFindFilesDataSchema,LocalFindFilesOutputSchema,LocalViewStructureDataSchema,LocalViewStructureOutputSchema,LspGotoDefinitionDataSchema,LspGotoDefinitionOutputSchema,LspFindReferencesDataSchema,LspFindReferencesOutputSchema,LspCallHierarchyDataSchema,LspCallHierarchyOutputSchema}from"./output/outputSchemas.js";

package/dist/schemes/input/githubCloneRepo.d.ts

@@ -1,33 +0,0 @@
-import { z } from "zod/v4";
-export declare const CloneRepoQuerySchema: z.ZodObject<{
-    id: z.ZodString;
-    mainResearchGoal: z.ZodString;
-    researchGoal: z.ZodString;
-    reasoning: z.ZodString;
-    owner: z.ZodString;
-    repo: z.ZodString;
-    branch: z.ZodOptional<z.ZodString>;
-    sparse_path: z.ZodOptional<z.ZodString>;
-    forceRefresh: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    charOffset: z.ZodOptional<z.ZodNumber>;
-    charLength: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-export type CloneRepoQuery = z.infer<typeof CloneRepoQuerySchema>;
-export declare const BulkCloneRepoSchema: z.ZodObject<{
-    queries: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        mainResearchGoal: z.ZodString;
-        researchGoal: z.ZodString;
-        reasoning: z.ZodString;
-        owner: z.ZodString;
-        repo: z.ZodString;
-        branch: z.ZodOptional<z.ZodString>;
-        sparse_path: z.ZodOptional<z.ZodString>;
-        forceRefresh: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-        charOffset: z.ZodOptional<z.ZodNumber>;
-        charLength: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>;
-    responseCharOffset: z.ZodOptional<z.ZodNumber>;
-    responseCharLength: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strict>;
-export declare const GITHUB_CLONE_REPO_DESCRIPTION: string;

package/dist/schemes/input/githubCloneRepo.js

@@ -1 +0,0 @@
-import{z as e}from"zod/v4";import{BaseQuerySchema as o,createBulkQuerySchema as a}from"../base/baseSchema.js";import{TOOL_NAMES as t}from"../helpers/schemaHelperFactory.js";const r=/^(?!\.\.?$)(?!.*\.\.)[a-zA-Z0-9._-]+$/;export const CloneRepoQuerySchema=o.extend({owner:e.string().min(1).max(200).regex(r,'Invalid owner: must be a valid GitHub identifier (no path separators or "..")').describe('Repository owner or organisation (e.g. "facebook")'),repo:e.string().min(1).max(150).regex(r,'Invalid repo: must be a valid GitHub identifier (no path separators or "..")').describe('Repository name (e.g. "react")'),branch:e.string().min(1).max(255).regex(/^(?!-)(?!.*\.\.)(?!.*\\)[a-zA-Z0-9._/-]+$/,'Invalid branch: must not contain ".." or start with "-"').optional().describe('Branch to clone. Omit to use the repository\'s default branch (usually "main").'),sparse_path:e.string().min(1).max(500).regex(/^(?!-)(?!.*\.\.)(?!.*\\)[a-zA-Z0-9._/@-]+$/,'Invalid sparse_path: must not contain ".." or start with "-"').refine(e=>!e.startsWith("/"),{message:"sparse_path must be a relative path (no leading /)"}).optional().describe('Fetch only this subdirectory (sparse checkout). Dramatically faster for large monorepos – only matching files are downloaded. Examples: "src/compiler", "packages/core/src", "lib/utils". Omit to clone the entire repository.'),forceRefresh:e.boolean().optional().default(!1).describe("When true, bypass the cache and force a fresh clone even if a valid cached copy exists. Useful when you know upstream has changed."),charOffset:e.number().int().min(0).optional().describe("Character offset for output pagination."),charLength:e.number().int().min(1).max(5e4).optional().describe("Character budget for output pagination.")});export const BulkCloneRepoSchema=a(t.GITHUB_CLONE_REPO,CloneRepoQuerySchema,{maxQueries:3});export const GITHUB_CLONE_REPO_DESCRIPTION=["## Clone or partially fetch a GitHub repository for deep local analysis","","Downloads a repository (or a subdirectory of it) to the local octocode","home directory so that **local filesystem tools** and **LSP semantic tools**","can analyse the code offline.","","### Two modes","","| Mode | When to use | Parameter |","|------|-------------|-----------|","| **Full clone** | General exploration, LSP needs full project context | _(default)_ |","| **Partial fetch** | Large monorepo, only need a specific package/dir | `sparse_path` |","","### How it works","","1. `git clone --depth 1 --single-branch` (shallow, fast)","2. If `sparse_path` is set → `git sparse-checkout set <path>` (only that tree)","3. Result cached for **24 hours** under `~/.octocode/repos/`","4. Returns `localPath` – pass it to local tools for analysis","","### Branch resolution","","- If `branch` is provided, that branch is cloned.","- If `branch` is omitted, the **default branch** is auto-detected via the GitHub API (falls back to `main`, then `master`).","- The resolved branch name is always included in the result and the cache path.","","### Cache path format","","```","~/.octocode/repos/{owner}/{repo}/{branch}/           ← full clone","~/.octocode/repos/{owner}/{repo}/{branch}__sp_{hash}/ ← sparse checkout","```","","### After cloning, use these tools on `localPath`:","","- `localSearchCode` – ripgrep code search","- `localGetFileContent` – read files","- `localViewStructure` – browse directory tree","- `localFindFiles` – find files by name/metadata","- `lspGotoDefinition` – jump to symbol definitions","- `lspFindReferences` – find all usages of a symbol","- `lspCallHierarchy` – trace call relationships"].join("\n");

package/dist/schemes/input/githubFetchContent.d.ts

@@ -1,50 +0,0 @@
-import { z } from "zod/v4";
-export declare const FileContentQuerySchema: z.ZodObject<{
-    id: z.ZodString;
-    mainResearchGoal: z.ZodString;
-    researchGoal: z.ZodString;
-    reasoning: z.ZodString;
-    owner: z.ZodString;
-    repo: z.ZodString;
-    path: z.ZodString;
-    branch: z.ZodOptional<z.ZodString>;
-    type: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-        file: "file";
-        directory: "directory";
-    }>>>;
-    fullContent: z.ZodDefault<z.ZodBoolean>;
-    startLine: z.ZodOptional<z.ZodNumber>;
-    endLine: z.ZodOptional<z.ZodNumber>;
-    matchString: z.ZodOptional<z.ZodString>;
-    matchStringContextLines: z.ZodDefault<z.ZodNumber>;
-    charOffset: z.ZodOptional<z.ZodNumber>;
-    charLength: z.ZodOptional<z.ZodNumber>;
-    forceRefresh: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-}, z.core.$strip>;
-export type FileContentQuery = z.infer<typeof FileContentQuerySchema>;
-export declare const FileContentBulkQuerySchema: z.ZodObject<{
-    queries: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        mainResearchGoal: z.ZodString;
-        researchGoal: z.ZodString;
-        reasoning: z.ZodString;
-        owner: z.ZodString;
-        repo: z.ZodString;
-        path: z.ZodString;
-        branch: z.ZodOptional<z.ZodString>;
-        type: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-            file: "file";
-            directory: "directory";
-        }>>>;
-        fullContent: z.ZodDefault<z.ZodBoolean>;
-        startLine: z.ZodOptional<z.ZodNumber>;
-        endLine: z.ZodOptional<z.ZodNumber>;
-        matchString: z.ZodOptional<z.ZodString>;
-        matchStringContextLines: z.ZodDefault<z.ZodNumber>;
-        charOffset: z.ZodOptional<z.ZodNumber>;
-        charLength: z.ZodOptional<z.ZodNumber>;
-        forceRefresh: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    }, z.core.$strip>>;
-    responseCharOffset: z.ZodOptional<z.ZodNumber>;
-    responseCharLength: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strict>;

package/dist/schemes/input/githubFetchContent.js

@@ -1 +0,0 @@
-import{z as e}from"zod/v4";import{BaseQuerySchema as t,createBulkQuerySchema as r}from"../base/baseSchema.js";import{GITHUB_FETCH_CONTENT as i}from"../helpers/githubSchemaHelpers.js";import{TOOL_NAMES as s}from"../helpers/schemaHelperFactory.js";const n=t.extend({owner:e.string().min(1).max(200).describe(i.scope.owner),repo:e.string().min(1).max(150).describe(i.scope.repo),path:e.string().describe(i.scope.path),branch:e.string().min(1).max(255).optional().describe(i.scope.branch),type:e.enum(["file","directory"]).optional().default("file").describe('Choose ONE: "file" (default) returns content inline; "directory" saves all files to disk and returns localPath. Directory mode requires ENABLE_LOCAL=true and ENABLE_CLONE=true, and is only available with the GitHub provider (not GitLab).'),fullContent:e.boolean().default(!1).describe(i.range.fullContent),startLine:e.number().int().min(1).optional().describe(i.range.startLine),endLine:e.number().int().min(1).optional().describe(i.range.endLine),matchString:e.string().max(2e3).optional().describe(i.range.matchString),matchStringContextLines:e.number().int().min(1).max(50).default(5).describe(i.range.matchStringContextLines),charOffset:e.number().int().min(0).optional().describe(i.pagination.charOffset),charLength:e.number().int().min(50).max(5e4).optional().describe(i.pagination.charLength),forceRefresh:e.boolean().optional().default(!1).describe('When true, bypass the cache and force a fresh fetch even if a valid cached copy exists. Only relevant for type "directory".')});export const FileContentQuerySchema=n.superRefine((e,t)=>{if("directory"===e.type)return!0===e.fullContent&&t.addIssue({code:"custom",message:'Parameter "fullContent" is not supported when type is "directory". Directory mode saves all files to disk.',path:["fullContent"]}),void 0!==e.startLine&&t.addIssue({code:"custom",message:'Parameter "startLine" is not supported when type is "directory". Directory mode saves all files to disk.',path:["startLine"]}),void 0!==e.endLine&&t.addIssue({code:"custom",message:'Parameter "endLine" is not supported when type is "directory". Directory mode saves all files to disk.',path:["endLine"]}),void 0!==e.matchString&&t.addIssue({code:"custom",message:'Parameter "matchString" is not supported when type is "directory". Directory mode saves all files to disk.',path:["matchString"]}),void 0!==e.charOffset&&t.addIssue({code:"custom",message:'Parameter "charOffset" is not supported when type is "directory". Directory mode saves all files to disk.',path:["charOffset"]}),void(void 0!==e.charLength&&t.addIssue({code:"custom",message:'Parameter "charLength" is not supported when type is "directory". Directory mode saves all files to disk.',path:["charLength"]}));e.fullContent&&(e.startLine||e.endLine||e.matchString)&&t.addIssue({code:"custom",message:i.validation.parameterConflict,path:["fullContent"]}),(e.startLine&&!e.endLine||!e.startLine&&e.endLine)&&t.addIssue({code:"custom",message:i.validation.parameterConflict,path:["startLine"]})});export const FileContentBulkQuerySchema=r(s.GITHUB_FETCH_CONTENT,FileContentQuerySchema);