@octocodeai/octocode-core 16.2.1 → 16.3.0

package/dist/resources/tools/lspGetSemantics.js

@@ -1 +0,0 @@
-import{z as e}from"zod";import{buildObject as t,contextLines as n,intRange as o,MAX_LINE_NUMBER as i,MAX_LOCAL_DEPTH as l,MAX_ORDER_HINT as a,MAX_PR_ITEMS_PER_PAGE as s,metaFields as r,pageNumber as c}from"./_toolkit.js";export const lspGetSemantics={name:"lspGetSemantics",description:"Typed LSP queries for semantic navigation (default type: definition).\nPrerequisites: all types except documentSymbols require symbolName + lineHint. lineHint must come from a real localSearchCode match (matches[0].line) — never guess. A wrong lineHint causes silent empty results. If lineHint is unknown: run documentSymbols (uri only) or localSearchCode first.\nType routing: documentSymbols=file outline (uri only); hover=signature+JSDoc; definition=jump to decl; typeDefinition=generic types; implementation=abstract member impl (member name, not class); references=same-package usages (bounded by the language server's open files, NOT cross-package — zero results does NOT mean unused, try callers); callers=cross-package incoming calls (TS/JS/Go/Rust only — Python/C++ use references instead); callees=outgoing calls; callHierarchy=both.\nToken efficiency: format:\"compact\" on callers/callees/callHierarchy → significantly fewer tokens. groupByFile:true on references → per-file summary with lines[] (each is a valid lineHint for follow-up calls). contextLines=3–10 on callers/callees embeds source context, reducing follow-up localGetFileContent calls.\nLanguage tiers — Tier 1 all types: TS/JS/Go/Rust. Tier 2 no callHierarchy: Python/C++. Tier 3 documentSymbols+hover+definition only: Shell/HTML/CSS/YAML/TOML.\nOutput signal: resolvedSymbol.foundAtLine confirms which line LSP resolved — if far from lineHint, re-run localSearchCode to get an accurate anchor. payload.kind='empty' means LSP returned no results (symbolNotFound → re-anchor with localSearchCode; serverUnavailable → fall back to localSearchCode). In callers/callees results, each ranges[].line is the lineHint for the next lspGetSemantics call on that symbol.\nevidence.answerReady:true — stop calling.\nNext: localGetFileContent(startLine/endLine) to read the definition; lspGetSemantics(callers) for impact analysis. Batch: up to 5 queries per call — combine definition+hover or definition+callers in one request.",schema:{uri:"Target source file as an absolute path or file:/// URI.",type:"Which query to run — see the type-routing list in the description.",symbolName:"Exact identifier sitting at lineHint — bare name only, no parentheses or type annotations (e.g. 'fetchPRDetail', not 'fetchPRDetail()'). Case-sensitive, must match the token exactly. Required for every type except documentSymbols.",lineHint:"Line where symbolName appears. Must come from a real localSearchCode match (matches[0].line) — never guess; a wrong value silently returns nothing. Required for every type except documentSymbols.",orderHint:"Disambiguates when symbolName occurs multiple times on lineHint (e.g. overloads, chained calls) — increment if you get the wrong symbol.",depth:"Recursion depth for callHierarchy/callers/callees — immediate calls only unless raised. Raise for full chains; pair high depth on hot symbols with format:'compact' to limit size.",includeDeclaration:"references: whether to include the symbol's own declaration. Set false to get only usages, not the definition site.",groupByFile:"references: returns a per-file summary (path + count + all line numbers in lines[]) instead of per-location rows — ideal for blast radius; each line is a valid lineHint for follow-ups.",page:"Result page for documentSymbols and call-flow results.",itemsPerPage:"Items per page (symbol/location lists get a larger page than call-flow results).",contextLines:"Source lines around each call site in callers/callees/callHierarchy (locations only unless set). Raise to embed calling context and skip a follow-up localGetFileContent.",format:'"structured": typed objects with full location metadata. "compact": line-oriented strings, far fewer tokens. Prefer "compact" for navigation; use "structured" only when parsing locations programmatically.',workspaceRoot:"Overrides the LSP workspace root (absolute path). Omit to auto-resolve from uri; needed only when the server spans multiple roots."}};const m={...r,uri:e.string(),symbolName:e.string(),lineHint:o(1,i),orderHint:o(0,a).default(0)};export const LSPGotoDefinitionQuerySchema=t(lspGetSemantics.schema,{...m,contextLines:n()});export const LSPFindReferencesQuerySchema=t(lspGetSemantics.schema,{...m,includeDeclaration:e.boolean().optional(),contextLines:n(),itemsPerPage:o(1,s).optional(),page:c(),groupByFile:e.boolean().optional()});export const LSPCallHierarchyQuerySchema=t(lspGetSemantics.schema,{...m,direction:e.enum(["incoming","outgoing"]),depth:o(0,l).optional(),contextLines:n(),itemsPerPage:o(1,s).optional(),page:c()});export const LspGetSemanticsQuerySchema=t(lspGetSemantics.schema,{...r,uri:e.string(),type:e.enum(["definition","references","callers","callees","callHierarchy","hover","documentSymbols","typeDefinition","implementation"]).default("definition"),symbolName:e.string().min(1).optional(),lineHint:o(1,i).optional(),orderHint:o(0,a).default(0),depth:o(0,l).optional(),includeDeclaration:e.boolean().default(!0),groupByFile:e.boolean().optional(),page:c(),itemsPerPage:o(1,s).optional(),contextLines:n(),format:e.enum(["structured","compact"]).default("structured"),workspaceRoot:e.string().optional()}).superRefine((e,t)=>{"documentSymbols"!==e.type&&(e.symbolName||t.addIssue({code:"custom",path:["symbolName"],message:"symbolName is required unless type is documentSymbols"}),Number.isInteger(e.lineHint)||t.addIssue({code:"custom",path:["lineHint"],message:"lineHint is required unless type is documentSymbols"}))});

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

