@octocodeai/octocode-tools-core 16.2.0

package/dist/tools/github_search_pull_requests/scheme.d.ts

@@ -0,0 +1,224 @@
+import { z } from 'zod';
+export declare const GitHubPullRequestSearchQueryLocalSchema: 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>;
+export declare const GitHubPullRequestSearchBulkQueryLocalSchema: z.ZodObject<{
+    responseCharOffset: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    responseCharLength: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    queries: z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+}, z.core.$strip>;
+export declare const GitHubSearchPullRequestsOutputLocalSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodEnum<{
+        empty: import("@octocodeai/octocode-core/types").ToolStatus.Empty;
+        error: import("@octocodeai/octocode-core/types").ToolStatus.Error;
+    }>>;
+    data: z.ZodOptional<z.ZodObject<{
+        pull_requests: z.ZodArray<z.ZodObject<{
+            number: z.ZodNumber;
+            title: z.ZodString;
+            url: z.ZodOptional<z.ZodString>;
+            state: z.ZodOptional<z.ZodString>;
+            draft: z.ZodOptional<z.ZodBoolean>;
+            merged: z.ZodOptional<z.ZodBoolean>;
+            created_at: z.ZodOptional<z.ZodString>;
+            updated_at: z.ZodOptional<z.ZodString>;
+            closed_at: z.ZodOptional<z.ZodString>;
+            merged_at: z.ZodOptional<z.ZodString>;
+            author: z.ZodOptional<z.ZodString>;
+            head_ref: z.ZodOptional<z.ZodString>;
+            base_ref: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        total_count: z.ZodOptional<z.ZodNumber>;
+        pagination: z.ZodOptional<z.ZodObject<{
+            currentPage: z.ZodNumber;
+            totalPages: z.ZodNumber;
+            hasMore: z.ZodBoolean;
+            perPage: z.ZodOptional<z.ZodNumber>;
+            totalMatches: z.ZodOptional<z.ZodNumber>;
+            totalFiles: z.ZodOptional<z.ZodNumber>;
+            totalEntries: z.ZodOptional<z.ZodNumber>;
+            totalResults: z.ZodOptional<z.ZodNumber>;
+            entriesPerPage: z.ZodOptional<z.ZodNumber>;
+            filesPerPage: z.ZodOptional<z.ZodNumber>;
+            matchesPerPage: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    pull_requests: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        number: z.ZodNumber;
+        title: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        state: z.ZodOptional<z.ZodString>;
+        draft: z.ZodOptional<z.ZodBoolean>;
+        merged: z.ZodOptional<z.ZodBoolean>;
+        created_at: z.ZodOptional<z.ZodString>;
+        updated_at: z.ZodOptional<z.ZodString>;
+        closed_at: z.ZodOptional<z.ZodString>;
+        merged_at: z.ZodOptional<z.ZodString>;
+        author: z.ZodOptional<z.ZodString>;
+        head_ref: z.ZodOptional<z.ZodString>;
+        base_ref: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    pagination: z.ZodOptional<z.ZodObject<{
+        currentPage: z.ZodNumber;
+        totalPages: z.ZodNumber;
+        hasMore: z.ZodBoolean;
+        perPage: z.ZodOptional<z.ZodNumber>;
+        totalMatches: z.ZodOptional<z.ZodNumber>;
+        totalFiles: z.ZodOptional<z.ZodNumber>;
+        totalEntries: z.ZodOptional<z.ZodNumber>;
+        totalResults: z.ZodOptional<z.ZodNumber>;
+        entriesPerPage: z.ZodOptional<z.ZodNumber>;
+        filesPerPage: z.ZodOptional<z.ZodNumber>;
+        matchesPerPage: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        kind: z.ZodString;
+    }, z.core.$loose>]>>>;
+    error: z.ZodOptional<z.ZodString>;
+    hints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    base: z.ZodOptional<z.ZodString>;
+    shared: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    responsePagination: z.ZodOptional<z.ZodObject<{
+        currentPage: z.ZodNumber;
+        totalPages: z.ZodNumber;
+        hasMore: z.ZodBoolean;
+        charOffset: z.ZodNumber;
+        charLength: z.ZodNumber;
+        totalChars: z.ZodNumber;
+        nextCharOffset: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    results: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodString>;
+        data: z.ZodOptional<z.ZodObject<{
+            pull_requests: z.ZodOptional<z.ZodArray<z.ZodObject<{}, z.core.$loose>>>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;

package/dist/tools/github_search_pull_requests/types.d.ts

@@ -0,0 +1,120 @@
+import type { PaginationInfo } from '../../types/toolResults.js';
+export interface GitHubPullRequestApiItem {
+    number: number;
+    title: string;
+    url: string;
+    state: 'open' | 'closed';
+    draft: boolean;
+    merged: boolean;
+    created_at: string;
+    updated_at: string;
+    closed_at?: string;
+    merged_at?: string;
+    author: string;
+    assignees?: string[];
+    labels?: Array<{
+        id: number;
+        name: string;
+        color: string;
+        description?: string;
+    }>;
+    head_ref: string;
+    head_sha?: string;
+    base_ref: string;
+    base_sha?: string;
+    body?: string | null;
+    body_pagination?: {
+        charOffset: number;
+        charLength: number;
+        totalChars: number;
+        hasMore: boolean;
+        nextCharOffset?: number;
+    };
+    comments?: number;
+    comment_details_breakdown?: {
+        inline_review: number;
+        discussion: number;
+    };
+    commits?: number;
+    additions?: number;
+    deletions?: number;
+    changed_files?: number;
+    comment_details?: Array<{
+        id: string;
+        user: string;
+        body: string;
+        created_at: string;
+        updated_at: string;
+        commentType?: 'discussion' | 'review_inline';
+        path?: string;
+        line?: number;
+        in_reply_to_id?: number | null;
+        body_pagination?: {
+            charOffset: number;
+            charLength: number;
+            totalChars: number;
+            hasMore: boolean;
+            nextCharOffset?: number;
+        };
+    }>;
+    comment_details_shown?: number;
+    comment_details_total?: number;
+    comment_details_paginated?: boolean;
+    file_changes?: Array<{
+        filename: string;
+        status: string;
+        additions: number;
+        deletions: number;
+        changes?: number;
+        patch?: string;
+    }>;
+    reviews?: Array<{
+        id: string;
+        user: string;
+        state: string;
+        body: string;
+        submitted_at?: string;
+        commit_id?: string;
+    }>;
+    commit_details?: Array<{
+        sha: string;
+        message: string;
+        author: string;
+        date: string;
+        files: Array<{
+            filename: string;
+            status: string;
+            additions: number;
+            deletions: number;
+            changes?: number;
+            patch?: string;
+        }>;
+    }>;
+    _sanitization_warnings?: string[];
+}
+export interface GitHubPullRequestSearchApiData {
+    owner?: string;
+    repo?: string;
+    pull_requests?: GitHubPullRequestApiItem[];
+    total_count?: number;
+    incomplete_results?: boolean;
+    effectiveQuery?: string;
+    pagination?: PaginationInfo;
+    outputPagination?: {
+        charOffset: number;
+        charLength: number;
+        totalChars: number;
+        hasMore: boolean;
+        currentPage: number;
+        totalPages: number;
+    };
+}
+export interface GitHubPullRequestSearchApiResult extends GitHubPullRequestSearchApiData {
+    error?: string;
+    status?: number;
+    hints?: string[];
+    rateLimitRemaining?: number;
+    rateLimitReset?: number;
+    retryAfter?: number;
+    rawResponseChars?: number;
+}

package/dist/tools/github_search_repos/execution.d.ts

@@ -0,0 +1,17 @@
+import { type CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { z } from 'zod';
+import type { GitHubReposSearchSingleQuerySchema } from '@octocodeai/octocode-core/schemas';
+import type { GitHubRepositoryOutput } from '@octocodeai/octocode-core/extra-types';
+type GitHubReposSearchSingleQuery = z.infer<typeof GitHubReposSearchSingleQuerySchema>;
+import type { ToolExecutionArgs, WithOptionalMeta } from '../../types/execution.js';
+type RepositorySearchExtraFields = {
+    archived?: boolean;
+    visibility?: 'public' | 'private';
+    forks?: string;
+    license?: string;
+    goodFirstIssues?: string;
+};
+type PartialReposSearchQuery = WithOptionalMeta<GitHubReposSearchSingleQuery> & RepositorySearchExtraFields;
+export declare function formatRepoLine(repo: GitHubRepositoryOutput): string;
+export declare function searchMultipleGitHubRepos(args: ToolExecutionArgs<PartialReposSearchQuery>): Promise<CallToolResult>;
+export {};

package/dist/tools/github_search_repos/hints.d.ts

@@ -0,0 +1,2 @@
+import type { ToolHintGenerators } from '../../types/metadata.js';
+export declare const hints: ToolHintGenerators;

package/dist/tools/github_search_repos/scheme.d.ts

@@ -0,0 +1,96 @@
+import { z } from 'zod';
+export declare const GitHubReposSearchSingleQueryLocalSchema: 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>;
+export declare const GitHubReposSearchBulkQueryLocalSchema: z.ZodObject<{
+    responseCharOffset: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    responseCharLength: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    queries: z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+}, z.core.$strip>;
+export declare const GitHubSearchRepositoriesOutputLocalSchema: z.ZodObject<{
+    results: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodString>;
+        data: z.ZodOptional<z.ZodObject<{
+            repositories: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                owner: z.ZodString;
+                repo: z.ZodString;
+                stars: z.ZodOptional<z.ZodNumber>;
+                forks: z.ZodOptional<z.ZodNumber>;
+                openIssuesCount: z.ZodOptional<z.ZodNumber>;
+                language: z.ZodOptional<z.ZodString>;
+                license: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+                homepage: z.ZodOptional<z.ZodString>;
+                pushedAt: z.ZodOptional<z.ZodString>;
+                createdAt: z.ZodOptional<z.ZodString>;
+                defaultBranch: z.ZodOptional<z.ZodString>;
+                topics: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                visibility: z.ZodOptional<z.ZodString>;
+                url: z.ZodOptional<z.ZodString>;
+                updatedAt: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>]>>>;
+            pagination: z.ZodOptional<z.ZodObject<{
+                currentPage: z.ZodNumber;
+                totalPages: z.ZodNumber;
+                hasMore: z.ZodBoolean;
+                perPage: z.ZodOptional<z.ZodNumber>;
+                totalMatches: z.ZodOptional<z.ZodNumber>;
+                reportedTotalMatches: z.ZodOptional<z.ZodNumber>;
+                reachableTotalMatches: z.ZodOptional<z.ZodNumber>;
+                totalMatchesKind: z.ZodOptional<z.ZodEnum<{
+                    exact: "exact";
+                    reported: "reported";
+                    lowerBound: "lowerBound";
+                }>>;
+                totalMatchesCapped: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>>;
+    readonly hints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    readonly base: z.ZodOptional<z.ZodString>;
+    readonly shared: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    readonly responsePagination: z.ZodOptional<z.ZodObject<{
+        currentPage: z.ZodNumber;
+        totalPages: z.ZodNumber;
+        hasMore: z.ZodBoolean;
+        charOffset: z.ZodNumber;
+        charLength: z.ZodNumber;
+        totalChars: z.ZodNumber;
+        nextCharOffset: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;

package/dist/tools/github_view_repo_structure/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const GITHUB_STRUCTURE_DEFAULTS: {
+    readonly ENTRIES_PER_PAGE: 100;
+    readonly MAX_ENTRIES_PER_PAGE: 200;
+};

package/dist/tools/github_view_repo_structure/execution.d.ts

@@ -0,0 +1,20 @@
+import { type CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { z } from 'zod';
+import type { GitHubViewRepoStructureQuerySchema } from '@octocodeai/octocode-core/schemas';
+import type { GitHubRepoStructureDirectoryEntry } from '@octocodeai/octocode-core/extra-types';
+type GitHubViewRepoStructureQuery = z.infer<typeof GitHubViewRepoStructureQuerySchema>;
+import type { WithOptionalMeta } from '../../types/execution.js';
+type PartialRepoStructureQuery = WithOptionalMeta<GitHubViewRepoStructureQuery>;
+import type { ToolExecutionArgs } from '../../types/execution.js';
+export declare function filterStructure(structure: Record<string, GitHubRepoStructureDirectoryEntry>): Record<string, GitHubRepoStructureDirectoryEntry>;
+export declare function exploreMultipleRepositoryStructures(args: ToolExecutionArgs<PartialRepoStructureQuery>): Promise<CallToolResult>;
+export declare function buildRepoStructureOutput(input: {
+    data: Record<string, unknown>;
+    entryCount: number;
+    wasTruncated: boolean;
+    extraHints: string[];
+}, _query: PartialRepoStructureQuery): {
+    data: Record<string, unknown>;
+    extraHints: string[];
+};
+export {};

package/dist/tools/github_view_repo_structure/hints.d.ts

@@ -0,0 +1,2 @@
+import type { ToolHintGenerators } from '../../types/metadata.js';
+export declare const hints: ToolHintGenerators;

package/dist/tools/github_view_repo_structure/scheme.d.ts

@@ -0,0 +1,81 @@
+export declare const GitHubViewRepoStructureQueryLocalSchema: import("zod").ZodObject<{
+    owner: import("zod").ZodString;
+    repo: import("zod").ZodString;
+    branch: import("zod").ZodOptional<import("zod").ZodString>;
+    path: import("zod").ZodOptional<import("zod").ZodString>;
+    maxDepth: import("zod").ZodOptional<import("zod").ZodNumber>;
+    page: import("zod").ZodDefault<import("zod").ZodNumber>;
+    itemsPerPage: import("zod").ZodDefault<import("zod").ZodNumber>;
+    includeSizes: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    id: import("zod").ZodOptional<import("zod").ZodString>;
+    mainResearchGoal: import("zod").ZodOptional<import("zod").ZodString>;
+    researchGoal: import("zod").ZodOptional<import("zod").ZodString>;
+    reasoning: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>;
+export declare const GitHubViewRepoStructureBulkQueryLocalSchema: import("zod").ZodObject<{
+    responseCharOffset: import("zod").ZodOptional<import("zod").ZodPipe<import("zod").ZodTransform<unknown, unknown>, import("zod").ZodNumber>>;
+    responseCharLength: import("zod").ZodOptional<import("zod").ZodPipe<import("zod").ZodTransform<unknown, unknown>, import("zod").ZodNumber>>;
+    queries: import("zod").ZodArray<import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>>;
+}, import("zod/v4/core").$strip>;
+export declare const GitHubViewRepoStructureOutputLocalSchema: import("zod").ZodObject<{
+    status: import("zod").ZodOptional<import("zod").ZodEnum<{
+        empty: import("@octocodeai/octocode-core/types").ToolStatus.Empty;
+        error: import("@octocodeai/octocode-core/types").ToolStatus.Error;
+    }>>;
+    data: import("zod").ZodOptional<import("zod").ZodObject<{
+        entries: import("zod").ZodArray<import("zod").ZodObject<{
+            path: import("zod").ZodString;
+            name: import("zod").ZodOptional<import("zod").ZodString>;
+            type: import("zod").ZodOptional<import("zod").ZodString>;
+            size: import("zod").ZodOptional<import("zod").ZodNumber>;
+        }, import("zod/v4/core").$loose>>;
+        pagination: import("zod").ZodOptional<import("zod").ZodObject<{
+            currentPage: import("zod").ZodNumber;
+            totalPages: import("zod").ZodNumber;
+            hasMore: import("zod").ZodBoolean;
+            perPage: import("zod").ZodOptional<import("zod").ZodNumber>;
+            totalMatches: import("zod").ZodOptional<import("zod").ZodNumber>;
+            totalFiles: import("zod").ZodOptional<import("zod").ZodNumber>;
+            totalEntries: import("zod").ZodOptional<import("zod").ZodNumber>;
+            totalResults: import("zod").ZodOptional<import("zod").ZodNumber>;
+            entriesPerPage: import("zod").ZodOptional<import("zod").ZodNumber>;
+            filesPerPage: import("zod").ZodOptional<import("zod").ZodNumber>;
+            matchesPerPage: import("zod").ZodOptional<import("zod").ZodNumber>;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>>;
+    entries: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+        path: import("zod").ZodString;
+        name: import("zod").ZodOptional<import("zod").ZodString>;
+        type: import("zod").ZodOptional<import("zod").ZodString>;
+        size: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$loose>>>;
+    pagination: import("zod").ZodOptional<import("zod").ZodObject<{
+        currentPage: import("zod").ZodNumber;
+        totalPages: import("zod").ZodNumber;
+        hasMore: import("zod").ZodBoolean;
+        perPage: import("zod").ZodOptional<import("zod").ZodNumber>;
+        totalMatches: import("zod").ZodOptional<import("zod").ZodNumber>;
+        totalFiles: import("zod").ZodOptional<import("zod").ZodNumber>;
+        totalEntries: import("zod").ZodOptional<import("zod").ZodNumber>;
+        totalResults: import("zod").ZodOptional<import("zod").ZodNumber>;
+        entriesPerPage: import("zod").ZodOptional<import("zod").ZodNumber>;
+        filesPerPage: import("zod").ZodOptional<import("zod").ZodNumber>;
+        matchesPerPage: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>;
+    warnings: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodObject<{
+        kind: import("zod").ZodString;
+    }, import("zod/v4/core").$loose>]>>>;
+    error: import("zod").ZodOptional<import("zod").ZodString>;
+    readonly hints: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    readonly base: import("zod").ZodOptional<import("zod").ZodString>;
+    readonly shared: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodNumber, import("zod").ZodBoolean]>>>;
+    readonly responsePagination: import("zod").ZodOptional<import("zod").ZodObject<{
+        currentPage: import("zod").ZodNumber;
+        totalPages: import("zod").ZodNumber;
+        hasMore: import("zod").ZodBoolean;
+        charOffset: import("zod").ZodNumber;
+        charLength: import("zod").ZodNumber;
+        totalChars: import("zod").ZodNumber;
+        nextCharOffset: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$loose>;

package/dist/tools/github_view_repo_structure/types.d.ts

@@ -0,0 +1,39 @@
+import type { GitHubRepoStructureDirectoryEntry } from '@octocodeai/octocode-core/extra-types';
+import type { ContentDirectoryEntry } from '../../github/githubAPI.js';
+import type { PaginationInfo } from '../../types/toolResults.js';
+export type GitHubApiFileItem = ContentDirectoryEntry;
+export interface GitHubRepositoryStructureResult {
+    owner: string;
+    repo: string;
+    branch: string;
+    defaultBranch?: string;
+    path: string;
+    apiSource: boolean;
+    summary: {
+        totalFiles: number;
+        totalFolders: number;
+        truncated: boolean;
+        filtered: boolean;
+        originalCount: number;
+    };
+    structure: Record<string, GitHubRepoStructureDirectoryEntry>;
+    fileSizeMap?: Record<string, Record<string, number>>;
+    pagination?: PaginationInfo;
+    hints?: string[];
+    _cachedItems?: {
+        path: string;
+        type: 'file' | 'dir';
+    }[];
+    _cachedFileSizeMap?: Record<string, Record<string, number>>;
+    rawResponseChars?: number;
+}
+export interface GitHubRepositoryStructureError {
+    error: string;
+    status?: number;
+    triedBranches?: string[];
+    defaultBranch?: string;
+    rateLimitRemaining?: number;
+    rateLimitReset?: number;
+    retryAfter?: number;
+    hints?: string[];
+}

package/dist/tools/local_binary_inspect/archiveOps.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Archive list/extract operations.
+ * Backs mode="list" and mode="extract" in localBinaryInspect.
+ *
+ * Backend selection (falls through on missing CLI):
+ *   .aar/.yaa          → aa only
+ *   .dmg/.rar/.cpgz    → 7z → 7zz → bsdtar
+ *   .7z/.iso/.cab/…    → bsdtar → 7z → 7zz
+ *   .tar.*             → tar → bsdtar → 7z
+ *   default (zip-fam.) → unzip → tar → bsdtar → 7z
+ */
+export interface ArchiveChainResult {
+    success: boolean;
+    stdout: string;
+    stderr: string;
+    commandUsed?: string;
+    missingCommands?: string[];
+}
+export declare function listArchiveEntries(path: string, verbose: boolean): Promise<ArchiveChainResult & {
+    entries?: string[];
+}>;
+export declare function extractArchiveEntry(path: string, entry: string): Promise<ArchiveChainResult>;