@octocodeai/octocode-tools-core 16.3.0 → 16.6.0

package/dist/tools/lsp/semantic_content/scheme.d.ts

@@ -1,9 +1,9 @@
 import { z } from 'zod';
 export declare const LspGetSemanticsQueryDisplaySchema: z.ZodObject<{
-    uri: z.ZodString;
+    uri: z.ZodOptional<z.ZodString>;
     type: z.ZodDefault<z.ZodEnum<{
-        references: "references";
         definition: "definition";
+        references: "references";
         callers: "callers";
         callees: "callees";
         callHierarchy: "callHierarchy";
@@ -11,6 +11,10 @@ export declare const LspGetSemanticsQueryDisplaySchema: z.ZodObject<{
         documentSymbols: "documentSymbols";
         typeDefinition: "typeDefinition";
         implementation: "implementation";
+        workspaceSymbol: "workspaceSymbol";
+        supertypes: "supertypes";
+        subtypes: "subtypes";
+        diagnostic: "diagnostic";
     }>>;
     symbolName: z.ZodOptional<z.ZodString>;
     lineHint: z.ZodOptional<z.ZodNumber>;
@@ -32,10 +36,10 @@ export declare const LspGetSemanticsQueryDisplaySchema: z.ZodObject<{
     reasoning: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const LspGetSemanticsQuerySchema: z.ZodObject<{
-    uri: z.ZodString;
+    uri: z.ZodOptional<z.ZodString>;
     type: z.ZodDefault<z.ZodEnum<{
-        references: "references";
         definition: "definition";
+        references: "references";
         callers: "callers";
         callees: "callees";
         callHierarchy: "callHierarchy";
@@ -43,6 +47,10 @@ export declare const LspGetSemanticsQuerySchema: z.ZodObject<{
         documentSymbols: "documentSymbols";
         typeDefinition: "typeDefinition";
         implementation: "implementation";
+        workspaceSymbol: "workspaceSymbol";
+        supertypes: "supertypes";
+        subtypes: "subtypes";
+        diagnostic: "diagnostic";
     }>>;
     symbolName: z.ZodOptional<z.ZodString>;
     lineHint: z.ZodOptional<z.ZodNumber>;
@@ -64,14 +72,13 @@ export declare const LspGetSemanticsQuerySchema: z.ZodObject<{
     reasoning: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const BulkLspGetSemanticsQuerySchema: z.ZodObject<{
-    responseCharOffset: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
-    responseCharLength: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    responseCharOffset: z.ZodOptional<z.ZodPreprocess<z.ZodNumber>>;
+    responseCharLength: z.ZodOptional<z.ZodPreprocess<z.ZodNumber>>;
     queries: z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
 }, z.core.$strip>;
 export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
     base: z.ZodOptional<z.ZodString>;
     shared: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
-    hints: z.ZodOptional<z.ZodArray<z.ZodString>>;
     results: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
         id: z.ZodString;
         status: z.ZodLiteral<"empty">;
@@ -157,6 +164,9 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
                         noReferences: "noReferences";
                         noHover: "noHover";
                         noCalls: "noCalls";
+                        noWorkspaceSymbols: "noWorkspaceSymbols";
+                        noTypeHierarchy: "noTypeHierarchy";
+                        noDiagnostics: "noDiagnostics";
                     }>;
                     reason: z.ZodString;
                 }, z.core.$strip>>;
@@ -216,6 +226,9 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
                         noReferences: "noReferences";
                         noHover: "noHover";
                         noCalls: "noCalls";
+                        noWorkspaceSymbols: "noWorkspaceSymbols";
+                        noTypeHierarchy: "noTypeHierarchy";
+                        noDiagnostics: "noDiagnostics";
                     }>;
                     reason: z.ZodString;
                 }, z.core.$strip>>;
@@ -256,6 +269,77 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
                         noReferences: "noReferences";
                         noHover: "noHover";
                         noCalls: "noCalls";
+                        noWorkspaceSymbols: "noWorkspaceSymbols";
+                        noTypeHierarchy: "noTypeHierarchy";
+                        noDiagnostics: "noDiagnostics";
+                    }>;
+                    reason: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"workspaceSymbol">;
+                query: z.ZodString;
+                symbols: z.ZodArray<z.ZodUnknown>;
+                totalSymbols: z.ZodNumber;
+                empty: z.ZodOptional<z.ZodObject<{
+                    category: z.ZodEnum<{
+                        serverUnavailable: "serverUnavailable";
+                        unsupportedOperation: "unsupportedOperation";
+                        symbolNotFound: "symbolNotFound";
+                        anchorFailed: "anchorFailed";
+                        noLocations: "noLocations";
+                        noReferences: "noReferences";
+                        noHover: "noHover";
+                        noCalls: "noCalls";
+                        noWorkspaceSymbols: "noWorkspaceSymbols";
+                        noTypeHierarchy: "noTypeHierarchy";
+                        noDiagnostics: "noDiagnostics";
+                    }>;
+                    reason: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"typeHierarchy">;
+                direction: z.ZodEnum<{
+                    supertypes: "supertypes";
+                    subtypes: "subtypes";
+                }>;
+                root: z.ZodOptional<z.ZodUnknown>;
+                items: z.ZodArray<z.ZodUnknown>;
+                totalItems: z.ZodNumber;
+                empty: z.ZodOptional<z.ZodObject<{
+                    category: z.ZodEnum<{
+                        serverUnavailable: "serverUnavailable";
+                        unsupportedOperation: "unsupportedOperation";
+                        symbolNotFound: "symbolNotFound";
+                        anchorFailed: "anchorFailed";
+                        noLocations: "noLocations";
+                        noReferences: "noReferences";
+                        noHover: "noHover";
+                        noCalls: "noCalls";
+                        noWorkspaceSymbols: "noWorkspaceSymbols";
+                        noTypeHierarchy: "noTypeHierarchy";
+                        noDiagnostics: "noDiagnostics";
+                    }>;
+                    reason: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"diagnostic">;
+                diagnostics: z.ZodArray<z.ZodUnknown>;
+                totalDiagnostics: z.ZodNumber;
+                errorCount: z.ZodNumber;
+                warningCount: z.ZodNumber;
+                empty: z.ZodOptional<z.ZodObject<{
+                    category: z.ZodEnum<{
+                        serverUnavailable: "serverUnavailable";
+                        unsupportedOperation: "unsupportedOperation";
+                        symbolNotFound: "symbolNotFound";
+                        anchorFailed: "anchorFailed";
+                        noLocations: "noLocations";
+                        noReferences: "noReferences";
+                        noHover: "noHover";
+                        noCalls: "noCalls";
+                        noWorkspaceSymbols: "noWorkspaceSymbols";
+                        noTypeHierarchy: "noTypeHierarchy";
+                        noDiagnostics: "noDiagnostics";
                     }>;
                     reason: z.ZodString;
                 }, z.core.$strip>>;
@@ -270,6 +354,9 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
                     noReferences: "noReferences";
                     noHover: "noHover";
                     noCalls: "noCalls";
+                    noWorkspaceSymbols: "noWorkspaceSymbols";
+                    noTypeHierarchy: "noTypeHierarchy";
+                    noDiagnostics: "noDiagnostics";
                 }>;
                 reason: z.ZodString;
             }, z.core.$strip>], "kind">;