@@ -1,11 +0,0 @@
-import { z } from "zod";
-import type { ToolSpec } from "../../types/index.js";
-export declare const npmSearch: ToolSpec;
-export declare const NpmPackageQuerySchema: z.ZodObject<{
-    packageName: z.ZodString;
-    page: z.ZodDefault<z.ZodNumber>;
-    id: z.ZodOptional<z.ZodString>;
-    mainResearchGoal: z.ZodOptional<z.ZodString>;
-    researchGoal: z.ZodOptional<z.ZodString>;
-    reasoning: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;

package/dist/resources/tools/npmSearch.js

@@ -1 +0,0 @@
-import{z as e}from"zod";import{buildObject as r,metaFields as t,pageNumber as a}from"./_toolkit.js";export const npmSearch={name:"npmSearch",description:'npm package lookup and keyword search. Returns package metadata and source repository handoff.\nExact package name (e.g. "react", "@octokit/rest") returns one rich result with version, description, keywords, and repository owner/repo for GitHub handoff.\nKeyword query (e.g. "http client typescript") returns lean results — paginate with page; pagination.hasMore and totalFound available in output.\nWhen owner+repo is present in the result, pass directly to ghViewRepoStructure or ghSearchCode. If a repositoryDirectory path follows owner/repo in the result, pass it as path= to ghViewRepoStructure to scope the tree to the package subdirectory.\nSkip if owner/repo is already known — go directly to ghViewRepoStructure.\nBatch up to 5 packages in one call: queries:[{packageName:"react"},{packageName:"lodash"}].\nNext: ghViewRepoStructure or ghSearchCode when owner/repo exists; ghSearchRepos when owner/repo is absent or non-GitHub.',schema:{packageName:"An exact npm package name or a keyword query. An exact name (e.g. 'react', '@octokit/rest') returns one rich result, or empty if it doesn't exist (check spelling before assuming it's private). A keyword query returns a lean list. Scoped packages need the full scope: '@octokit/rest', not 'rest'.",page:"Page for keyword results; exact-name lookups always return page 1. Paginate while pagination.hasMore."}};export const NpmPackageQuerySchema=r(npmSearch.schema,{...t,packageName:e.string(),page:a()});

package/dist/schemas/extraTypes.d.ts

@@ -1,178 +0,0 @@
-import type { CharPagination, LspRange, LspLocation, LspMode, PaginationInfo, LocalSearchCodeFile, LocalFindFilesEntry, GitHubRepositoryItem, GitHubPullRequestItem, GitHubSearchCodeGroup, GitHubFileContentData } from "../types/index.js";
-export interface BaseQuery {
-    id?: string;
-    mainResearchGoal?: string;
-    researchGoal?: string;
-    reasoning?: string;
-    verbose?: boolean;
-}
-export interface BaseQueryLocal extends BaseQuery {
-    path?: string;
-}
-export interface LspExactPosition {
-    uri: string;
-    line: number;
-    character: number;
-}
-export interface LspCallHierarchyItem {
-    name: string;
-    uri: string;
-    range: LspRange;
-    content?: string;
-}
-export interface LspIncomingCall {
-    from: LspCallHierarchyItem;
-    fromRanges?: LspRange[];
-}
-export interface LspOutgoingCall {
-    to: LspCallHierarchyItem;
-    fromRanges?: LspRange[];
-}
-interface BaseToolResult {
-    status?: "empty" | "error";
-    hints?: readonly string[] | string[];
-    warnings?: string[];
-    error?: string;
-    errorCode?: string;
-    rawResponseChars?: number;
-    [key: string]: unknown;
-}
-export interface LocalSearchCodeToolResult extends BaseToolResult {
-    files?: LocalSearchCodeFile[];
-    pagination?: PaginationInfo;
-    searchEngine?: string;
-}
-export interface LocalFindFilesToolResult extends BaseToolResult {
-    files?: LocalFindFilesEntry[];
-    pagination?: PaginationInfo;
-}
-export interface MatchRange {
-    start: number;
-    end: number;
-}
-export interface LocalGetFileContentToolResult extends BaseToolResult {
-    content?: string;
-    contentView?: "none" | "standard" | "symbols";
-    isSkeleton?: boolean;
-    totalLines?: number;
-    startLine?: number;
-    endLine?: number;
-    isPartial?: boolean;
-    matchRanges?: MatchRange[];
-    pagination?: CharPagination | PaginationInfo;
-    modified?: string;
-    lastModified?: string;
-    lastModifiedBy?: string;
-    filePath?: string;
-}
-export interface LocalViewStructureEntryFlat {
-    name?: string;
-    type: "file" | "dir" | "link" | "directory" | "symlink";
-    path?: string;
-    depth?: number;
-    size?: number | string;
-    modified?: string;
-    permissions?: string;
-}
-export interface LocalViewStructureToolResult extends BaseToolResult {
-    entries?: LocalViewStructureEntryFlat[];
-    path?: string;
-    files?: string[];
-    folders?: string[];
-    links?: string[];
-    summary?: string | Record<string, unknown>;
-    pagination?: PaginationInfo;
-}
-export interface LspGotoDefinitionToolResult extends BaseToolResult {
-    locations?: LspLocation[];
-    lspMode?: LspMode;
-}
-export interface LspFindReferencesToolResult extends BaseToolResult {
-    locations?: LspLocation[];
-    references?: LspLocation[];
-    pagination?: PaginationInfo;
-    lspMode?: LspMode;
-}
-export interface LspCallHierarchyToolResult extends BaseToolResult {
-    item?: LspCallHierarchyItem;
-    incomingCalls?: LspIncomingCall[];
-    outgoingCalls?: LspOutgoingCall[];
-    direction?: "incoming" | "outgoing";
-    depth?: number;
-    pagination?: PaginationInfo;
-    lspMode?: LspMode;
-}
-export interface GitHubRepoStructureDirectoryEntry {
-    files: string[];
-    folders: string[];
-}
-export interface GitHubDirectoryFileEntry {
-    path: string;
-    size: number;
-    type: string;
-}
-export interface GitHubSearchCodeToolResult extends BaseToolResult {
-    results?: GitHubSearchCodeGroup[];
-    pagination?: PaginationInfo;
-    outputPagination?: CharPagination;
-}
-export interface GitHubFetchContentToolResult extends BaseToolResult {
-    results?: GitHubFileContentData[];
-    pagination?: CharPagination;
-}
-export interface GitHubViewRepoStructureToolResult extends BaseToolResult {
-    resolvedBranch?: string;
-    branchFallback?: {
-        requestedBranch: string;
-        actualBranch: string;
-    };
-    structure?: Record<string, GitHubRepoStructureDirectoryEntry>;
-    summary?: {
-        totalFiles?: number;
-        totalFolders?: number;
-        truncated?: boolean;
-        filtered?: boolean;
-        originalCount?: number;
-    };
-    pagination?: PaginationInfo;
-}
-export interface GitHubSearchRepositoriesToolResult extends BaseToolResult {
-    repositories?: GitHubRepositoryItem[];
-    pagination?: PaginationInfo;
-}
-export interface GitHubSearchPullRequestsToolResult extends BaseToolResult {
-    pull_requests?: GitHubPullRequestItem[];
-    total_count?: number;
-    pagination?: PaginationInfo;
-    outputPagination?: {
-        charOffset: number;
-        charLength: number;
-        totalChars: number;
-        hasMore: boolean;
-        currentPage: number;
-        totalPages: number;
-    };
-}
-export interface GitHubRepositoryOutput {
-    owner: string;
-    repo: string;
-    defaultBranch: string;
-    stars: number;
-    description: string;
-    url: string;
-    createdAt: string;
-    updatedAt: string;
-    pushedAt: string;
-    visibility: "public" | "private" | "internal";
-    topics: string[];
-    forksCount: number;
-    openIssuesCount?: number;
-    language?: string;
-    license?: string;
-    homepage?: string;
-}
-export interface GitHubSearchRepositoriesData {
-    repositories: GitHubRepositoryOutput[];
-    pagination?: PaginationInfo;
-}
-export {};

package/dist/schemas/extraTypes.js

@@ -1 +0,0 @@
-export{};

package/dist/schemas/index.d.ts

@@ -1,13 +0,0 @@
-export { GitHubCodeSearchQuerySchema } from "../resources/tools/ghSearchCode.js";
-export { FileContentQuerySchema } from "../resources/tools/ghGetFileContent.js";
-export { GitHubViewRepoStructureQuerySchema } from "../resources/tools/ghViewRepoStructure.js";
-export { GitHubReposSearchSingleQuerySchema } from "../resources/tools/ghSearchRepos.js";
-export { GitHubPullRequestSearchQuerySchema } from "../resources/tools/ghHistoryResearch.js";
-export { NpmPackageQuerySchema } from "../resources/tools/npmSearch.js";
-export { CloneRepoQuerySchema, BulkCloneRepoSchema, } from "../resources/tools/ghCloneRepo.js";
-export { RipgrepQuerySchema } from "../resources/tools/localSearchCode.js";
-export { FetchContentQuerySchema } from "../resources/tools/localGetFileContent.js";
-export { FindFilesQuerySchema } from "../resources/tools/localFindFiles.js";
-export { ViewStructureQuerySchema } from "../resources/tools/localViewStructure.js";
-export { LspGetSemanticsQuerySchema, LSPGotoDefinitionQuerySchema, LSPFindReferencesQuerySchema, LSPCallHierarchyQuerySchema, } from "../resources/tools/lspGetSemantics.js";
-export { LocalBinaryInspectQuerySchema } from "../resources/tools/localBinaryInspect.js";

package/dist/schemas/index.js

@@ -1 +0,0 @@
-export{GitHubCodeSearchQuerySchema}from"../resources/tools/ghSearchCode.js";export{FileContentQuerySchema}from"../resources/tools/ghGetFileContent.js";export{GitHubViewRepoStructureQuerySchema}from"../resources/tools/ghViewRepoStructure.js";export{GitHubReposSearchSingleQuerySchema}from"../resources/tools/ghSearchRepos.js";export{GitHubPullRequestSearchQuerySchema}from"../resources/tools/ghHistoryResearch.js";export{NpmPackageQuerySchema}from"../resources/tools/npmSearch.js";export{CloneRepoQuerySchema,BulkCloneRepoSchema}from"../resources/tools/ghCloneRepo.js";export{RipgrepQuerySchema}from"../resources/tools/localSearchCode.js";export{FetchContentQuerySchema}from"../resources/tools/localGetFileContent.js";export{FindFilesQuerySchema}from"../resources/tools/localFindFiles.js";export{ViewStructureQuerySchema}from"../resources/tools/localViewStructure.js";export{LspGetSemanticsQuerySchema,LSPGotoDefinitionQuerySchema,LSPFindReferencesQuerySchema,LSPCallHierarchyQuerySchema}from"../resources/tools/lspGetSemantics.js";export{LocalBinaryInspectQuerySchema}from"../resources/tools/localBinaryInspect.js";