@octocodeai/octocode-core 1.0.1 → 2.0.0

package/dist/schemas/extraTypes.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Auxiliary downstream shapes for provider mappers and finalisers.
+ * These types are too downstream-shaped to live in `src/types/index.ts`.
+ *
+ * Canonical data shapes (`LocalSearchCodeMatch`, `LocalSearchCodeFile`,
+ * `LocalFindFilesEntry`, etc.) live in `src/types/index.ts`. This file only carries:
+ *   - the `BaseQuery` meta + `BaseQueryLocal`,
+ *   - the *mutable, flat* `*ToolResult` envelopes built by `octocode-mcp`,
+ *   - provider-mapper shapes (`GitHubRepositoryOutput`,
+ *     `GitHubSearchRepositoriesData`).
+ */
+import type { CharPagination, LspRange, LspLocation, LspMode, Verbosity, PaginationInfo, LocalSearchCodeFile, LocalFindFilesEntry, GitHubRepositoryItem, GitHubPullRequestItem, GitHubSearchCodeGroup, GitHubFileContentData } from "../types/index.js";
+export interface BaseQuery {
+    id?: string;
+    mainResearchGoal?: string;
+    researchGoal?: string;
+    reasoning?: string;
+    verbosity?: Verbosity;
+}
+/** Local-tool flavour — adds the conventional `path` field. */
+export interface BaseQueryLocal extends BaseQuery {
+    path?: string;
+}
+export interface LspExactPosition {
+    uri: string;
+    line: number;
+    character: number;
+}
+export interface LspCallHierarchyItem {
+    name: string;
+    uri: string;
+    range: LspRange;
+    content?: string;
+}
+export interface LspIncomingCall {
+    from: LspCallHierarchyItem;
+    fromRanges?: LspRange[];
+}
+export interface LspOutgoingCall {
+    to: LspCallHierarchyItem;
+    fromRanges?: LspRange[];
+}
+interface BaseToolResult {
+    status?: "empty" | "error";
+    hints?: readonly string[] | string[];
+    warnings?: string[];
+    error?: string;
+    errorCode?: string;
+    rawResponseChars?: number;
+    /**
+     * Index signature — `octocode-mcp`'s bulk runner threads extra
+     * fields (`data`, provider-specific blobs) through the result
+     * envelope. Keep it permissive so structural assignment to its
+     * `ProcessedBulkResult` succeeds without a cast.
+     */
+    [key: string]: unknown;
+}
+export interface LocalSearchCodeToolResult extends BaseToolResult {
+    files?: LocalSearchCodeFile[];
+    pagination?: PaginationInfo;
+    searchEngine?: string;
+    charPagination?: CharPagination;
+}
+export interface LocalFindFilesToolResult extends BaseToolResult {
+    files?: LocalFindFilesEntry[];
+    pagination?: PaginationInfo;
+    charPagination?: CharPagination | PaginationInfo;
+}
+/** Char-range pair carried by `LocalGetFileContentToolResult.matchRanges`. */
+export interface MatchRange {
+    start: number;
+    end: number;
+}
+export interface LocalGetFileContentToolResult extends BaseToolResult {
+    content?: string;
+    totalLines?: number;
+    startLine?: number;
+    endLine?: number;
+    isPartial?: boolean;
+    matchRanges?: MatchRange[];
+    /**
+     * Pagination metadata — either a char-budget paginator
+     * (`CharPagination`) for fully rendered output, or a row-counter
+     * paginator when results are paginated by line/match index.
+     */
+    pagination?: CharPagination | PaginationInfo;
+    modified?: string;
+    lastModified?: string;
+    lastModifiedBy?: string;
+    filePath?: string;
+}
+export interface LocalViewStructureEntryFlat {
+    name: string;
+    type: "file" | "dir" | "link" | "directory" | "symlink";
+    path?: string;
+    depth?: number;
+    size?: number | string;
+    modified?: string;
+    permissions?: string;
+}
+export interface LocalViewStructureToolResult extends BaseToolResult {
+    entries?: LocalViewStructureEntryFlat[];
+    summary?: string | Record<string, unknown>;
+    pagination?: PaginationInfo;
+    charPagination?: CharPagination;
+}
+export interface LspGotoDefinitionToolResult extends BaseToolResult {
+    locations?: LspLocation[];
+    lspMode?: LspMode;
+}
+export interface LspFindReferencesToolResult extends BaseToolResult {
+    locations?: LspLocation[];
+    references?: LspLocation[];
+    pagination?: PaginationInfo;
+    lspMode?: LspMode;
+    charPagination?: CharPagination;
+}
+export interface LspCallHierarchyToolResult extends BaseToolResult {
+    item?: LspCallHierarchyItem;
+    incomingCalls?: LspIncomingCall[];
+    outgoingCalls?: LspOutgoingCall[];
+    direction?: "incoming" | "outgoing";
+    depth?: number;
+    pagination?: PaginationInfo;
+    lspMode?: LspMode;
+    charPagination?: CharPagination;
+}
+export interface GitHubRepoStructureDirectoryEntry {
+    files: string[];
+    folders: string[];
+}
+export interface GitHubDirectoryFileEntry {
+    path: string;
+    size: number;
+    type: string;
+}
+export interface GitHubSearchCodeToolResult extends BaseToolResult {
+    results?: GitHubSearchCodeGroup[];
+    pagination?: PaginationInfo;
+    outputPagination?: CharPagination;
+}
+export interface GitHubFetchContentToolResult extends BaseToolResult {
+    results?: GitHubFileContentData[];
+    pagination?: CharPagination;
+}
+export interface GitHubViewRepoStructureToolResult extends BaseToolResult {
+    resolvedBranch?: string;
+    branchFallback?: {
+        requestedBranch: string;
+        actualBranch: string;
+    };
+    structure?: Record<string, GitHubRepoStructureDirectoryEntry>;
+    summary?: {
+        totalFiles?: number;
+        totalFolders?: number;
+        truncated?: boolean;
+        filtered?: boolean;
+        originalCount?: number;
+    };
+    pagination?: PaginationInfo;
+}
+export interface GitHubSearchRepositoriesToolResult extends BaseToolResult {
+    repositories?: GitHubRepositoryItem[];
+    pagination?: PaginationInfo;
+}
+export interface GitHubSearchPullRequestsToolResult extends BaseToolResult {
+    pull_requests?: GitHubPullRequestItem[];
+    total_count?: number;
+    pagination?: PaginationInfo;
+    outputPagination?: {
+        charOffset: number;
+        charLength: number;
+        totalChars: number;
+        hasMore: boolean;
+        currentPage: number;
+        totalPages: number;
+    };
+}
+export interface GitHubRepositoryOutput {
+    owner: string;
+    repo: string;
+    defaultBranch: string;
+    stars: number;
+    description: string;
+    url: string;
+    createdAt: string;
+    updatedAt: string;
+    pushedAt: string;
+    visibility: "public" | "private" | "internal";
+    topics: string[];
+    forksCount: number;
+    openIssuesCount?: number;
+    language?: string;
+}
+/**
+ * Provider-facing repos-search result. Mirrors `GitHubSearchReposData`
+ * but uses `GitHubRepositoryOutput` (the structurally rich shape with
+ * `owner`/`repo` split, provider metadata) instead of the simpler
+ * `GitHubRepositoryItem`.
+ */
+export interface GitHubSearchRepositoriesData {
+    repositories: GitHubRepositoryOutput[];
+    pagination?: PaginationInfo;
+}
+export {};