@@ -283,7 +370,6 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
             }, z.core.$strip>>;
             summary: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            hints: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
@@ -291,7 +377,6 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
         data: z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             error: z.ZodString;
-            hints: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
@@ -377,6 +462,9 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
                         noReferences: "noReferences";
                         noHover: "noHover";
                         noCalls: "noCalls";
+                        noWorkspaceSymbols: "noWorkspaceSymbols";
+                        noTypeHierarchy: "noTypeHierarchy";
+                        noDiagnostics: "noDiagnostics";
                     }>;
                     reason: z.ZodString;
                 }, z.core.$strip>>;
@@ -436,6 +524,9 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
                         noReferences: "noReferences";
                         noHover: "noHover";
                         noCalls: "noCalls";
+                        noWorkspaceSymbols: "noWorkspaceSymbols";
+                        noTypeHierarchy: "noTypeHierarchy";
+                        noDiagnostics: "noDiagnostics";
                     }>;
                     reason: z.ZodString;
                 }, z.core.$strip>>;
@@ -476,6 +567,77 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
                         noReferences: "noReferences";
                         noHover: "noHover";
                         noCalls: "noCalls";
+                        noWorkspaceSymbols: "noWorkspaceSymbols";
+                        noTypeHierarchy: "noTypeHierarchy";
+                        noDiagnostics: "noDiagnostics";
+                    }>;
+                    reason: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"workspaceSymbol">;
+                query: z.ZodString;
+                symbols: z.ZodArray<z.ZodUnknown>;
+                totalSymbols: z.ZodNumber;
+                empty: z.ZodOptional<z.ZodObject<{
+                    category: z.ZodEnum<{
+                        serverUnavailable: "serverUnavailable";
+                        unsupportedOperation: "unsupportedOperation";
+                        symbolNotFound: "symbolNotFound";
+                        anchorFailed: "anchorFailed";
+                        noLocations: "noLocations";
+                        noReferences: "noReferences";
+                        noHover: "noHover";
+                        noCalls: "noCalls";
+                        noWorkspaceSymbols: "noWorkspaceSymbols";
+                        noTypeHierarchy: "noTypeHierarchy";
+                        noDiagnostics: "noDiagnostics";
+                    }>;
+                    reason: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"typeHierarchy">;
+                direction: z.ZodEnum<{
+                    supertypes: "supertypes";
+                    subtypes: "subtypes";
+                }>;
+                root: z.ZodOptional<z.ZodUnknown>;
+                items: z.ZodArray<z.ZodUnknown>;
+                totalItems: z.ZodNumber;
+                empty: z.ZodOptional<z.ZodObject<{
+                    category: z.ZodEnum<{
+                        serverUnavailable: "serverUnavailable";
+                        unsupportedOperation: "unsupportedOperation";
+                        symbolNotFound: "symbolNotFound";
+                        anchorFailed: "anchorFailed";
+                        noLocations: "noLocations";
+                        noReferences: "noReferences";
+                        noHover: "noHover";
+                        noCalls: "noCalls";
+                        noWorkspaceSymbols: "noWorkspaceSymbols";
+                        noTypeHierarchy: "noTypeHierarchy";
+                        noDiagnostics: "noDiagnostics";
+                    }>;
+                    reason: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"diagnostic">;
+                diagnostics: z.ZodArray<z.ZodUnknown>;
+                totalDiagnostics: z.ZodNumber;
+                errorCount: z.ZodNumber;
+                warningCount: z.ZodNumber;
+                empty: z.ZodOptional<z.ZodObject<{
+                    category: z.ZodEnum<{
+                        serverUnavailable: "serverUnavailable";
+                        unsupportedOperation: "unsupportedOperation";
+                        symbolNotFound: "symbolNotFound";
+                        anchorFailed: "anchorFailed";
+                        noLocations: "noLocations";
+                        noReferences: "noReferences";
+                        noHover: "noHover";
+                        noCalls: "noCalls";
+                        noWorkspaceSymbols: "noWorkspaceSymbols";
+                        noTypeHierarchy: "noTypeHierarchy";
+                        noDiagnostics: "noDiagnostics";
                     }>;
                     reason: z.ZodString;
                 }, z.core.$strip>>;
@@ -490,6 +652,9 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
                     noReferences: "noReferences";
                     noHover: "noHover";
                     noCalls: "noCalls";
+                    noWorkspaceSymbols: "noWorkspaceSymbols";
+                    noTypeHierarchy: "noTypeHierarchy";
+                    noDiagnostics: "noDiagnostics";
                 }>;
                 reason: z.ZodString;
             }, z.core.$strip>], "kind">;
