@octocodeai/octocode-core 16.2.0 → 16.3.0

package/dist/resources/tools/ghHistoryResearch.d.ts

@@ -1,133 +0,0 @@
-import { z } from "zod";
-import type { ToolSpec } from "../../types/index.js";
-export declare const ghHistoryResearch: ToolSpec;
-export declare const GitHubPullRequestSearchQuerySchema: 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>;

package/dist/resources/tools/ghHistoryResearch.js

@@ -1 +0,0 @@
-import{z as e}from"zod";import{buildObject as t,charLength as o,charOffset as n,DEFAULT_GITHUB_SEARCH_LIMIT as a,DEFAULT_PR_ITEMS_PER_PAGE as i,intRange as s,MAX_GITHUB_SEARCH_LIMIT as r,MAX_LINE_NUMBER as l,MAX_PR_ITEMS_PER_PAGE as c,metaFields as m,optionalPageNumber as d,pageNumber as p,StringArray as h}from"./_toolkit.js";export const ghHistoryResearch={name:"ghHistoryResearch",description:'Unified PR and commit history tool for GitHub research. Two modes, one tool.\nTYPE:"prs" — PR search and deep read.\n  LIST MODE (no prNumber): search PRs by keyword, author, label, date, review state, CI status and more — returns lean metadata. Re-call with prNumber to deep-read a result.\n  DETAIL MODE (prNumber required): fetch body, changedFiles, patches, comments, reviews, commits. Use reviewMode:"full" to fetch all surfaces in one call. Content selectors are silently ignored without prNumber.\nTYPE:"commits" — file or repo commit history.\n  Provide owner+repo and optionally path (file), path ending in "/" (directory subtree), or omit path for whole-repo history. Returns commit log with sha, message, author, date, url. Use since/until for date range, author for contributor filter, includeDiff for per-commit diffs.\n  Commit messageHeadline often embeds a PR ref like "#420" — extract it and re-call with prNumber:420 for the full PR.\n  Batch multiple paths in one call: queries:[{type:"commits",path:"A",...},{type:"commits",path:"B",...}] (max 5 per call).\nPR SEARCH FLOW (type:"prs"):\n- Keyword: keywordsToSearch:["pagination"] + match:["title"] for title-only; query field for raw GitHub qualifiers.\n- Archaeology (find PR that introduced X): state:"merged" sort:"created" order:"asc" — oldest merged first.\n- Filter by: state, author, label, milestone, language, checks, review, draft, locked, visibility, base branch, date ranges.\n- All list results include next:{} map of content surfaces to fetch. Re-call with prNumber to deep-read.\nCONTENT PAGINATION (detail mode):\n- PR body / patches: charOffset+charLength sliding window; advance charOffset on hasMore.\n- Comment bodies: commentBodyOffset+charLength; advance commentBodyOffset on contentPagination.commentBody.hasMore.\n- File list / comments / commits: page-based (filePage, commentPage, commitPage+itemsPerPage).\n- contentPagination in the response shows all surfaces with hasMore=true and their nextQuery ready to use.\nSIGNALS: bodyEmpty=requested but empty; absent field=surface not requested (not missing data); sanitizationWarnings=content redacted; in_reply_to_id=reply in a thread.\nSIZE CONTROL: patches.mode:"selected" with files/ranges for targeted diffs. Set charLength to cap windows. Set itemsPerPage for comments/commits/files.\nOUTPUT: minify "standard" (default) strips patch comments and blank lines; minify "none" returns raw exact diff text. "symbols" is not available for PR content.',schema:{type:'Mode selector. "prs": search or deep-read pull requests. "commits": file or repo commit history — use owner+repo+path.',keywordsToSearch:"Keywords combined across title/body/comments (multi-word terms are auto phrase-quoted). Pair with match to restrict scope. Ignored in commits mode.",query:'Raw GitHub search string appended verbatim after keywords. Use for exact phrases ("Partial Prerendering"), qualifiers (label:bug), or anything not exposed as a first-class field. Ignored in commits mode.',match:'Fields to match keywords against: "title", "body", "comments". Default searches all three. Use ["title"] for the most precise and fastest match.',prNumber:"Direct PR lookup by number. Required to fetch body, files, patches, comments, reviews, or commits — content/reviewMode are silently ignored without it. Requires owner+repo.",owner:"Repo owner or org (required for commits mode; optional but recommended for PR search).",repo:"Repo name (required for commits mode).",concise:'List mode: set true for minimal orientation — a flat list of "#number title" strings to triage; then re-call with prNumber to deep-read the chosen PR. Default returns structured PR objects. Ignored with prNumber (detail mode).',state:'"open", "closed", or "merged". "merged" maps to GitHub search is:merged — returns merged PRs only. Ignored in commits mode.',author:"PR author or commit author filter.",assignee:"Assigned user filter (PR mode only).",commenter:"User who commented on the PR (PR mode only).",involves:"Any user involvement — author, assignee, mention, or commenter (PR mode only).",mentions:"User mentioned via @mention in the PR (PR mode only).","review-requested":"User or team whose review was requested (PR mode only).","reviewed-by":"User who reviewed the PR (PR mode only).",label:'Label name or array. Example: "bug", ["enhancement","breaking"]. PR mode only.',milestone:'Milestone title (exact match). Example: "v2.0". PR mode only.',language:'Repository language filter. Example: "typescript", "rust". PR mode only.',checks:'"success" (all CI passed), "failure" (any check failed), "pending" (checks running). PR mode only.',review:'"approved" (has approval), "changes_requested", "required" (review required but pending), "none" (no reviews yet). PR mode only.',locked:"true = only locked conversations; false = only unlocked. PR mode only.",visibility:'"public" or "private" — filter by repo visibility. PR mode only.',"team-mentions":'Filter PRs that mention a GitHub team. Format: "org/team-slug". PR mode only.',project:'Filter PRs linked to a project board. Format: "owner/project-number". PR mode only.',"no-label":"Filter to PRs without any labels.","no-milestone":"Filter to PRs without a milestone.","no-project":"Filter to PRs without a project.","no-assignee":"Filter to PRs without an assignee.",head:"Source branch filter (PR mode). Example: feature/my-branch.",base:'Target branch filter (PR mode). Example: "main".',created:'Creation date filter. Format: ">2024-01-01", "<2023-06-01", "2023-01-01..2024-01-01". PR mode only.',updated:"Last updated filter (tracks comments, pushes). Same date format as created. PR mode only.",closed:"Closed date filter. Same format as created. PR mode only.","merged-at":"Merged date filter. Same format as created. PR mode only.",since:'Commit start date (commits mode only). ISO 8601. Example: "2024-01-01T00:00:00Z".',until:"Commit end date (commits mode only). ISO 8601.",path:'File path or directory prefix (commits mode). Omit for whole-repo history. A trailing "/" scopes to a directory subtree.',branch:"Branch name or SHA to walk history from (commits mode). Defaults to the repo default branch.",perPage:"Commits per page (commits mode).",includeDiff:"Include per-commit file diffs (additions, deletions, patch) in commits mode. Increases response size — use sparingly.",comments:'SEARCH FILTER: comment-count range qualifier. Example: ">5", "0..10". Not for fetching PR comment content — use content.comments for that.',reactions:'SEARCH FILTER: reaction-count range qualifier. Example: ">10".',interactions:'SEARCH FILTER: combined comment+reaction count. Example: ">20".',draft:"true: drafts only; false: non-drafts only; omit: both.",archived:"Include PRs from archived repositories. Defaults to false.",sort:'"created" (newest first), "updated" (recently active), "comments" (most discussed), "reactions" (most reacted), "best-match" (GitHub relevance score).',order:'"desc" (newest/highest first), "asc" (oldest/lowest first). Pair asc+sort:created for archaeology.',limit:"PR results per page (list mode).",page:"Result page for list-mode PR search. Use only on hasMore:true.",filePage:"Page through the changed-files list (detail mode). Use on contentPagination.changedFiles.hasMore.",commentPage:"Page through PR comments (detail mode). Use on contentPagination.comments.hasMore.",commitPage:"Page through PR-bound commits (detail mode). Use on contentPagination.commits.hasMore.",itemsPerPage:"Items per page for file, comment, and commit lists.",reviewMode:'"full": fetch all content surfaces (body + changedFiles + patches + comments + reviews + commits) in one call. Only valid with prNumber.',content:"Content selector object. Only applied in detail mode (prNumber required). Select only what you need — each surface adds response size.","content.metadata":"Ensure PR metadata fields (number, title, state, author, dates) are included.","content.body":"Full PR description text. Paginated via charOffset/charLength. Check contentPagination.body.hasMore for continuation.","content.changedFiles":"File list: path, status, additions, deletions. Paginated via filePage.","content.patches":"Diff/patch selector.","content.patches.mode":'"none" (no diffs), "selected" (targeted files/ranges — cheapest), "all" (every diff). Use selected + files/ranges to read specific files without fetching the entire diff.',"content.patches.files":'Non-empty list of file paths to fetch when mode:"selected". Example: ["src/foo.ts","src/bar.ts"].',"content.patches.ranges":'Per-file line ranges for mode:"selected". Each entry: { file, additions?: number[], deletions?: number[] }. Returns only the specified line numbers.',"content.patches.ranges.file":"File path for this range entry.","content.patches.ranges.additions":"Added-line numbers to include for this file.","content.patches.ranges.deletions":"Deleted-line numbers to include for this file.","content.comments":"PR comment selector.","content.comments.discussion":"Include PR-level discussion comments.","content.comments.reviewInline":"Include inline code review comments. in_reply_to_id marks replies in a thread.","content.comments.includeBots":"Set true to include CI/bot comments (Vercel preview, CodeRabbit, etc.). Default false.","content.comments.file":"Filter inline comments to a single file path.","content.reviews":"Review summaries: APPROVED / CHANGES_REQUESTED state per reviewer.","content.commits":'PR-bound commit selector. These are commits that belong to the PR — not the repo commit log (use type:"commits" for that).',"content.commits.list":"Commit list: sha, message, author, date.","content.commits.includeFiles":"Per-commit file change list (path, status, additions, deletions).",matchString:"Substring filter — narrows patch/body/comment text to sections containing this string.",charOffset:"Char window start for body or patch content. Advance to contentPagination.body.nextQuery.charOffset when hasMore:true.",commentBodyOffset:"Char window start for comment bodies. Advance to contentPagination.commentBody.nextQuery.commentBodyOffset when hasMore:true.",charLength:"Char window size for body, patches, and comment bodies. Controls how much text is returned per page.",minify:'"standard" (default): strips blank lines and comment-only lines from patches — smaller responses. "none": raw exact diff text — use when quoting or matching whitespace. "symbols" is not available for PR content.'}};const u=ghHistoryResearch.schema;export const GitHubPullRequestSearchQuerySchema=t(u,{...m,type:e.enum(["prs","commits"]).default("prs"),since:e.string().optional(),until:e.string().optional(),path:e.string().optional(),branch:e.string().optional(),perPage:s(1,100).optional().default(30),includeDiff:e.boolean().optional().default(!1),keywordsToSearch:e.array(e.string()).optional(),query:e.string().optional(),prNumber:s(1,l).optional(),owner:e.string().optional(),repo:e.string().optional(),concise:e.boolean().optional(),state:e.enum(["open","closed","merged"]).optional(),assignee:e.string().optional(),author:e.string().optional(),commenter:e.string().optional(),involves:e.string().optional(),mentions:e.string().optional(),"review-requested":e.string().optional(),"reviewed-by":e.string().optional(),label:e.union([e.string(),e.array(e.string())]).optional(),milestone:e.string().optional(),language:e.string().optional(),checks:e.enum(["success","failure","pending"]).optional(),review:e.enum(["approved","changes_requested","required","none"]).optional(),locked:e.boolean().optional(),visibility:e.enum(["public","private"]).optional(),"team-mentions":e.string().optional(),project:e.string().optional(),"no-label":e.boolean().optional(),"no-milestone":e.boolean().optional(),"no-project":e.boolean().optional(),"no-assignee":e.boolean().optional(),head:e.string().optional(),base:e.string().optional(),created:e.string().optional(),updated:e.string().optional(),closed:e.string().optional(),"merged-at":e.string().optional(),comments:e.string().optional(),reactions:e.string().optional(),interactions:e.string().optional(),draft:e.boolean().optional(),match:e.array(e.enum(["title","body","comments"])).optional(),sort:e.enum(["created","updated","best-match","comments","reactions"]).optional(),order:e.enum(["asc","desc"]).optional(),limit:s(1,r).default(a),page:p(),archived:e.boolean().optional(),filePage:d(),commentPage:d(),commitPage:d(),itemsPerPage:s(1,c).default(i),reviewMode:e.literal("full").optional(),content:t(u,{metadata:e.boolean().optional(),body:e.boolean().optional(),changedFiles:e.boolean().optional(),patches:t(u,{mode:e.enum(["none","selected","all"]).default("none"),files:h,ranges:e.array(t(u,{file:e.string(),additions:e.array(s(1,l)).optional(),deletions:e.array(s(1,l)).optional()},"content.patches.ranges")).optional()},"content.patches").optional(),comments:t(u,{discussion:e.boolean().optional(),reviewInline:e.boolean().optional(),includeBots:e.boolean().default(!1),file:e.string().optional()},"content.comments").optional(),reviews:e.boolean().optional(),commits:t(u,{list:e.boolean().optional(),includeFiles:e.boolean().optional()},"content.commits").optional()},"content").optional(),matchString:e.string().optional(),commentBodyOffset:n(),charOffset:n(),charLength:o(),minify:e.enum(["none","standard"]).default("standard")}).superRefine((e,t)=>{const o=e.content?.patches;if(!o)return;const n=(o.files?.length??0)>0,a=(o.ranges?.length??0)>0,i=n||a;"selected"!==o.mode||i||t.addIssue({code:"custom",message:'content.patches.mode="selected" requires non-empty files or ranges.',path:["content","patches","files"]}),"selected"!==o.mode&&i&&t.addIssue({code:"custom",message:'content.patches.files and content.patches.ranges require mode="selected".',path:["content","patches","mode"]})});