package/dist/schemas/index.d.ts

@@ -0,0 +1,431 @@
+/**
+ * Zod input schemas — the canonical schemas every tool exposes to MCP
+ * clients. The mcp-host overlay extends these with default pagination
+ * values, verbosity, and meta fields (id/researchGoal/etc.).
+ *
+ * All schemas are intentionally loose at this layer:
+ *   - String enums use `z.string()` so the overlay can tighten via
+ *     `.extend({ field: z.enum([...]) })` without conflict.
+ *   - Numbers are unbounded — bounds are applied by the overlay.
+ *   - Optional everywhere except `pattern` / `path` / `uri` / etc.
+ *
+ * The overlay calls `.extend()`, `.shape`, `.element` on these schemas,
+ * so they must remain `z.ZodObject<...>` shapes (no transforms / unions
+ * at the top level unless documented).
+ */
+import { z } from "zod/v4";
+export declare const RipgrepQuerySchema: z.ZodObject<{
+    pattern: z.ZodString;
+    path: z.ZodString;
+    mode: z.ZodOptional<z.ZodString>;
+    fixedString: z.ZodOptional<z.ZodBoolean>;
+    perlRegex: z.ZodOptional<z.ZodBoolean>;
+    smartCase: z.ZodOptional<z.ZodBoolean>;
+    caseInsensitive: z.ZodOptional<z.ZodBoolean>;
+    caseSensitive: z.ZodOptional<z.ZodBoolean>;
+    wholeWord: z.ZodOptional<z.ZodBoolean>;
+    invertMatch: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodOptional<z.ZodString>;
+    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>;
+    followSymlinks: z.ZodOptional<z.ZodBoolean>;
+    filesOnly: z.ZodOptional<z.ZodBoolean>;
+    filesWithoutMatch: z.ZodOptional<z.ZodBoolean>;
+    count: z.ZodOptional<z.ZodBoolean>;
+    countMatches: z.ZodOptional<z.ZodBoolean>;
+    contextLines: z.ZodOptional<z.ZodNumber>;
+    beforeContext: z.ZodOptional<z.ZodNumber>;
+    afterContext: z.ZodOptional<z.ZodNumber>;
+    matchContentLength: z.ZodOptional<z.ZodNumber>;
+    maxMatchesPerFile: z.ZodOptional<z.ZodNumber>;
+    maxFiles: z.ZodOptional<z.ZodNumber>;
+    filesPerPage: z.ZodOptional<z.ZodNumber>;
+    filePageNumber: z.ZodOptional<z.ZodNumber>;
+    matchesPerPage: z.ZodOptional<z.ZodNumber>;
+    multiline: z.ZodOptional<z.ZodBoolean>;
+    multilineDotall: z.ZodOptional<z.ZodBoolean>;
+    binaryFiles: z.ZodOptional<z.ZodString>;
+    includeStats: z.ZodOptional<z.ZodBoolean>;
+    encoding: z.ZodOptional<z.ZodString>;
+    sort: z.ZodOptional<z.ZodString>;
+    sortReverse: z.ZodOptional<z.ZodBoolean>;
+    noMessages: z.ZodOptional<z.ZodBoolean>;
+    lineRegexp: z.ZodOptional<z.ZodBoolean>;
+    passthru: z.ZodOptional<z.ZodBoolean>;
+    debug: z.ZodOptional<z.ZodBoolean>;
+    showFileLastModified: z.ZodOptional<z.ZodBoolean>;
+    noUnicode: z.ZodOptional<z.ZodBoolean>;
+    threads: z.ZodOptional<z.ZodNumber>;
+    mmap: z.ZodOptional<z.ZodBoolean>;
+    verbosity: z.ZodOptional<z.ZodEnum<{
+        basic: import("../types/index.js").Verbosity.Basic;
+        compact: import("../types/index.js").Verbosity.Compact;
+        concise: import("../types/index.js").Verbosity.Concise;
+    }>>;
+    id: z.ZodOptional<z.ZodString>;
+    mainResearchGoal: z.ZodOptional<z.ZodString>;
+    researchGoal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const FindFilesQuerySchema: z.ZodObject<{
+    path: z.ZodString;
+    maxDepth: z.ZodOptional<z.ZodNumber>;
+    minDepth: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodOptional<z.ZodString>;
+    iname: z.ZodOptional<z.ZodString>;
+    names: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    pathPattern: z.ZodOptional<z.ZodString>;
+    regex: z.ZodOptional<z.ZodString>;
+    regexType: z.ZodOptional<z.ZodString>;
+    type: 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>;
+    filesPerPage: z.ZodOptional<z.ZodNumber>;
+    filePageNumber: z.ZodOptional<z.ZodNumber>;
+    showFileLastModified: z.ZodOptional<z.ZodBoolean>;
+    charOffset: z.ZodOptional<z.ZodNumber>;
+    charLength: z.ZodOptional<z.ZodNumber>;
+    sortBy: z.ZodOptional<z.ZodString>;
+    verbosity: z.ZodOptional<z.ZodEnum<{
+        basic: import("../types/index.js").Verbosity.Basic;
+        compact: import("../types/index.js").Verbosity.Compact;
+        concise: import("../types/index.js").Verbosity.Concise;
+    }>>;
+    id: z.ZodOptional<z.ZodString>;
+    mainResearchGoal: z.ZodOptional<z.ZodString>;
+    researchGoal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ViewStructureQuerySchema: z.ZodObject<{
+    path: z.ZodString;
+    details: z.ZodOptional<z.ZodBoolean>;
+    hidden: z.ZodOptional<z.ZodBoolean>;
+    humanReadable: z.ZodOptional<z.ZodBoolean>;
+    sortBy: z.ZodOptional<z.ZodString>;
+    reverse: z.ZodOptional<z.ZodBoolean>;
+    entriesPerPage: z.ZodOptional<z.ZodNumber>;
+    entryPageNumber: z.ZodOptional<z.ZodNumber>;
+    pattern: z.ZodOptional<z.ZodString>;
+    directoriesOnly: z.ZodOptional<z.ZodBoolean>;
+    filesOnly: z.ZodOptional<z.ZodBoolean>;
+    extension: z.ZodOptional<z.ZodString>;
+    extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    depth: z.ZodOptional<z.ZodNumber>;
+    recursive: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    charOffset: z.ZodOptional<z.ZodNumber>;
+    charLength: z.ZodOptional<z.ZodNumber>;
+    showFileLastModified: z.ZodOptional<z.ZodBoolean>;
+    verbosity: z.ZodOptional<z.ZodEnum<{
+        basic: import("../types/index.js").Verbosity.Basic;
+        compact: import("../types/index.js").Verbosity.Compact;
+        concise: import("../types/index.js").Verbosity.Concise;
+    }>>;
+    id: z.ZodOptional<z.ZodString>;
+    mainResearchGoal: z.ZodOptional<z.ZodString>;
+    researchGoal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const FetchContentQuerySchema: z.ZodObject<{
+    path: z.ZodString;
+    fullContent: z.ZodOptional<z.ZodBoolean>;
+    matchString: z.ZodOptional<z.ZodString>;
+    matchStringContextLines: z.ZodOptional<z.ZodNumber>;
+    matchStringIsRegex: z.ZodOptional<z.ZodBoolean>;
+    matchStringCaseSensitive: z.ZodOptional<z.ZodBoolean>;
+    charOffset: z.ZodOptional<z.ZodNumber>;
+    charLength: z.ZodOptional<z.ZodNumber>;
+    startLine: z.ZodOptional<z.ZodNumber>;
+    endLine: z.ZodOptional<z.ZodNumber>;
+    verbosity: z.ZodOptional<z.ZodEnum<{
+        basic: import("../types/index.js").Verbosity.Basic;
+        compact: import("../types/index.js").Verbosity.Compact;
+        concise: import("../types/index.js").Verbosity.Concise;
+    }>>;
+    id: z.ZodOptional<z.ZodString>;
+    mainResearchGoal: z.ZodOptional<z.ZodString>;
+    researchGoal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const FileContentQuerySchema: 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>;
+    matchStringContextLines: z.ZodOptional<z.ZodNumber>;
+    matchStringIsRegex: z.ZodOptional<z.ZodBoolean>;
+    matchStringCaseSensitive: z.ZodOptional<z.ZodBoolean>;
+    charOffset: z.ZodOptional<z.ZodNumber>;
+    charLength: z.ZodOptional<z.ZodNumber>;
+    forceRefresh: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodOptional<z.ZodString>;
+    verbosity: z.ZodOptional<z.ZodEnum<{
+        basic: import("../types/index.js").Verbosity.Basic;
+        compact: import("../types/index.js").Verbosity.Compact;
+        concise: import("../types/index.js").Verbosity.Concise;
+    }>>;
+    id: z.ZodOptional<z.ZodString>;
+    mainResearchGoal: z.ZodOptional<z.ZodString>;
+    researchGoal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const GitHubCodeSearchQuerySchema: z.ZodObject<{
+    keywordsToSearch: 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>;
+    match: z.ZodOptional<z.ZodEnum<{
+        file: "file";
+        path: "path";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    page: z.ZodOptional<z.ZodNumber>;
+    verbosity: z.ZodOptional<z.ZodEnum<{
+        basic: import("../types/index.js").Verbosity.Basic;
+        compact: import("../types/index.js").Verbosity.Compact;
+        concise: import("../types/index.js").Verbosity.Concise;
+    }>>;
+    id: z.ZodOptional<z.ZodString>;
+    mainResearchGoal: z.ZodOptional<z.ZodString>;
+    researchGoal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const GitHubReposSearchSingleQuerySchema: z.ZodObject<{
+    keywordsToSearch: 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<{
+        name: "name";
+        description: "description";
+        readme: "readme";
+    }>>>;
+    sort: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    page: z.ZodOptional<z.ZodNumber>;
+    verbosity: z.ZodOptional<z.ZodEnum<{
+        basic: import("../types/index.js").Verbosity.Basic;
+        compact: import("../types/index.js").Verbosity.Compact;
+        concise: import("../types/index.js").Verbosity.Concise;
+    }>>;
+    id: z.ZodOptional<z.ZodString>;
+    mainResearchGoal: z.ZodOptional<z.ZodString>;
+    researchGoal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const GitHubPullRequestSearchQuerySchema: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    prNumber: z.ZodOptional<z.ZodNumber>;
+    owner: z.ZodOptional<z.ZodString>;
+    repo: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodString>;
+    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>]>>;
+    "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>;
+    merged: z.ZodOptional<z.ZodBoolean>;
+    matchScope: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sort: z.ZodOptional<z.ZodString>;
+    order: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    page: z.ZodOptional<z.ZodNumber>;
+    withComments: z.ZodOptional<z.ZodBoolean>;
+    withCommits: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodOptional<z.ZodString>;
+    charOffset: z.ZodOptional<z.ZodNumber>;
+    charLength: z.ZodOptional<z.ZodNumber>;
+    partialContentMetadata: 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>>>;
+    verbosity: z.ZodOptional<z.ZodEnum<{
+        basic: import("../types/index.js").Verbosity.Basic;
+        compact: import("../types/index.js").Verbosity.Compact;
+        concise: import("../types/index.js").Verbosity.Concise;
+    }>>;
+    id: z.ZodOptional<z.ZodString>;
+    mainResearchGoal: z.ZodOptional<z.ZodString>;
+    researchGoal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const GitHubViewRepoStructureQuerySchema: z.ZodObject<{
+    owner: z.ZodString;
+    repo: z.ZodString;
+    branch: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    depth: z.ZodOptional<z.ZodNumber>;
+    entriesPerPage: z.ZodOptional<z.ZodNumber>;
+    entryPageNumber: z.ZodOptional<z.ZodNumber>;
+    verbosity: z.ZodOptional<z.ZodEnum<{
+        basic: import("../types/index.js").Verbosity.Basic;
+        compact: import("../types/index.js").Verbosity.Compact;
+        concise: import("../types/index.js").Verbosity.Concise;
+    }>>;
+    id: z.ZodOptional<z.ZodString>;
+    mainResearchGoal: z.ZodOptional<z.ZodString>;
+    researchGoal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const NpmPackageQuerySchema: z.ZodObject<{
+    ecosystem: z.ZodOptional<z.ZodLiteral<"npm">>;
+    name: z.ZodString;
+    searchLimit: z.ZodOptional<z.ZodNumber>;
+    npmFetchMetadata: z.ZodOptional<z.ZodBoolean>;
+    verbosity: z.ZodOptional<z.ZodEnum<{
+        basic: import("../types/index.js").Verbosity.Basic;
+        compact: import("../types/index.js").Verbosity.Compact;
+        concise: import("../types/index.js").Verbosity.Concise;
+    }>>;
+    id: z.ZodOptional<z.ZodString>;
+    mainResearchGoal: z.ZodOptional<z.ZodString>;
+    researchGoal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const CloneRepoQuerySchema: z.ZodObject<{
+    owner: z.ZodString;
+    repo: z.ZodString;
+    branch: z.ZodOptional<z.ZodString>;
+    sparse_path: z.ZodOptional<z.ZodString>;
+    forceRefresh: z.ZodOptional<z.ZodBoolean>;
+    charOffset: z.ZodOptional<z.ZodNumber>;
+    charLength: z.ZodOptional<z.ZodNumber>;
+    verbosity: z.ZodOptional<z.ZodEnum<{
+        basic: import("../types/index.js").Verbosity.Basic;
+        compact: import("../types/index.js").Verbosity.Compact;
+        concise: import("../types/index.js").Verbosity.Concise;
+    }>>;
+    id: z.ZodOptional<z.ZodString>;
+    mainResearchGoal: z.ZodOptional<z.ZodString>;
+    researchGoal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const BulkCloneRepoSchema: z.ZodObject<{
+    queries: z.ZodArray<z.ZodObject<{
+        owner: z.ZodString;
+        repo: z.ZodString;
+        branch: z.ZodOptional<z.ZodString>;
+        sparse_path: z.ZodOptional<z.ZodString>;
+        forceRefresh: z.ZodOptional<z.ZodBoolean>;
+        charOffset: z.ZodOptional<z.ZodNumber>;
+        charLength: z.ZodOptional<z.ZodNumber>;
+        verbosity: z.ZodOptional<z.ZodEnum<{
+            basic: import("../types/index.js").Verbosity.Basic;
+            compact: import("../types/index.js").Verbosity.Compact;
+            concise: import("../types/index.js").Verbosity.Concise;
+        }>>;
+        id: z.ZodOptional<z.ZodString>;
+        mainResearchGoal: z.ZodOptional<z.ZodString>;
+        researchGoal: z.ZodOptional<z.ZodString>;
+        reasoning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const LSPGotoDefinitionQuerySchema: z.ZodObject<{
+    contextLines: z.ZodOptional<z.ZodNumber>;
+    charOffset: z.ZodOptional<z.ZodNumber>;
+    charLength: z.ZodOptional<z.ZodNumber>;
+    verbosity: z.ZodOptional<z.ZodEnum<{
+        basic: import("../types/index.js").Verbosity.Basic;
+        compact: import("../types/index.js").Verbosity.Compact;
+        concise: import("../types/index.js").Verbosity.Concise;
+    }>>;
+    uri: z.ZodString;
+    symbolName: z.ZodString;
+    lineHint: z.ZodNumber;
+    orderHint: 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>;
+export declare const LSPFindReferencesQuerySchema: z.ZodObject<{
+    includeDeclaration: z.ZodOptional<z.ZodBoolean>;
+    contextLines: z.ZodOptional<z.ZodNumber>;
+    referencesPerPage: z.ZodOptional<z.ZodNumber>;
+    page: z.ZodOptional<z.ZodNumber>;
+    groupByFile: z.ZodOptional<z.ZodBoolean>;
+    includePattern: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    excludePattern: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    charOffset: z.ZodOptional<z.ZodNumber>;
+    charLength: z.ZodOptional<z.ZodNumber>;
+    verbosity: z.ZodOptional<z.ZodEnum<{
+        basic: import("../types/index.js").Verbosity.Basic;
+        compact: import("../types/index.js").Verbosity.Compact;
+        concise: import("../types/index.js").Verbosity.Concise;
+    }>>;
+    uri: z.ZodString;
+    symbolName: z.ZodString;
+    lineHint: z.ZodNumber;
+    orderHint: 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>;
+export declare const LSPCallHierarchyQuerySchema: z.ZodObject<{
+    direction: z.ZodEnum<{
+        incoming: "incoming";
+        outgoing: "outgoing";
+    }>;
+    depth: z.ZodOptional<z.ZodNumber>;
+    contextLines: z.ZodOptional<z.ZodNumber>;
+    callsPerPage: z.ZodOptional<z.ZodNumber>;
+    page: z.ZodOptional<z.ZodNumber>;
+    charOffset: z.ZodOptional<z.ZodNumber>;
+    charLength: z.ZodOptional<z.ZodNumber>;
+    verbosity: z.ZodOptional<z.ZodEnum<{
+        basic: import("../types/index.js").Verbosity.Basic;
+        compact: import("../types/index.js").Verbosity.Compact;
+        concise: import("../types/index.js").Verbosity.Concise;
+    }>>;
+    uri: z.ZodString;
+    symbolName: z.ZodString;
+    lineHint: z.ZodNumber;
+    orderHint: 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>;

package/dist/schemas/index.js

@@ -0,0 +1 @@
+import{z as o}from"zod/v4";import{VERBOSITY_VALUES as n}from"../types/index.js";const t=o.enum([...n]).optional(),e=o.array(o.string()).optional(),i={id:o.string().optional(),mainResearchGoal:o.string().optional(),researchGoal:o.string().optional(),reasoning:o.string().optional()};export const RipgrepQuerySchema=o.object({...i,pattern:o.string(),path:o.string(),mode:o.string().optional(),fixedString:o.boolean().optional(),perlRegex:o.boolean().optional(),smartCase:o.boolean().optional(),caseInsensitive:o.boolean().optional(),caseSensitive:o.boolean().optional(),wholeWord:o.boolean().optional(),invertMatch:o.boolean().optional(),type:o.string().optional(),include:e,exclude:e,excludeDir:e,noIgnore:o.boolean().optional(),hidden:o.boolean().optional(),followSymlinks:o.boolean().optional(),filesOnly:o.boolean().optional(),filesWithoutMatch:o.boolean().optional(),count:o.boolean().optional(),countMatches:o.boolean().optional(),contextLines:o.number().int().optional(),beforeContext:o.number().int().optional(),afterContext:o.number().int().optional(),matchContentLength:o.number().int().optional(),maxMatchesPerFile:o.number().int().optional(),maxFiles:o.number().int().optional(),filesPerPage:o.number().int().optional(),filePageNumber:o.number().int().optional(),matchesPerPage:o.number().int().optional(),multiline:o.boolean().optional(),multilineDotall:o.boolean().optional(),binaryFiles:o.string().optional(),includeStats:o.boolean().optional(),encoding:o.string().optional(),sort:o.string().optional(),sortReverse:o.boolean().optional(),noMessages:o.boolean().optional(),lineRegexp:o.boolean().optional(),passthru:o.boolean().optional(),debug:o.boolean().optional(),showFileLastModified:o.boolean().optional(),noUnicode:o.boolean().optional(),threads:o.number().int().optional(),mmap:o.boolean().optional(),verbosity:t});export const FindFilesQuerySchema=o.object({...i,path:o.string(),maxDepth:o.number().int().optional(),minDepth:o.number().int().optional(),name:o.string().optional(),iname:o.string().optional(),names:e,pathPattern:o.string().optional(),regex:o.string().optional(),regexType:o.string().optional(),type:o.string().optional(),empty:o.boolean().optional(),modifiedWithin:o.string().optional(),modifiedBefore:o.string().optional(),accessedWithin:o.string().optional(),sizeGreater:o.string().optional(),sizeLess:o.string().optional(),permissions:o.string().optional(),executable:o.boolean().optional(),readable:o.boolean().optional(),writable:o.boolean().optional(),excludeDir:e,limit:o.number().int().optional(),details:o.boolean().optional(),filesPerPage:o.number().int().optional(),filePageNumber:o.number().int().optional(),showFileLastModified:o.boolean().optional(),charOffset:o.number().int().optional(),charLength:o.number().int().optional(),sortBy:o.string().optional(),verbosity:t});export const ViewStructureQuerySchema=o.object({...i,path:o.string(),details:o.boolean().optional(),hidden:o.boolean().optional(),humanReadable:o.boolean().optional(),sortBy:o.string().optional(),reverse:o.boolean().optional(),entriesPerPage:o.number().int().optional(),entryPageNumber:o.number().int().optional(),pattern:o.string().optional(),directoriesOnly:o.boolean().optional(),filesOnly:o.boolean().optional(),extension:o.string().optional(),extensions:e,depth:o.number().int().optional(),recursive:o.boolean().optional(),limit:o.number().int().optional(),charOffset:o.number().int().optional(),charLength:o.number().int().optional(),showFileLastModified:o.boolean().optional(),verbosity:t});export const FetchContentQuerySchema=o.object({...i,path:o.string(),fullContent:o.boolean().optional(),matchString:o.string().optional(),matchStringContextLines:o.number().int().optional(),matchStringIsRegex:o.boolean().optional(),matchStringCaseSensitive:o.boolean().optional(),charOffset:o.number().int().optional(),charLength:o.number().int().optional(),startLine:o.number().int().optional(),endLine:o.number().int().optional(),verbosity:t});export const FileContentQuerySchema=o.object({...i,owner:o.string(),repo:o.string(),branch:o.string().optional(),path:o.string(),startLine:o.number().int().optional(),endLine:o.number().int().optional(),fullContent:o.boolean().optional(),matchString:o.string().optional(),matchStringContextLines:o.number().int().optional(),matchStringIsRegex:o.boolean().optional(),matchStringCaseSensitive:o.boolean().optional(),charOffset:o.number().int().optional(),charLength:o.number().int().optional(),forceRefresh:o.boolean().optional(),type:o.string().optional(),verbosity:t});export const GitHubCodeSearchQuerySchema=o.object({...i,keywordsToSearch:e,owner:o.string().optional(),repo:o.string().optional(),extension:o.string().optional(),filename:o.string().optional(),path:o.string().optional(),match:o.enum(["file","path"]).optional(),limit:o.number().int().optional(),page:o.number().int().optional(),verbosity:t});export const GitHubReposSearchSingleQuerySchema=o.object({...i,keywordsToSearch:e,topicsToSearch:e,language:o.string().optional(),owner:o.string().optional(),stars:o.string().optional(),size:o.string().optional(),created:o.string().optional(),updated:o.string().optional(),match:o.array(o.enum(["name","description","readme"])).optional(),sort:o.string().optional(),limit:o.number().int().optional(),page:o.number().int().optional(),verbosity:t});export const GitHubPullRequestSearchQuerySchema=o.object({...i,query:o.string().optional(),prNumber:o.number().int().optional(),owner:o.string().optional(),repo:o.string().optional(),state:o.string().optional(),assignee:o.string().optional(),author:o.string().optional(),commenter:o.string().optional(),involves:o.string().optional(),mentions:o.string().optional(),"review-requested":o.string().optional(),"reviewed-by":o.string().optional(),label:o.union([o.string(),o.array(o.string())]).optional(),"no-label":o.boolean().optional(),"no-milestone":o.boolean().optional(),"no-project":o.boolean().optional(),"no-assignee":o.boolean().optional(),head:o.string().optional(),base:o.string().optional(),created:o.string().optional(),updated:o.string().optional(),closed:o.string().optional(),"merged-at":o.string().optional(),comments:o.string().optional(),reactions:o.string().optional(),interactions:o.string().optional(),draft:o.boolean().optional(),merged:o.boolean().optional(),matchScope:e,sort:o.string().optional(),order:o.string().optional(),limit:o.number().int().optional(),page:o.number().int().optional(),withComments:o.boolean().optional(),withCommits:o.boolean().optional(),type:o.string().optional(),charOffset:o.number().int().optional(),charLength:o.number().int().optional(),partialContentMetadata:o.array(o.object({file:o.string(),additions:o.array(o.number().int()).optional(),deletions:o.array(o.number().int()).optional()})).optional(),verbosity:t});export const GitHubViewRepoStructureQuerySchema=o.object({...i,owner:o.string(),repo:o.string(),branch:o.string().optional(),path:o.string().optional(),depth:o.number().int().optional(),entriesPerPage:o.number().int().optional(),entryPageNumber:o.number().int().optional(),verbosity:t});export const NpmPackageQuerySchema=o.object({...i,ecosystem:o.literal("npm").optional(),name:o.string(),searchLimit:o.number().int().optional(),npmFetchMetadata:o.boolean().optional(),verbosity:t});export const CloneRepoQuerySchema=o.object({...i,owner:o.string(),repo:o.string(),branch:o.string().optional(),sparse_path:o.string().optional(),forceRefresh:o.boolean().optional(),charOffset:o.number().int().optional(),charLength:o.number().int().optional(),verbosity:t});export const BulkCloneRepoSchema=o.object({queries:o.array(CloneRepoQuerySchema).min(1)});const a={...i,uri:o.string(),symbolName:o.string(),lineHint:o.number().int(),orderHint:o.number().int().optional()};export const LSPGotoDefinitionQuerySchema=o.object({...a,contextLines:o.number().int().optional(),charOffset:o.number().int().optional(),charLength:o.number().int().optional(),verbosity:t});export const LSPFindReferencesQuerySchema=o.object({...a,includeDeclaration:o.boolean().optional(),contextLines:o.number().int().optional(),referencesPerPage:o.number().int().optional(),page:o.number().int().optional(),groupByFile:o.boolean().optional(),includePattern:e,excludePattern:e,charOffset:o.number().int().optional(),charLength:o.number().int().optional(),verbosity:t});export const LSPCallHierarchyQuerySchema=o.object({...a,direction:o.enum(["incoming","outgoing"]),depth:o.number().int().optional(),contextLines:o.number().int().optional(),callsPerPage:o.number().int().optional(),page:o.number().int().optional(),charOffset:o.number().int().optional(),charLength:o.number().int().optional(),verbosity:t});