@@ -503,7 +668,6 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
             }, z.core.$strip>>;
             summary: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            hints: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>;
     }, z.core.$strip>]>>;
 }, z.core.$strip>;

package/dist/tools/lsp/shared/callHierarchyTraversal.d.ts

@@ -1,5 +1,5 @@
-import type { LSPClient } from 'octocode-lsp/client';
-import type { CallHierarchyItem, IncomingCall, OutgoingCall } from 'octocode-lsp/types';
+import type { LSPClient } from '@octocodeai/octocode-engine/lsp/client';
+import type { CallHierarchyItem, IncomingCall, OutgoingCall } from '@octocodeai/octocode-engine/lsp/types';
 export type TraversalResult<T> = {
     calls: T[];
     truncatedByDepth: boolean;

package/dist/tools/lsp/shared/resolveSymbolAnchor.d.ts

@@ -1,4 +1,4 @@
-import type { LspGetSemanticsQuery, ResolvedSymbol } from './semanticTypes.js';
+import type { DocumentSymbolsSemanticQuery, SymbolAnchoredSemanticQuery, ResolvedSymbol } from './semanticTypes.js';
 export type FileAnchor = {
     uri: string;
     absolutePath: string;
@@ -17,4 +17,4 @@ export type AnchorResolutionResult<T> = {
 export declare function resolveFileAnchor(query: {
     uri?: string;
 }, toolName: string): Promise<AnchorResolutionResult<FileAnchor>>;
-export declare function resolveSymbolAnchor(query: LspGetSemanticsQuery, toolName: string): Promise<AnchorResolutionResult<SymbolAnchor>>;
+export declare function resolveSymbolAnchor(query: SymbolAnchoredSemanticQuery | DocumentSymbolsSemanticQuery, toolName: string): Promise<AnchorResolutionResult<SymbolAnchor>>;

package/dist/tools/lsp/shared/semanticTypes.d.ts

@@ -1,6 +1,6 @@
-import type { ExactPosition, LSPRange } from 'octocode-lsp/types';
-export declare const LSP_GET_SEMANTIC_CONTENT_TOOL_NAME = "lspGetSemantics";
-export declare const SEMANTIC_CONTENT_TYPES: readonly ["definition", "references", "callers", "callees", "callHierarchy", "hover", "documentSymbols", "typeDefinition", "implementation"];
+import type { ExactPosition, LSPRange } from '@octocodeai/octocode-engine/lsp/types';
+export { LSP_GET_SEMANTIC_CONTENT_TOOL_NAME } from '../../toolNames.js';
+export declare const SEMANTIC_CONTENT_TYPES: readonly ["definition", "references", "callers", "callees", "callHierarchy", "hover", "documentSymbols", "typeDefinition", "implementation", "workspaceSymbol", "supertypes", "subtypes", "diagnostic"];
 export type SemanticContentType = (typeof SEMANTIC_CONTENT_TYPES)[number];
 export type SemanticOutputFormat = 'structured' | 'compact';
 export type SemanticQueryBase = {
@@ -17,7 +17,7 @@ export type SemanticQueryBase = {
     reasoning?: string;
 };
 export type SymbolAnchoredSemanticQuery = SemanticQueryBase & {
-    type: Exclude<SemanticContentType, 'documentSymbols'>;
+    type: Exclude<SemanticContentType, 'documentSymbols' | 'workspaceSymbol' | 'diagnostic'>;
     symbolName: string;
     lineHint: number;
     orderHint?: number;
@@ -28,7 +28,16 @@ export type SymbolAnchoredSemanticQuery = SemanticQueryBase & {
 export type DocumentSymbolsSemanticQuery = SemanticQueryBase & {
     type: 'documentSymbols';
 };
-export type LspGetSemanticsQuery = SymbolAnchoredSemanticQuery | DocumentSymbolsSemanticQuery;
+/** `workspace/symbol`: project-wide fuzzy symbol search. `symbolName` is the query string. */
+export type WorkspaceSymbolSemanticQuery = SemanticQueryBase & {
+    type: 'workspaceSymbol';
+    symbolName: string;
+};
+/** `textDocument/diagnostic` (pull): errors/warnings for a file without a position anchor. */
+export type DiagnosticSemanticQuery = SemanticQueryBase & {
+    type: 'diagnostic';
+};
+export type LspGetSemanticsQuery = SymbolAnchoredSemanticQuery | DocumentSymbolsSemanticQuery | WorkspaceSymbolSemanticQuery | DiagnosticSemanticQuery;
 export type ResolvedSymbol = {
     name: string;
     uri: string;
@@ -58,13 +67,14 @@ export type CompactLocation = {
 export declare function compactLocation(snippet: {
     uri: string;
     content?: string;
+    range?: LSPRange;
     displayRange?: {
         startLine: number;
         endLine: number;
     };
     isDefinition?: boolean;
 }): CompactLocation;
-export type SemanticEmptyCategory = 'serverUnavailable' | 'unsupportedOperation' | 'symbolNotFound' | 'anchorFailed' | 'noLocations' | 'noReferences' | 'noHover' | 'noCalls';
+export type SemanticEmptyCategory = 'serverUnavailable' | 'unsupportedOperation' | 'symbolNotFound' | 'anchorFailed' | 'noLocations' | 'noReferences' | 'noHover' | 'noCalls' | 'noWorkspaceSymbols' | 'noTypeHierarchy' | 'noDiagnostics';
 export type SemanticEmptyState = {
     category: SemanticEmptyCategory;
     reason: string;
@@ -123,6 +133,26 @@ export type LspSemanticEnvelope = {
         totalSymbols?: number;
         topLevelSymbols?: number;
         empty?: SemanticEmptyState;
+    } | {
+        kind: 'workspaceSymbol';
+        query: string;
+        symbols: unknown[];
+        totalSymbols: number;
+        empty?: SemanticEmptyState;
+    } | {
+        kind: 'typeHierarchy';
+        direction: 'supertypes' | 'subtypes';
+        root?: unknown;
+        items: unknown[];
+        totalItems: number;
+        empty?: SemanticEmptyState;
+    } | {
+        kind: 'diagnostic';
+        diagnostics: unknown[];
+        totalDiagnostics: number;
+        errorCount: number;
+        warningCount: number;
+        empty?: SemanticEmptyState;
     } | {
         kind: 'empty';
         category: SemanticEmptyCategory;

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

@@ -0,0 +1,7 @@
+import { type CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+type OqlSearchToolInput = Record<string, unknown> & {
+    authInfo?: AuthInfo;
+};
+export declare function executeOqlSearchTool(input: OqlSearchToolInput): Promise<CallToolResult>;
+export {};

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

@@ -3,5 +3,15 @@ import type { z } from 'zod';
 import type { NpmPackageQuerySchema } from '@octocodeai/octocode-core/schemas';
 type NpmSearchQuery = z.input<typeof NpmPackageQuerySchema>;
 import type { ToolExecutionArgs } from '../../types/execution.js';
+type PackagePagination = {
+    currentPage: number;
+    totalPages: number;
+    perPage: number;
+    totalFound: number;
+    returned: number;
+    hasMore: boolean;
+    nextPage?: number;
+};
+export declare function buildPackagePagination(query: NpmSearchQuery, totalFound: number, returned: number, isKeyword: boolean): PackagePagination;
 export declare function searchPackages(args: ToolExecutionArgs<NpmSearchQuery>): Promise<CallToolResult>;
 export {};

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

@@ -8,8 +8,8 @@ export declare const NpmSearchQueryLocalSchema: z.ZodObject<{
     reasoning: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const NpmSearchBulkQueryLocalSchema: z.ZodObject<{
-    responseCharOffset: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
-    responseCharLength: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    responseCharOffset: z.ZodOptional<z.ZodPreprocess<z.ZodNumber>>;
+    responseCharLength: z.ZodOptional<z.ZodPreprocess<z.ZodNumber>>;
     queries: z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
 }, z.core.$strip>;
 export declare const NpmSearchOutputLocalSchema: z.ZodObject<{
@@ -21,9 +21,10 @@ export declare const NpmSearchOutputLocalSchema: z.ZodObject<{
                 version: z.ZodOptional<z.ZodString>;
                 description: z.ZodOptional<z.ZodString>;
                 license: z.ZodOptional<z.ZodString>;
-                weeklyDownloads: z.ZodOptional<z.ZodNumber>;
+                downloads: z.ZodOptional<z.ZodNumber>;
                 repository: z.ZodOptional<z.ZodString>;
                 repositoryDirectory: z.ZodOptional<z.ZodString>;
+                next: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             }, z.core.$loose>>>;
             pagination: z.ZodOptional<z.ZodObject<{
                 currentPage: z.ZodNumber;
@@ -32,14 +33,15 @@ export declare const NpmSearchOutputLocalSchema: z.ZodObject<{
                 totalFound: z.ZodNumber;
                 returned: z.ZodNumber;
                 hasMore: z.ZodBoolean;
+                nextPage: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
         }, z.core.$loose>>;
         status: z.ZodOptional<z.ZodString>;
     }, 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<{
+    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;

package/dist/tools/providerMappers.d.ts

@@ -9,6 +9,13 @@ type GitHubCodeSearchQuery = z.infer<typeof GitHubCodeSearchQuerySchema>;
 type LocalFileContentQuery = z.infer<typeof FileContentQueryLocalSchema> & {
     minify: import('../scheme/fields.js').MinifyMode;
 };
+/**
+ * Char-boundary truncation mirroring the Rust engine's `truncate_unicode`:
+ * keeps at most `maxChars` Unicode scalars and appends `...` when it cuts.
+ * Never slices UTF-8 mid-codepoint or mid-token — the single data-layer bound
+ * for GitHub code-search match fragments (the render layer must not re-trim).
+ */
+export declare function truncateSnippetChars(value: string, maxChars?: number): string;
 type GitHubPullRequestSearchQuery = z.infer<typeof GitHubPullRequestSearchQueryLocalSchema>;
 type GitHubReposSearchSingleQuery = z.infer<typeof GitHubReposSearchSingleQuerySchema>;
 type GitHubViewRepoStructureQuery = z.infer<typeof GitHubViewRepoStructureQuerySchema>;
@@ -35,7 +42,7 @@ export declare function mapCodeSearchToolQuery(query: WithOptionalMeta<GitHubCod
     filename: string;
     extension: string;
     language: string | undefined;
-    match: "path" | "file";
+    match: "file" | "path";
     limit: number | undefined;
     page: number;
     mainResearchGoal: string;
@@ -70,12 +77,14 @@ export interface CodeSearchPagination {
     totalMatchesKind?: 'exact' | 'reported' | 'lowerBound';
     totalMatchesCapped?: boolean;
     hasMore: boolean;
+    nextPage?: number;
     uniqueFileCount?: number;
 }
 export interface CodeSearchFlatResult {
     results: CodeSearchGroupedResult[];
     pagination?: CodeSearchPagination;
     nonExistentScope?: boolean;
+    incompleteResults?: boolean;
 }
 export declare function mapCodeSearchProviderResult(data: CodeSearchResult, query: WithOptionalMeta<GitHubCodeSearchQuery>): CodeSearchFlatResult;
 export declare function mapRepoSearchToolQuery(query: WithOptionalMeta<GitHubReposSearchSingleQuery>): {
@@ -92,7 +101,7 @@ export declare function mapRepoSearchToolQuery(query: WithOptionalMeta<GitHubRep
     forks: string | undefined;
     license: string | undefined;
     goodFirstIssues: string | undefined;
-    match: ("name" | "description" | "readme")[];
+    match: ("description" | "name" | "readme")[];
     sort: "stars" | "forks" | "updated" | "created" | "best-match" | undefined;
     limit: number | undefined;
     page: number;
@@ -129,10 +138,18 @@ export declare function mapPullRequestToolQuery(query: PartialPRQuery): {
     reactions: string;
     interactions: string;
     draft: boolean;
-    match: ("comments" | "title" | "body")[];
+    match: ("title" | "comments" | "body")[];
+    milestone: string;
+    language: string;
+    checks: "success" | "failure" | "pending";
+    review: "none" | "approved" | "changes_requested" | "required";
+    locked: boolean;
+    visibility: "public" | "private";
+    teamMentions: string;
+    project: string;
     archived: boolean | undefined;
     content: unknown;
-    reviewMode: "summary" | "full";
+    reviewMode: "full" | "summary";
     filePage: number;
     commentPage: number;
     commitPage: number;
@@ -200,7 +217,7 @@ export declare function mapPullRequestProviderResultData(data: ProviderPullReque
             in_reply_to_id?: number;
         }[];
         url: string;
-        state: "closed" | "open" | "merged";
+        state: "open" | "closed" | "merged";
         draft: boolean;
         author: string;
         assignees: string[];
@@ -230,6 +247,7 @@ export declare function mapPullRequestProviderResultData(data: ProviderPullReque
     }[];
     resultData: Record<string, unknown>;
     pagination: {
+        nextPage?: number;
         hasMore: boolean;
         uniqueFileCount?: number;
         totalMatchesCapped?: boolean;
@@ -251,6 +269,7 @@ export declare function mapFileContentToolQuery(query: LocalFileContentQuery): {
     matchString: string;
     contextLines: number;
     fullContent: boolean;
+    forceRefresh: boolean;
     charOffset: number;
     charLength: number;
     minify: "none" | "standard" | "symbols";

package/dist/tools/toolConfig.d.ts

@@ -38,4 +38,5 @@ export declare const LOCAL_FIND_FILES: ToolConfig;
 export declare const LOCAL_FETCH_CONTENT: ToolConfig;
 export declare const LSP_GET_SEMANTIC_CONTENT: ToolConfig;
 export declare const LOCAL_BINARY_INSPECT: ToolConfig;
+export declare const OQL_SEARCH: ToolConfig;
 export declare const ALL_TOOLS: ToolConfig[];

package/dist/tools/toolMetadata/proxies.d.ts

@@ -2,9 +2,3 @@ export { TOOL_NAMES } from './names.js';
 export { DESCRIPTIONS } from './descriptions.js';
 export { isToolInMetadata } from './metadataPresence.js';
 export { BASE_SCHEMA } from './baseSchema.js';
-type HintsMap = Record<string, readonly string[]>;
-export declare const TOOL_HINTS: Record<string, HintsMap>;
-export declare const GENERIC_ERROR_HINTS: readonly string[];
-export declare function getToolHintsSync(toolName: string, status: string): readonly string[];
-export declare function getDynamicHints(toolName: string, key: string): readonly string[];
-export declare function getGenericErrorHintsSync(): readonly string[];

package/dist/tools/toolNames.d.ts

@@ -1,2 +1,4 @@
 export declare const STATIC_TOOL_NAMES: import("@octocodeai/octocode-core/types").ToolNames;
+export declare const LSP_GET_SEMANTIC_CONTENT_TOOL_NAME: "lspGetSemantics";
+export declare const OQL_SEARCH_TOOL_NAME = "oqlSearch";
 export declare function isLocalTool(toolName: string): boolean;

package/dist/tools/utils.d.ts

@@ -1,20 +1,16 @@
 import type { ToolErrorResult, ToolSuccessResult, ToolInvocationCallback } from '../types/toolResults.js';
-import type { HintContext } from '../types/metadata.js';
 import type { ProviderResponse } from '../providers/types.js';
-import { createErrorResult } from '../utils/response/error.js';
-export { createErrorResult };
+import { createErrorResult, safeParseOrError } from '../utils/response/error.js';
+export { createErrorResult, safeParseOrError };
 export declare function invokeCallbackSafely(callback: ToolInvocationCallback | undefined, toolName: string, queries: unknown[]): Promise<void>;
 interface SuccessResultOptions {
-    hintContext?: HintContext;
-    prefixHints?: string[];
-    extraHints?: string[];
     rawResponse?: unknown;
 }
 export declare function createSuccessResult<T extends object>(_query: {
     mainResearchGoal?: string;
     researchGoal?: string;
     reasoning?: string;
-}, data: T, hasContent: boolean, toolName: string, options?: SuccessResultOptions): ToolSuccessResult & T;
+}, data: T, hasContent: boolean, _toolName: string, options?: SuccessResultOptions): ToolSuccessResult & T;
 export declare function handleProviderError(apiResult: ProviderResponse<unknown>, query: {
     mainResearchGoal?: string;
     researchGoal?: string;

package/dist/types/bulk.d.ts

@@ -26,7 +26,6 @@ export interface ResponsePaginationInfo {
 export interface BulkResponseConfig<TQuery = object, TOutput extends Record<string, unknown> = Record<string, unknown>> {
     toolName: string;
     keysPriority?: string[];
-    peerHints?: boolean;
     concurrency?: number;
     minQueryTimeoutMs?: number;
     responsePagination?: BulkResponsePagination;
@@ -34,7 +33,6 @@ export interface BulkResponseConfig<TQuery = object, TOutput extends Record<stri
 }
 export interface BulkToolResponse {
     results: FlatQueryResult[];
-    hints?: string[];
     base?: string;
     shared?: Record<string, string | number | boolean>;
     responsePagination?: ResponsePaginationInfo;

package/dist/types/execution.d.ts

@@ -1,5 +1,4 @@
 import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
-import type { HintContext } from './metadata.js';
 export type WithOptionalMeta<T> = Partial<T>;
 export interface ToolExecutionArgs<TQuery> {
     queries: TQuery[];
@@ -7,5 +6,5 @@ export interface ToolExecutionArgs<TQuery> {
     responseCharLength?: number;
     authInfo?: AuthInfo;
     sessionId?: string;
-    hintContext?: HintContext;
+    hintContext?: Record<string, unknown>;
 }

package/dist/types/server.d.ts

@@ -7,7 +7,6 @@ export interface ServerConfig {
     disableTools?: string[];
     timeout: number;
     maxRetries: number;
-    loggingEnabled: boolean;
     enableLocal: boolean;
     enableClone: boolean;
     outputFormat: 'yaml' | 'json';