package/dist/resources/tools/ghSearchCode.d.ts

@@ -1,23 +0,0 @@
-import { z } from "zod";
-import type { ToolSpec } from "../../types/index.js";
-export declare const ghSearchCode: ToolSpec;
-export declare const GitHubCodeSearchQuerySchema: z.ZodObject<{
-    keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    owner: z.ZodOptional<z.ZodString>;
-    repo: z.ZodOptional<z.ZodString>;
-    extension: z.ZodOptional<z.ZodString>;
-    filename: z.ZodOptional<z.ZodString>;
-    path: z.ZodOptional<z.ZodString>;
-    language: z.ZodOptional<z.ZodString>;
-    match: z.ZodDefault<z.ZodEnum<{
-        file: "file";
-        path: "path";
-    }>>;
-    limit: z.ZodDefault<z.ZodNumber>;
-    page: z.ZodDefault<z.ZodNumber>;
-    concise: z.ZodOptional<z.ZodBoolean>;
-    id: z.ZodOptional<z.ZodString>;
-    mainResearchGoal: z.ZodOptional<z.ZodString>;
-    researchGoal: z.ZodOptional<z.ZodString>;
-    reasoning: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;

package/dist/resources/tools/ghSearchCode.js

@@ -1 +0,0 @@
-import{z as e}from"zod";import{buildObject as t,DEFAULT_GITHUB_SEARCH_LIMIT as a,intRange as n,MAX_GITHUB_SEARCH_LIMIT as o,metaFields as i,pageNumber as r,StringArray as s}from"./_toolkit.js";export const ghSearchCode={name:"ghSearchCode",description:'GitHub code and path search. Note: GitHub is deprecating this search API (planned removal ~Sep 2026); prefer ghGetFileContent or ghViewRepoStructure for known paths.\nmatch:"file" searches file contents, returns snippets with matchIndices. match:"path" searches file paths/names only — no snippet, much cheaper, use to verify a file exists before reading it.\nmatchIndices are char offsets inside the snippet string — NOT file line numbers, NOT usable as lineHint. Get lineHint from ghGetFileContent(matchString=same-keyword).\nCaps: ~20 reachable matches per search (1000/~10 pages total) and default-branch only — when the response flags unreachable matches, narrow with owner/repo/path/extension/filename rather than paging; pass a non-default ref via ghGetFileContent/ghViewRepoStructure.\nEmpty with owner+repo: repo may not be indexed (new or private). Fall back to ghGetFileContent with a known path.\nNext: ghGetFileContent(path, matchString=same-keyword) to read — use files[0].startLine as rough lineHint; ghViewRepoStructure for context; ghSearchRepos if owner/repo unknown.',schema:{keywords:"Search terms, all ANDed — every term must appear in a match. One concept per array item; keep a multi-word phrase as one item. Send unrelated alternatives as separate query objects in one queries:[...] call (max 5 per call), not separate tool calls. To find a file by name, use match:'path'.",owner:"Scopes the search to a user/org. Alone it spans all their repos; with repo it targets one repository.",repo:"Repository name without the owner. Requires owner — sending it alone returns a scope error.",extension:'File extension to match, without the leading dot ("ts"). Combines with keywords.',language:'GitHub language qualifier (e.g. "TypeScript", "Python"). Uses GitHub\'s language detection, so it is broader than extension — it covers every extension mapped to that language.',filename:'Matches by file name (equals or contains). Prefer over keywords when you already know the name, e.g. "Button.tsx" or "jest.config".',path:"Matches repo paths beginning with this directory prefix (GitHub path: qualifier) — a prefix, not a full file path.",match:'"file" searches file contents and returns snippets with matchIndices. "path" searches only file paths/names — no snippets, far cheaper; use it to confirm a file exists before reading it.',limit:"Results to return per page.",page:"Result page to fetch. GitHub serves at most 1000 results (~10 pages).",concise:'Set true for minimal orientation: a flat list of "owner/repo:path" strings (no snippets). Cheapest way to locate files; then ghGetFileContent(path) to read. Default returns snippet objects with matchIndices.'}};export const GitHubCodeSearchQuerySchema=t(ghSearchCode.schema,{...i,keywords:s,owner:e.string().optional(),repo:e.string().optional(),extension:e.string().optional(),filename:e.string().optional(),path:e.string().optional(),language:e.string().optional(),match:e.enum(["file","path"]).default("file"),limit:n(1,o).default(a),page:r(),concise:e.boolean().optional()});

package/dist/resources/tools/ghSearchRepos.d.ts

@@ -1,40 +0,0 @@
-import { z } from "zod";
-import type { ToolSpec } from "../../types/index.js";
-export declare const ghSearchRepos: ToolSpec;
-export declare const GitHubReposSearchSingleQuerySchema: 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>;

package/dist/resources/tools/ghSearchRepos.js

@@ -1 +0,0 @@
-import{z as e}from"zod";import{buildObject as t,DEFAULT_GITHUB_SEARCH_LIMIT as s,intRange as r,MAX_GITHUB_SEARCH_LIMIT as o,metaFields as a,pageNumber as i,StringArray as n}from"./_toolkit.js";export const ghSearchRepos={name:"ghSearchRepos",description:"Discover GitHub repos by name, keywords, owner, topic, language, or popularity.\nOutput modes: concise:true returns a flat list of \"owner/repo\" strings — minimal orientation, then dive into a chosen repo; default (concise:false) returns structured objects with stars, forks, language, license, topics, dates — required when filtering or comparing programmatically.\nBulk: pass multiple independent discovery queries as queries:[{...},{...}] (max 5) — e.g. compare several owners/keyword sets in one call instead of one search at a time.\nOwner alone enumerates org repos; keywords combine together. topicsToSearch AND semantics: all listed topics must be present (GitHub topic:react topic:typescript). Providing both topicsToSearch and keywords issues two separate parallel searches (merged, deduplicated, OR semantics across them) — use a single set of keywords for strict AND. topicsToSearch is sparse — fewer repos tag topics than set a language. Filters use GitHub query format: stars/forks/size accept '>100', '50..500'; created/updated accept '>2023-01-01'.\nNext: ghViewRepoStructure, ghSearchCode/ghGetFileContent, npmSearch for npm names.",schema:{keywords:"Search terms. One term per array item for broad matching; keep a phrase in one item for exact wording.",topicsToSearch:"GitHub topic tags to require — all listed topics must be present. Sparse (most repos set no topics), so pair with keywords or language rather than using alone.",language:"Repository language qualifier (GitHub detection).",owner:"User/org scope. Without keywords it enumerates that owner's repos; with keywords it scopes the search to them.",stars:"Star-count filter using GitHub range syntax: '>100', '<1000', '50..500', '>=500'.",size:"Repository size in KB (sources + history): '<1000' for small repos, '>10000' for large codebases.",created:"Creation-date filter (GitHub range syntax): '>2023-01-01', '<2020-01-01', '2022-01-01..2023-01-01'.",updated:"Last-push-date filter (GitHub's pushed: qualifier, not metadata updates): '>2024-01-01'. Finds actively maintained repos.",match:"Which text fields to search: name, description, and/or readme. Defaults to name+description; add 'readme' for broader, slower full-text search.",sort:"Result ordering. 'stars': most-starred first. 'forks': most-forked first. 'updated': most-recently-pushed first. 'help-wanted-issues': repos seeking contributors. 'best-match': GitHub relevance.",limit:"Results to return per page.",page:"Result page.",archived:"Include archived repos (excluded by default).",visibility:"'public' or 'private' (private needs a repo-scoped token). Omit to include both.",forks:"Fork-count filter (GitHub range syntax): '>100', '<1000', '50..500'.",license:"Exact lowercase SPDX license id, e.g. 'mit', 'apache-2.0', 'gpl-3.0'.",goodFirstIssues:"Filters by count of open 'good first issue' labels ('>5') — finds repos inviting contributors.",concise:'Set true for minimal orientation: a flat list of "owner/repo" strings only. Cheapest way to scan candidates; then re-run without concise (or ghViewRepoStructure) on the one you pick. Default returns structured objects with stars, language, topics, dates.'}};export const GitHubReposSearchSingleQuerySchema=t(ghSearchRepos.schema,{...a,keywords:n,topicsToSearch:n,language:e.string().optional(),owner:e.string().optional(),stars:e.string().optional(),size:e.string().optional(),created:e.string().optional(),updated:e.string().optional(),match:e.array(e.enum(["name","description","readme"])).optional(),sort:e.enum(["stars","forks","help-wanted-issues","updated","best-match"]).default("best-match"),limit:r(1,o).default(s),page:i(),archived:e.boolean().optional(),visibility:e.enum(["public","private"]).optional(),forks:e.string().optional(),license:e.string().optional(),goodFirstIssues:e.string().optional(),concise:e.boolean().optional()});

package/dist/resources/tools/ghViewRepoStructure.d.ts

@@ -1,17 +0,0 @@
-import { z } from "zod";
-import type { ToolSpec } from "../../types/index.js";
-export declare const ghViewRepoStructure: ToolSpec;
-export declare const GitHubViewRepoStructureQuerySchema: z.ZodObject<{
-    owner: z.ZodString;
-    repo: z.ZodString;
-    branch: z.ZodOptional<z.ZodString>;
-    path: z.ZodOptional<z.ZodString>;
-    maxDepth: z.ZodOptional<z.ZodNumber>;
-    page: z.ZodDefault<z.ZodNumber>;
-    itemsPerPage: z.ZodDefault<z.ZodNumber>;
-    includeSizes: z.ZodOptional<z.ZodBoolean>;
-    id: z.ZodOptional<z.ZodString>;
-    mainResearchGoal: z.ZodOptional<z.ZodString>;
-    researchGoal: z.ZodOptional<z.ZodString>;
-    reasoning: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;

package/dist/resources/tools/ghViewRepoStructure.js

@@ -1 +0,0 @@
-import{z as e}from"zod";import{buildObject as t,DEFAULT_GITHUB_STRUCTURE_ITEMS_PER_PAGE as r,intRange as o,MAX_GITHUB_STRUCTURE_ITEMS_PER_PAGE as a,MAX_LOCAL_DEPTH as i,metaFields as s,pageNumber as n}from"./_toolkit.js";export const ghViewRepoStructure={name:"ghViewRepoStructure",description:'Browse a GitHub repository\'s directory tree. Returns files[], folders[], and a summary at each level.\nUse this to map an unknown repo before searching. Use ghSearchCode(match:"path") when you know a partial filename — faster.\nSet path to browse a subtree; omit for repo root. Set maxDepth to control recursion (immediate children only unless raised).\nIgnored paths: node_modules, .git, dist, build, and other artifacts are automatically excluded from results.\nOutput key is structure[] (array of {dir, files[], folders[]}). Paginate with page=N when pagination.hasMore is true.\nBulk: pass multiple {owner,repo,path} objects as queries:[{...},{...}] (max 5) to explore several paths in one call.\nNext: ghGetFileContent(path) to read files; ghSearchCode to search within a known path.',schema:{owner:"Repository owner or org.",repo:"Repository name, without the owner.",branch:"Branch, tag, or commit SHA. Omit for the default branch; if the ref isn't found the default branch is used and a warning hint is emitted.",path:'Repo-relative directory to browse. "" or "." for the root, or a subdirectory (e.g. "src/utils") to scope the tree. No leading slash.',maxDepth:"How deep to recurse — immediate children only unless raised. Set 2+ to descend into subdirectories.",page:"Result page. Advance only when pagination.hasMore is true.",itemsPerPage:"Entries per page. Raise to cut round-trips on large repos.",includeSizes:"Adds file sizes (bytes) in a fileSizes field alongside the structure."}};export const GitHubViewRepoStructureQuerySchema=t(ghViewRepoStructure.schema,{...s,owner:e.string(),repo:e.string(),branch:e.string().optional(),path:e.string().optional(),maxDepth:o(0,i).optional(),page:n(),itemsPerPage:o(1,a).default(r),includeSizes:e.boolean().optional()});

package/dist/resources/tools/localBinaryInspect.d.ts

@@ -1,39 +0,0 @@
-import { z } from "zod";
-import type { ToolSpec } from "../../types/index.js";
-export declare const localBinaryInspect: ToolSpec;
-export declare const LocalBinaryInspectQuerySchema: z.ZodObject<{
-    path: z.ZodString;
-    mode: z.ZodEnum<{
-        list: "list";
-        identify: "identify";
-        extract: "extract";
-        decompress: "decompress";
-        strings: "strings";
-    }>;
-    verbose: z.ZodOptional<z.ZodBoolean>;
-    maxEntries: z.ZodDefault<z.ZodNumber>;
-    entriesPerPage: z.ZodOptional<z.ZodNumber>;
-    entryPageNumber: z.ZodDefault<z.ZodNumber>;
-    archiveFile: z.ZodOptional<z.ZodString>;
-    matchString: z.ZodOptional<z.ZodString>;
-    matchStringContextLines: z.ZodDefault<z.ZodNumber>;
-    charOffset: z.ZodOptional<z.ZodNumber>;
-    charLength: z.ZodOptional<z.ZodNumber>;
-    format: z.ZodDefault<z.ZodEnum<{
-        auto: "auto";
-        gzip: "gzip";
-        bzip2: "bzip2";
-        xz: "xz";
-        lzma: "lzma";
-        zstd: "zstd";
-        lz4: "lz4";
-        brotli: "brotli";
-        lzfse: "lzfse";
-    }>>;
-    minLength: z.ZodDefault<z.ZodNumber>;
-    includeOffsets: z.ZodOptional<z.ZodBoolean>;
-    id: z.ZodOptional<z.ZodString>;
-    mainResearchGoal: z.ZodOptional<z.ZodString>;
-    researchGoal: z.ZodOptional<z.ZodString>;
-    reasoning: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;

package/dist/resources/tools/localBinaryInspect.js

@@ -1 +0,0 @@
-import{z as e}from"zod";import{buildObject as t,charLength as s,charOffset as a,intRange as r,metaFields as i,pageNumber as n}from"./_toolkit.js";export const localBinaryInspect={name:"localBinaryInspect",description:"Look inside an archive, a compressed stream, or a binary. Requires ENABLE_BINARY=true + ENABLE_LOCAL=true; when disabled, use localSearchCode(searchBinary:true) for pattern sweeps.\nUse when a file is binary, packed, or unknown — pick the mode for the job (see the mode field). Not for plain text (use localGetFileContent) or searching across many entries (use localSearchCode).\nFlow inside this tool: identify (what is it) → list (archive structure) → extract an entry or decompress a stream (its content) → strings (symbols/URLs in a native binary).\nFull chain across local tools — this tool only unpacks: discover (localFindFiles / localViewStructure) → unpack (localBinaryInspect) → read (localGetFileContent) → search (localSearchCode) → analyze (lspGetSemantics).\nOutput signals: totalEntries above the returned count = truncated (page with entryPageNumber); extract/decompress/strings output is char-paginated — advance charOffset from hints; content may be binary. If decompress rejects a multi-entry archive, use list/extract instead.",schema:{path:"Path to the archive, compressed file, or binary — absolute or workspace-relative.",mode:'Pick by what you have and what you want back. "identify": unknown file → its type + magic bytes; start here when you are not sure what the file is. "list": an archive (.zip/.jar/.tar.*/.7z/.deb/.dmg…) → its entry names, so you can see what is inside before pulling anything out. "extract": an archive → one entry\'s content; set archiveFile to an exact name from a prior list. "decompress": a single-stream compressed file (.gz/.bz2/.xz/.zst/.lz4/.br/.lzfse — one payload, not a multi-entry archive) → its text. "strings": a native binary (.so/.dylib/.node/.exe/.wasm) → its readable strings (symbols, URLs, version markers). Required — there is no default.',verbose:"list: include each entry's size and mtime (names only otherwise).",maxEntries:"list: caps how many entries are returned; totalEntries still reports the full archive count.",entriesPerPage:"list: entries per page; pair with entryPageNumber.",entryPageNumber:"list: which entry page to return; pair with entriesPerPage.",archiveFile:'extract: exact entry path to stream out (case-sensitive, must not start with "-"). Run mode="list" first — do not guess entry names.',matchString:"extract/decompress: keeps only streamed lines matching this text, with matchStringContextLines around each.",matchStringContextLines:"extract/decompress: context lines kept around each matchString hit.",charOffset:"extract/decompress: continuation offset for the next page; take it from hints[] — do not compute it yourself.",charLength:"extract/decompress: page size in characters. Auto-paginates when unset.",format:'decompress: compression format. "auto" detects from the file extension; override when the extension is wrong: gzip|bzip2|xz|lzma|zstd|lz4|brotli|lzfse.',minLength:"strings: shortest printable run to keep. Raise (e.g. 12–16) to surface only symbols/URLs.",includeOffsets:"strings: prefixes each string with its hex byte offset — handy for pivoting to localSearchCode(searchBinary:true)."}};const o=[".tar.gz",".tgz",".tar.bz2",".tbz2",".tbz",".tar.xz",".txz",".tar.zst",".tzst",".zip",".jar",".war",".apk",".7z"];export const LocalBinaryInspectQuerySchema=t(localBinaryInspect.schema,{...i,path:e.string(),mode:e.enum(["identify","list","extract","decompress","strings"]),verbose:e.boolean().optional(),maxEntries:r(1,1e4).default(1e3),entriesPerPage:r(1,100).optional(),entryPageNumber:n(),archiveFile:e.string().optional(),matchString:e.string().optional(),matchStringContextLines:r(0,50).default(3),charOffset:a(),charLength:s(),format:e.enum(["auto","gzip","bzip2","xz","lzma","zstd","lz4","brotli","lzfse"]).default("auto"),minLength:r(1,128).default(8),includeOffsets:e.boolean().optional()}).superRefine((e,t)=>{"extract"!==e.mode||e.archiveFile||t.addIssue({code:"custom",path:["archiveFile"],message:'archiveFile is required for mode="extract" — run mode="list" first to get exact entry names'}),e.archiveFile?.startsWith("-")&&t.addIssue({code:"custom",path:["archiveFile"],message:'archiveFile must not start with "-" (prevents flag injection)'}),"decompress"===e.mode&&o.some(t=>e.path.toLowerCase().endsWith(t))&&t.addIssue({code:"custom",path:["mode"],message:'This path looks like a multi-entry archive — use mode="list" or mode="extract" instead of mode="decompress". decompress is for single-stream files only (.gz, .bz2, .xz, .zst, .lz4, .br, .lzfse).'})});

package/dist/resources/tools/localFindFiles.d.ts

@@ -1,41 +0,0 @@
-import { z } from "zod";
-import type { ToolSpec } from "../../types/index.js";
-export declare const localFindFiles: ToolSpec;
-export declare const FindFilesQuerySchema: z.ZodObject<{
-    path: z.ZodString;
-    maxDepth: z.ZodOptional<z.ZodNumber>;
-    minDepth: z.ZodOptional<z.ZodNumber>;
-    names: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    pathPattern: z.ZodOptional<z.ZodString>;
-    regex: z.ZodOptional<z.ZodString>;
-    empty: z.ZodOptional<z.ZodBoolean>;
-    modifiedWithin: z.ZodOptional<z.ZodString>;
-    modifiedBefore: z.ZodOptional<z.ZodString>;
-    accessedWithin: z.ZodOptional<z.ZodString>;
-    sizeGreater: z.ZodOptional<z.ZodString>;
-    sizeLess: z.ZodOptional<z.ZodString>;
-    permissions: z.ZodOptional<z.ZodString>;
-    executable: z.ZodOptional<z.ZodBoolean>;
-    readable: z.ZodOptional<z.ZodBoolean>;
-    writable: z.ZodOptional<z.ZodBoolean>;
-    excludeDir: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    details: z.ZodOptional<z.ZodBoolean>;
-    showFileLastModified: z.ZodOptional<z.ZodBoolean>;
-    sortBy: z.ZodDefault<z.ZodEnum<{
-        path: "path";
-        modified: "modified";
-        size: "size";
-        name: "name";
-    }>>;
-    entryType: z.ZodOptional<z.ZodEnum<{
-        f: "f";
-        d: "d";
-    }>>;
-    page: z.ZodDefault<z.ZodNumber>;
-    itemsPerPage: z.ZodOptional<z.ZodNumber>;
-    id: z.ZodOptional<z.ZodString>;
-    mainResearchGoal: z.ZodOptional<z.ZodString>;
-    researchGoal: z.ZodOptional<z.ZodString>;
-    reasoning: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;

package/dist/resources/tools/localFindFiles.js

@@ -1 +0,0 @@
-import{z as e}from"zod";import{buildObject as t,intRange as i,MAX_FIND_DEPTH as s,MAX_LOCAL_ITEMS_PER_PAGE as o,MAX_LOCAL_LIMIT as a,metaFields as n,pageNumber as r,StringArray as l}from"./_toolkit.js";export const localFindFiles={name:"localFindFiles",description:'Find local files and directories by metadata — name pattern, path glob, size, modification time, permissions. Returns paths and metadata, not file content. More efficient than localSearchCode when you only need file locations.\nUse cases: "what changed recently?" → modifiedWithin:"24h", sortBy:"modified", showFileLastModified:true; "find test files" → names:["*.test.ts"], pathPattern:"src/**"; "find large files" → sizeGreater:"1m", sortBy:"size"; "find all index files" → regex:"^index\\."; "find directories" → entryType:"d".\nDefault excludeDir: node_modules, dist, .git, build, .next, coverage, and IDE/tool dirs — pass excludeDir:[] to disable. Time units: d=days, h=hours, w=weeks, m=minutes.\nBulk: up to 5 independent query objects in one call.\nValidation: minDepth must be <= maxDepth.\nNext: localGetFileContent(path) to read a found file; localSearchCode(keywords, path) to search content; localViewStructure(path) for directory tree browsing.',schema:{path:"Directory to search from (absolute or workspace-relative).",maxDepth:"Deepest directory level to descend (0 = root only, 1 = root + immediate children). Pair with minDepth for a depth window.",minDepth:"Shallowest level to include; must be <= maxDepth. Pair with maxDepth for an exact band (e.g. minDepth:2 + maxDepth:2 = exactly two levels deep).",names:'Basename globs; a file matches if it matches ANY listed glob (OR). E.g. ["*.ts", "*.tsx", "package.json"]. Use for extension- or name-pattern discovery.',pathPattern:"Glob over the full path. Use for monorepo slicing, e.g. 'packages/*/src/**' to reach src across all packages.",regex:"Rust regex over the basename only (not the full path) — more precise than names[]. E.g. '^(index|main)\\.(ts|js)$'.",empty:"Matches empty files (0 bytes) or childless directories.",modifiedWithin:"Keeps files modified within the past window: '7d', '2h', '1w', '30m'. Use for 'what changed recently'.",modifiedBefore:"Keeps files last modified longer ago than the window (same format as modifiedWithin) — finds stale or abandoned files.",accessedWithin:"Keeps files accessed within the past window (same format as modifiedWithin).",sizeGreater:"Keeps files larger than this size: '100k', '1m', '500b'. Use to find bundles, generated files, or assets.",sizeLess:"Keeps files smaller than this size (same format as sizeGreater).",executable:"Keeps files executable by the current process.",readable:"Keeps files readable by the current process.",writable:"Keeps files writable by the current process.",excludeDir:"Directory names to skip. Defaults to [node_modules, dist, .git, build, .next, coverage, IDE dirs] when omitted; pass [] to search everything.",limit:"Caps how many entries are discovered before pagination. Distinct from page size.",details:"Adds size and permissions per entry. Does NOT add timestamps — set showFileLastModified for those.",showFileLastModified:"Adds last-modified timestamps per entry. Required for real time ordering with sortBy:'modified'. Independent of details.",sortBy:"Ordering. 'modified': newest first — needs showFileLastModified for true time order, else falls back to path. 'size': largest first. 'name': basename A–Z. 'path': full path A–Z.",entryType:'"f" matches files only, "d" directories only; omit to match both.',permissions:"Permission filter (e.g. '755', '-u+x'). Omit unless filtering by exact permission bits.",page:"Result page.",itemsPerPage:"Entries per page."}};export const FindFilesQuerySchema=t(localFindFiles.schema,{...n,path:e.string(),maxDepth:i(0,s).optional(),minDepth:i(0,s).optional(),names:l,pathPattern:e.string().optional(),regex:e.string().optional(),empty:e.boolean().optional(),modifiedWithin:e.string().optional(),modifiedBefore:e.string().optional(),accessedWithin:e.string().optional(),sizeGreater:e.string().optional(),sizeLess:e.string().optional(),permissions:e.string().optional(),executable:e.boolean().optional(),readable:e.boolean().optional(),writable:e.boolean().optional(),excludeDir:l,limit:i(1,a).optional(),details:e.boolean().optional(),showFileLastModified:e.boolean().optional(),sortBy:e.enum(["modified","name","path","size"]).default("modified"),entryType:e.enum(["f","d"]).optional(),page:r(),itemsPerPage:i(1,o).optional()}).superRefine((e,t)=>{void 0!==e.minDepth&&void 0!==e.maxDepth&&e.minDepth>e.maxDepth&&t.addIssue({code:"custom",message:"minDepth must be less than or equal to maxDepth.",path:["minDepth"]})});

package/dist/resources/tools/localGetFileContent.d.ts

@@ -1,24 +0,0 @@
-import { z } from "zod";
-import type { ToolSpec } from "../../types/index.js";
-export declare const localGetFileContent: ToolSpec;
-export declare const FetchContentQuerySchema: z.ZodObject<{
-    path: z.ZodString;
-    fullContent: z.ZodOptional<z.ZodBoolean>;
-    matchString: z.ZodOptional<z.ZodString>;
-    matchStringIsRegex: z.ZodOptional<z.ZodBoolean>;
-    matchStringCaseSensitive: z.ZodOptional<z.ZodBoolean>;
-    startLine: z.ZodOptional<z.ZodNumber>;
-    endLine: z.ZodOptional<z.ZodNumber>;
-    contextLines: z.ZodDefault<z.ZodNumber>;
-    charOffset: z.ZodOptional<z.ZodNumber>;
-    charLength: z.ZodOptional<z.ZodNumber>;
-    minify: z.ZodDefault<z.ZodEnum<{
-        none: "none";
-        standard: "standard";
-        symbols: "symbols";
-    }>>;
-    id: z.ZodOptional<z.ZodString>;
-    mainResearchGoal: z.ZodOptional<z.ZodString>;
-    researchGoal: z.ZodOptional<z.ZodString>;
-    reasoning: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;

package/dist/resources/tools/localGetFileContent.js

@@ -1 +0,0 @@
-import{z as e}from"zod";import{buildObject as t,charLength as n,charOffset as a,intRange as i,lineNumber as s,MAX_CONTEXT_LINES as r,metaFields as o,validateFileContentExtractionMode as l}from"./_toolkit.js";export const localGetFileContent={name:"localGetFileContent",description:'Read a local file or region. Start with minify:"symbols" on any unknown file before reading slices.\nChoose one extraction mode — mutually exclusive: matchString (find all occurrences, returns matchRanges) | startLine/endLine (line range — both required together) | fullContent (entire file, small files only) | default (first charLength chars from line 1).\nPick minify by goal (see the minify field): "symbols" to orient, "standard" to read, "none" to quote/match whitespace.\nOutput signals: isPartial:true → check hints[] for next charOffset value (emitted as \'charOffset=N\'); matchRanges[i]={start,end} (1-based line numbers) → use matchRanges[0].start as lineHint for lspGetSemantics; warnings[] → redacted content, auto-pagination, or symbols-fallback messages.\nevidence.answerReady:true means content returned — stop calling (check isPartial separately for pagination state).\nNext: lspGetSemantics(uri=path, symbolName, lineHint=matchRanges[0].start) for semantics; localSearchCode before reading if the symbol location is unknown. Batch up to 5 files per call: queries:[{path:f1,...},{path:f2,...}].',schema:{path:"File to read (absolute or workspace-relative). For directories, use localViewStructure.",fullContent:"Returns the whole file. Reserve for small files; for large ones use matchString or startLine/endLine. Mutually exclusive with both.",matchString:'Anchor text (or regex) to locate; all occurrences come back as merged slices, with matchRanges[i]={start,end} as 1-based line numbers — pass matchRanges[0].start as lineHint to lspGetSemantics. Case-insensitive unless matchStringCaseSensitive:true; regex when matchStringIsRegex:true. Mutually exclusive with startLine/endLine and fullContent; ignored when minify:"symbols".',matchStringIsRegex:"Treats matchString as a regex — use for flexible anchors like function signatures, imports, or JSDoc tags.",matchStringCaseSensitive:"Makes matchString matching case-sensitive (case-insensitive otherwise).",startLine:"First line of the range. Required together with endLine — sending only one is an error. Mutually exclusive with fullContent and matchString.",endLine:"Last line of the range; must be >= startLine. Required together with startLine. Mutually exclusive with fullContent and matchString.",contextLines:"Extra source lines around each matchString hit. Raise to capture a full function body without a follow-up read.",charOffset:"Continuation offset for the next page; take it from hints[] ('charOffset=N') — do not compute it yourself.",charLength:"Page size in characters. Auto-paginates when unset; set it explicitly for normal source files.",minify:'"symbols": structural skeleton with line numbers in the gutter — much smaller. Use for orientation on any unknown file before reading details. matchString and charLength are ignored in symbols mode. "standard": strips comments and blank lines. "none": exact raw text — use when quoting or matching whitespace precisely.'}};export const FetchContentQuerySchema=t(localGetFileContent.schema,{...o,path:e.string(),fullContent:e.boolean().optional(),matchString:e.string().optional(),matchStringIsRegex:e.boolean().optional(),matchStringCaseSensitive:e.boolean().optional(),startLine:s(),endLine:s(),contextLines:i(0,r).default(5),charOffset:a(),charLength:n(),minify:e.enum(["none","standard","symbols"]).default("standard")}).superRefine(l);

package/dist/resources/tools/localSearchCode.d.ts

@@ -1,51 +0,0 @@
-import { z } from "zod";
-import type { ToolSpec } from "../../types/index.js";
-export declare const localSearchCode: ToolSpec;
-export declare const RipgrepQuerySchema: z.ZodObject<{
-    keywords: z.ZodOptional<z.ZodString>;
-    path: z.ZodString;
-    mode: z.ZodDefault<z.ZodEnum<{
-        paginated: "paginated";
-        discovery: "discovery";
-        detailed: "detailed";
-        structural: "structural";
-    }>>;
-    pattern: z.ZodOptional<z.ZodString>;
-    rule: z.ZodOptional<z.ZodString>;
-    fixedString: z.ZodOptional<z.ZodBoolean>;
-    perlRegex: z.ZodOptional<z.ZodBoolean>;
-    caseInsensitive: z.ZodOptional<z.ZodBoolean>;
-    caseSensitive: z.ZodOptional<z.ZodBoolean>;
-    wholeWord: z.ZodOptional<z.ZodBoolean>;
-    invertMatch: z.ZodOptional<z.ZodBoolean>;
-    include: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    excludeDir: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    noIgnore: z.ZodOptional<z.ZodBoolean>;
-    hidden: z.ZodOptional<z.ZodBoolean>;
-    filesOnly: z.ZodOptional<z.ZodBoolean>;
-    filesWithoutMatch: z.ZodOptional<z.ZodBoolean>;
-    contextLines: z.ZodOptional<z.ZodNumber>;
-    matchContentLength: z.ZodDefault<z.ZodNumber>;
-    maxMatchesPerFile: z.ZodOptional<z.ZodNumber>;
-    maxFiles: z.ZodOptional<z.ZodNumber>;
-    multiline: z.ZodOptional<z.ZodBoolean>;
-    multilineDotall: z.ZodOptional<z.ZodBoolean>;
-    sort: z.ZodDefault<z.ZodEnum<{
-        path: "path";
-        modified: "modified";
-        created: "created";
-        accessed: "accessed";
-    }>>;
-    sortReverse: z.ZodOptional<z.ZodBoolean>;
-    langType: z.ZodOptional<z.ZodString>;
-    countLinesPerFile: z.ZodOptional<z.ZodBoolean>;
-    countMatchesPerFile: z.ZodOptional<z.ZodBoolean>;
-    matchPage: z.ZodOptional<z.ZodNumber>;
-    itemsPerPage: z.ZodOptional<z.ZodNumber>;
-    page: z.ZodDefault<z.ZodNumber>;
-    id: z.ZodOptional<z.ZodString>;
-    mainResearchGoal: z.ZodOptional<z.ZodString>;
-    researchGoal: z.ZodOptional<z.ZodString>;
-    reasoning: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;

package/dist/resources/tools/localSearchCode.js

@@ -1 +0,0 @@
-import{z as e}from"zod";import{buildObject as t,contextLines as a,DEFAULT_MATCH_CONTENT_LENGTH as s,intRange as i,MAX_MATCH_CONTENT_LENGTH as n,MAX_PAGE_NUMBER as o,metaFields as l,optionalPageNumber as r,pageNumber as c,StringArray as u}from"./_toolkit.js";export const localSearchCode={name:"localSearchCode",description:'Local code/text search for file+line.\nChoose mode first: "paginated" returns snippets; "discovery" returns file paths only — cheapest orientation; "detailed" returns expanded context per match.\nFor count-only output use countLinesPerFile:true or countMatchesPerFile:true — do NOT use mode:"count" (does not exist).\nOutput signal: searchEngine flags when a reduced-capability fallback ran — perlRegex features are dropped and countMatchesPerFile becomes line-count semantics.\nPage only on hasMore; use matchPage for more matches in one file; narrow include/exclude/path before paging noisy results.\nBatch: pass up to 5 {keywords, path} objects in one call — e.g. search same keyword across multiple directories simultaneously.\nevidence.answerReady:true means at least one result exists; check pagination.hasMore separately before deciding to stop.\nPair with lspGetSemantics for semantic navigation — matches[0].line feeds directly as lineHint for definition, references, and call hierarchy.\nmode:"structural" (+ pattern OR rule): AST/shape queries regex can\'t express and that aren\'t symbol-identity questions — e.g. eval($X) call sites excluding comments/strings, or async fns lacking try/catch. pattern is a code-shaped query (foo($X), console.log($$$ARGS)); rule is a YAML relational/composite blob (not/inside/has/all/any). Returns node ranges; matches[].line still feeds lspGetSemantics lineHint. keywords is ignored in this mode.\nNext: localGetFileContent(path, matchString=keyword) to read context; lspGetSemantics(uri=files[0].path, symbolName, lineHint=matches[0].line) for semantics; localViewStructure if root unknown; localFindFiles when searching by filename or metadata.',schema:{keywords:"The search pattern (text or regex). Set fixedString:true for a literal match, or perlRegex:true for advanced regex features (lookaheads, backreferences).",path:"File or directory to search (absolute paths are safest).",mode:'"paginated": matches with snippets. "discovery": file paths only — cheapest, for orienting before you read. "detailed": snippets with surrounding context, for deep reading without a follow-up read. "structural": AST/shape search (set pattern OR rule) for queries regex can\'t express. For counts only, set countLinesPerFile or countMatchesPerFile.',pattern:'mode:"structural" only. An ast-grep code-shaped pattern. Metavariables: $X matches a single node (captured), $$$ARGS matches a list of nodes. E.g. eval($X) / console.log($$$) / oldApi.foo($X). Matches code structure, so comments and strings never false-positive. Mutually exclusive with rule.',rule:'mode:"structural" only. A YAML relational/composite ast-grep rule blob for what plain patterns can\'t express — negation and parent/child relations (not/inside/has/all/any). E.g. "rule:\\n  pattern: await $C\\n  inside:\\n    kind: for_statement\\n    stopBy: end". NOTE: relational sub-rules need stopBy: end to walk all ancestors/descendants, else they silently match nothing. Mutually exclusive with pattern.',fixedString:"Literal match (disables regex). Mutually exclusive with perlRegex.",perlRegex:"Advanced regex (lookaheads, backreferences). Mutually exclusive with fixedString.",caseInsensitive:"Case-insensitive matching. Mutually exclusive with caseSensitive.",caseSensitive:"Case-sensitive matching. Mutually exclusive with caseInsensitive.",wholeWord:"Matches whole words only.",invertMatch:"Returns non-matching lines. To list files lacking the pattern, use filesWithoutMatch instead.",include:"Globs of files to search, e.g. '*.ts', 'src/**/*.tsx'. Only files matching any glob are searched.",exclude:"Globs of files to skip, e.g. '*.min.js', 'dist/**'.",excludeDir:"Directory names to skip entirely (e.g. 'node_modules', 'dist', '.git') — faster than exclude globs for whole directories.",noIgnore:"Searches files normally hidden by .gitignore/.ignore.",hidden:"Includes hidden (dot) files.",filesOnly:"Returns matching file paths without line content. Mutually exclusive with filesWithoutMatch.",filesWithoutMatch:"Returns files that do NOT contain the pattern — useful to find files missing a required import or header. Mutually exclusive with filesOnly.",contextLines:"Lines of context around each match. Pair with mode:'detailed' for self-contained snippets.",matchContentLength:"Characters kept per match snippet. Raise for minified code or JSON, or when truncation hides matches.",maxMatchesPerFile:"Caps matches per file and sets the per-file page size; when a file has more, file.pagination.hasMore appears — page it with matchPage. No effect in filesOnly/count modes.",maxFiles:"Caps how many matched files are returned.",multiline:"Lets a match span lines. Add multilineDotall to let . cross newlines.",multilineDotall:"Lets . match newlines too. Requires multiline:true.",sort:"Order results by path, modified time, access time, or creation time.",sortReverse:"Reverses the sort (e.g. sort:'modified' + sortReverse:true = oldest first).",langType:"Language filter (ts, js, py, go, rust, …) — more precise than include globs.",countLinesPerFile:"Returns the count of matching lines per file instead of content — good for orientation (which files have the most hits). Mutually exclusive with countMatchesPerFile.",countMatchesPerFile:"Returns the total match count per file (counts multiple hits on one line). Mutually exclusive with countLinesPerFile.",matchPage:"Page within one file's matches; pair with maxMatchesPerFile to walk a noisy file.",itemsPerPage:"Files per page.",page:"Result page."}};export const RipgrepQuerySchema=t(localSearchCode.schema,{...l,keywords:e.string().optional(),path:e.string(),mode:e.enum(["paginated","discovery","detailed","structural"]).default("paginated"),pattern:e.string().optional(),rule:e.string().optional(),fixedString:e.boolean().optional(),perlRegex:e.boolean().optional(),caseInsensitive:e.boolean().optional(),caseSensitive:e.boolean().optional(),wholeWord:e.boolean().optional(),invertMatch:e.boolean().optional(),include:u,exclude:u,excludeDir:u,noIgnore:e.boolean().optional(),hidden:e.boolean().optional(),filesOnly:e.boolean().optional(),filesWithoutMatch:e.boolean().optional(),contextLines:a(),matchContentLength:i(1,n).default(s),maxMatchesPerFile:i(1,n).optional(),maxFiles:i(1,n).optional(),multiline:e.boolean().optional(),multilineDotall:e.boolean().optional(),sort:e.enum(["path","modified","accessed","created"]).default("path"),sortReverse:e.boolean().optional(),langType:e.string().optional(),countLinesPerFile:e.boolean().optional(),countMatchesPerFile:e.boolean().optional(),matchPage:r(),itemsPerPage:i(1,o).optional(),page:c()}).superRefine((e,t)=>{if("structural"===e.mode){e.pattern||e.rule||t.addIssue({code:"custom",message:'mode:"structural" requires `pattern` (a code-shaped query) or `rule` (a YAML relational rule).',path:["pattern"]}),e.pattern&&e.rule&&t.addIssue({code:"custom",message:"`pattern` and `rule` are mutually exclusive.",path:["rule"]});for(const a of["fixedString","perlRegex","wholeWord","invertMatch","multiline","multilineDotall"])e[a]&&t.addIssue({code:"custom",message:`\`${a}\` is not valid with mode:"structural".`,path:[a]})}else(e.pattern||e.rule)&&t.addIssue({code:"custom",message:'`pattern`/`rule` require mode:"structural".',path:[e.pattern?"pattern":"rule"]}),e.keywords||t.addIssue({code:"custom",message:'`keywords` is required unless mode:"structural".',path:["keywords"]});e.filesOnly&&e.filesWithoutMatch&&t.addIssue({code:"custom",message:"filesOnly and filesWithoutMatch are mutually exclusive.",path:["filesWithoutMatch"]}),e.fixedString&&e.perlRegex&&t.addIssue({code:"custom",message:"fixedString and perlRegex are mutually exclusive.",path:["perlRegex"]}),e.caseSensitive&&e.caseInsensitive&&t.addIssue({code:"custom",message:"caseSensitive and caseInsensitive are mutually exclusive.",path:["caseInsensitive"]}),e.multilineDotall&&!e.multiline&&t.addIssue({code:"custom",message:"multilineDotall requires multiline=true.",path:["multilineDotall"]}),e.countLinesPerFile&&e.countMatchesPerFile&&t.addIssue({code:"custom",message:"countLinesPerFile and countMatchesPerFile are mutually exclusive.",path:["countMatchesPerFile"]})});

package/dist/resources/tools/localViewStructure.d.ts

@@ -1,29 +0,0 @@
-import { z } from "zod";
-import type { ToolSpec } from "../../types/index.js";
-export declare const localViewStructure: ToolSpec;
-export declare const ViewStructureQuerySchema: z.ZodObject<{
-    path: z.ZodString;
-    details: z.ZodOptional<z.ZodBoolean>;
-    hidden: z.ZodOptional<z.ZodBoolean>;
-    sortBy: z.ZodDefault<z.ZodEnum<{
-        extension: "extension";
-        size: "size";
-        name: "name";
-        time: "time";
-    }>>;
-    reverse: z.ZodOptional<z.ZodBoolean>;
-    pattern: z.ZodOptional<z.ZodString>;
-    directoriesOnly: z.ZodOptional<z.ZodBoolean>;
-    filesOnly: z.ZodOptional<z.ZodBoolean>;
-    recursive: z.ZodOptional<z.ZodBoolean>;
-    extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    maxDepth: z.ZodOptional<z.ZodNumber>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    showFileLastModified: z.ZodOptional<z.ZodBoolean>;
-    page: z.ZodDefault<z.ZodNumber>;
-    itemsPerPage: z.ZodOptional<z.ZodNumber>;
-    id: z.ZodOptional<z.ZodString>;
-    mainResearchGoal: z.ZodOptional<z.ZodString>;
-    researchGoal: z.ZodOptional<z.ZodString>;
-    reasoning: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;

package/dist/resources/tools/localViewStructure.js

@@ -1 +0,0 @@
-import{z as e}from"zod";import{buildObject as t,intRange as i,MAX_LOCAL_DEPTH as o,MAX_LOCAL_ITEMS_PER_PAGE as s,MAX_LOCAL_LIMIT as n,metaFields as a,pageNumber as r,StringArray as l}from"./_toolkit.js";export const localViewStructure={name:"localViewStructure",description:'Browse a local directory tree. Returns files[], folders[], and links[] (symlinks) at each level. When details:true or showFileLastModified:true, switches to entries[] objects with size, permissions, and timestamps.\nUse this to map a directory before searching. Use localFindFiles when you need metadata (size, modified date) or filename patterns. Use localSearchCode(mode:"discovery") to find which files contain a pattern.\nMutual exclusion: filesOnly and directoriesOnly cannot both be true.\nBulk: queries:[{path:d1},{path:d2}] to browse multiple directories in one call (max 5).\nPaginate with page=N when pagination.hasMore is true.\nNext: localGetFileContent(path), localSearchCode, lspGetSemantics after localSearchCode gives uri/symbolName/lineHint.',schema:{path:"Directory to browse (absolute or workspace-relative). Defaults to the workspace root.",details:"Returns per-entry objects with size, permissions, and dates (structured entries[] output).",hidden:"Includes hidden (dot) files and directories, e.g. .env, .git, .github.",sortBy:"Ordering. 'name': A–Z. 'size': by bytes. 'time': by last-modified (implicitly enables showFileLastModified). 'extension': grouped by file type.",reverse:"Reverses the sort (e.g. sortBy:'time' + reverse:true = oldest first).",pattern:"Name filter — a glob (e.g. '*.ts') or plain substring; only matching entries are returned. For regex, use localFindFiles.",directoriesOnly:"Returns directories only. Mutually exclusive with filesOnly.",filesOnly:"Returns files only. Mutually exclusive with directoriesOnly.",recursive:"Descends into subdirectories (top level only when off). When on without maxDepth, depth is capped automatically; set maxDepth to control cost.",extensions:"Extension whitelist, without dots, e.g. ['ts', 'tsx', 'js']. Only matching files are returned; directories always appear.",maxDepth:"Recursion depth when recursive is on (0 = immediate children). Start shallow on large monorepos, then drill in.",limit:"Caps how many entries are discovered before pagination — guards against huge scans. Distinct from page size.",showFileLastModified:"Adds last-modified timestamps per file. Independent of details. Use to spot recently changed files without switching to localFindFiles.",page:"Result page.",itemsPerPage:"Entries per page."}};export const ViewStructureQuerySchema=t(localViewStructure.schema,{...a,path:e.string(),details:e.boolean().optional(),hidden:e.boolean().optional(),sortBy:e.enum(["name","size","time","extension"]).default("name"),reverse:e.boolean().optional(),pattern:e.string().optional(),directoriesOnly:e.boolean().optional(),filesOnly:e.boolean().optional(),recursive:e.boolean().optional(),extensions:l,maxDepth:i(0,o).optional(),limit:i(1,n).optional(),showFileLastModified:e.boolean().optional(),page:r(),itemsPerPage:i(1,s).optional()}).superRefine((e,t)=>{e.filesOnly&&e.directoriesOnly&&t.addIssue({code:"custom",message:"filesOnly and directoriesOnly are mutually exclusive.",path:["directoriesOnly"]})});

package/dist/resources/tools/lspGetSemantics.d.ts

@@ -1,79 +0,0 @@
-import { z } from "zod";
-import type { ToolSpec } from "../../types/index.js";
-export declare const lspGetSemantics: ToolSpec;
-export declare const LSPGotoDefinitionQuerySchema: z.ZodObject<{
-    contextLines: z.ZodOptional<z.ZodNumber>;
-    uri: z.ZodString;
-    symbolName: z.ZodString;
-    lineHint: z.ZodNumber;
-    orderHint: z.ZodDefault<z.ZodNumber>;
-    id: z.ZodOptional<z.ZodString>;
-    mainResearchGoal: z.ZodOptional<z.ZodString>;
-    researchGoal: z.ZodOptional<z.ZodString>;
-    reasoning: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export declare const LSPFindReferencesQuerySchema: z.ZodObject<{
-    includeDeclaration: z.ZodOptional<z.ZodBoolean>;
-    contextLines: z.ZodOptional<z.ZodNumber>;
-    itemsPerPage: z.ZodOptional<z.ZodNumber>;
-    page: z.ZodDefault<z.ZodNumber>;
-    groupByFile: z.ZodOptional<z.ZodBoolean>;
-    uri: z.ZodString;
-    symbolName: z.ZodString;
-    lineHint: z.ZodNumber;
-    orderHint: z.ZodDefault<z.ZodNumber>;
-    id: z.ZodOptional<z.ZodString>;
-    mainResearchGoal: z.ZodOptional<z.ZodString>;
-    researchGoal: z.ZodOptional<z.ZodString>;
-    reasoning: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export declare const LSPCallHierarchyQuerySchema: z.ZodObject<{
-    direction: z.ZodEnum<{
-        incoming: "incoming";
-        outgoing: "outgoing";
-    }>;
-    depth: z.ZodOptional<z.ZodNumber>;
-    contextLines: z.ZodOptional<z.ZodNumber>;
-    itemsPerPage: z.ZodOptional<z.ZodNumber>;
-    page: z.ZodDefault<z.ZodNumber>;
-    uri: z.ZodString;
-    symbolName: z.ZodString;
-    lineHint: z.ZodNumber;
-    orderHint: z.ZodDefault<z.ZodNumber>;
-    id: z.ZodOptional<z.ZodString>;
-    mainResearchGoal: z.ZodOptional<z.ZodString>;
-    researchGoal: z.ZodOptional<z.ZodString>;
-    reasoning: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export declare const LspGetSemanticsQuerySchema: z.ZodObject<{
-    uri: z.ZodString;
-    type: z.ZodDefault<z.ZodEnum<{
-        references: "references";
-        definition: "definition";
-        callers: "callers";
-        callees: "callees";
-        callHierarchy: "callHierarchy";
-        hover: "hover";
-        documentSymbols: "documentSymbols";
-        typeDefinition: "typeDefinition";
-        implementation: "implementation";
-    }>>;
-    symbolName: z.ZodOptional<z.ZodString>;
-    lineHint: z.ZodOptional<z.ZodNumber>;
-    orderHint: z.ZodDefault<z.ZodNumber>;
-    depth: z.ZodOptional<z.ZodNumber>;
-    includeDeclaration: z.ZodDefault<z.ZodBoolean>;
-    groupByFile: z.ZodOptional<z.ZodBoolean>;
-    page: z.ZodDefault<z.ZodNumber>;
-    itemsPerPage: z.ZodOptional<z.ZodNumber>;
-    contextLines: z.ZodOptional<z.ZodNumber>;
-    format: z.ZodDefault<z.ZodEnum<{
-        structured: "structured";
-        compact: "compact";
-    }>>;
-    workspaceRoot: z.ZodOptional<z.ZodString>;
-    id: z.ZodOptional<z.ZodString>;
-    mainResearchGoal: z.ZodOptional<z.ZodString>;
-    researchGoal: z.ZodOptional<z.ZodString>;
-    reasoning: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;