@octocodeai/octocode-tools-core 16.6.0 → 16.6.3

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

@@ -7,3 +7,52 @@ export declare const LocalFindFilesBulkQuerySchema: z.ZodObject<{
     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 LocalFindFilesOutputSchema: z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodOptional<z.ZodEnum<{
+            empty: "empty";
+            error: "error";
+        }>>;
+        data: z.ZodObject<{
+            files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                path: z.ZodOptional<z.ZodString>;
+                type: z.ZodOptional<z.ZodEnum<{
+                    file: "file";
+                    link: "link";
+                    directory: "directory";
+                    dir: "dir";
+                    symlink: "symlink";
+                }>>;
+                size: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+                modified: z.ZodOptional<z.ZodString>;
+                accessed: z.ZodOptional<z.ZodString>;
+                created: z.ZodOptional<z.ZodString>;
+                permissions: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+            summary: z.ZodOptional<z.ZodString>;
+            pagination: z.ZodOptional<z.ZodObject<{
+                currentPage: z.ZodNumber;
+                totalPages: z.ZodNumber;
+                hasMore: z.ZodBoolean;
+                nextPage: z.ZodOptional<z.ZodNumber>;
+                pageSize: z.ZodOptional<z.ZodNumber>;
+                totalItems: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    base: z.ZodOptional<z.ZodString>;
+    shared: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    responsePagination: z.ZodOptional<z.ZodObject<{
+        currentPage: z.ZodNumber;
+        totalPages: z.ZodNumber;
+        hasMore: z.ZodBoolean;
+        charOffset: z.ZodNumber;
+        charLength: z.ZodNumber;
+        totalChars: z.ZodNumber;
+        nextCharOffset: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type LocalFindFilesOutput = z.infer<typeof LocalFindFilesOutputSchema>;

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

@@ -78,3 +78,78 @@ export declare const LocalRipgrepBulkQuerySchema: z.ZodObject<{
     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 LocalSearchCodeOutputSchema: z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodOptional<z.ZodEnum<{
+            empty: "empty";
+            error: "error";
+        }>>;
+        data: z.ZodObject<{
+            files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                matches: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    line: z.ZodNumber;
+                    endLine: z.ZodOptional<z.ZodNumber>;
+                    value: z.ZodOptional<z.ZodString>;
+                    column: z.ZodOptional<z.ZodNumber>;
+                    count: z.ZodOptional<z.ZodNumber>;
+                    metavars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+                }, z.core.$strip>>>;
+                totalOccurrences: z.ZodOptional<z.ZodNumber>;
+                totalMatchedLines: z.ZodOptional<z.ZodNumber>;
+                totalMatchRows: z.ZodOptional<z.ZodNumber>;
+                returnedMatchRows: z.ZodOptional<z.ZodNumber>;
+                matchPagination: z.ZodOptional<z.ZodObject<{
+                    currentPage: z.ZodNumber;
+                    totalPages: z.ZodNumber;
+                    hasMore: z.ZodBoolean;
+                    nextPage: z.ZodOptional<z.ZodNumber>;
+                    pageSize: z.ZodOptional<z.ZodNumber>;
+                    totalItems: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+                next: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    tool: z.ZodString;
+                    query: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                    why: z.ZodOptional<z.ZodString>;
+                    confidence: z.ZodOptional<z.ZodEnum<{
+                        exact: "exact";
+                        heuristic: "heuristic";
+                    }>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>>;
+            summary: z.ZodOptional<z.ZodString>;
+            searchEngine: z.ZodOptional<z.ZodString>;
+            pagination: z.ZodOptional<z.ZodObject<{
+                currentPage: z.ZodNumber;
+                totalPages: z.ZodNumber;
+                hasMore: z.ZodBoolean;
+                nextPage: z.ZodOptional<z.ZodNumber>;
+                pageSize: z.ZodOptional<z.ZodNumber>;
+                totalItems: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            next: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                tool: z.ZodString;
+                query: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                why: z.ZodOptional<z.ZodString>;
+                confidence: z.ZodOptional<z.ZodEnum<{
+                    exact: "exact";
+                    heuristic: "heuristic";
+                }>>;
+            }, z.core.$strip>>>;
+            warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    base: z.ZodOptional<z.ZodString>;
+    shared: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    responsePagination: z.ZodOptional<z.ZodObject<{
+        currentPage: z.ZodNumber;
+        totalPages: z.ZodNumber;
+        hasMore: z.ZodBoolean;
+        charOffset: z.ZodNumber;
+        charLength: z.ZodNumber;
+        totalChars: z.ZodNumber;
+        nextCharOffset: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type LocalSearchCodeOutput = z.infer<typeof LocalSearchCodeOutputSchema>;

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

@@ -31,3 +31,55 @@ export declare const LocalViewStructureBulkQuerySchema: z.ZodObject<{
     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 LocalViewStructureOutputSchema: z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodOptional<z.ZodEnum<{
+            empty: "empty";
+            error: "error";
+        }>>;
+        data: z.ZodObject<{
+            path: z.ZodOptional<z.ZodString>;
+            entries: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                type: z.ZodEnum<{
+                    file: "file";
+                    link: "link";
+                    directory: "directory";
+                    dir: "dir";
+                    symlink: "symlink";
+                }>;
+                path: z.ZodOptional<z.ZodString>;
+                depth: z.ZodOptional<z.ZodNumber>;
+                size: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+                modified: z.ZodOptional<z.ZodString>;
+                permissions: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+            files: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            folders: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            links: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            summary: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+            pagination: z.ZodOptional<z.ZodObject<{
+                currentPage: z.ZodNumber;
+                totalPages: z.ZodNumber;
+                hasMore: z.ZodBoolean;
+                nextPage: z.ZodOptional<z.ZodNumber>;
+                pageSize: z.ZodOptional<z.ZodNumber>;
+                totalItems: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    base: z.ZodOptional<z.ZodString>;
+    shared: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    responsePagination: z.ZodOptional<z.ZodObject<{
+        currentPage: z.ZodNumber;
+        totalPages: z.ZodNumber;
+        hasMore: z.ZodBoolean;
+        charOffset: z.ZodNumber;
+        charLength: z.ZodNumber;
+        totalChars: z.ZodNumber;
+        nextCharOffset: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type LocalViewStructureOutput = z.infer<typeof LocalViewStructureOutputSchema>;

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

@@ -95,11 +95,11 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
                 foundAtLine: z.ZodNumber;
                 orderHint: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
-            lsp: z.ZodObject<{
+            lsp: z.ZodOptional<z.ZodObject<{
                 serverAvailable: z.ZodOptional<z.ZodBoolean>;
                 provider: z.ZodOptional<z.ZodString>;
                 source: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>;
+            }, z.core.$strip>>;
             payload: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"definition">;
                 locations: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
@@ -156,7 +156,6 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
                 totalFiles: z.ZodNumber;
                 empty: z.ZodOptional<z.ZodObject<{
                     category: z.ZodEnum<{
-                        serverUnavailable: "serverUnavailable";
                         unsupportedOperation: "unsupportedOperation";
                         symbolNotFound: "symbolNotFound";
                         anchorFailed: "anchorFailed";
@@ -218,7 +217,6 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
                 }, z.core.$strip>;
                 empty: z.ZodOptional<z.ZodObject<{
                     category: z.ZodEnum<{
-                        serverUnavailable: "serverUnavailable";
                         unsupportedOperation: "unsupportedOperation";
                         symbolNotFound: "symbolNotFound";
                         anchorFailed: "anchorFailed";
@@ -261,7 +259,6 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
                 topLevelSymbols: z.ZodOptional<z.ZodNumber>;
                 empty: z.ZodOptional<z.ZodObject<{
                     category: z.ZodEnum<{
-                        serverUnavailable: "serverUnavailable";
                         unsupportedOperation: "unsupportedOperation";
                         symbolNotFound: "symbolNotFound";
                         anchorFailed: "anchorFailed";
@@ -282,7 +279,6 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
                 totalSymbols: z.ZodNumber;
                 empty: z.ZodOptional<z.ZodObject<{
                     category: z.ZodEnum<{
-                        serverUnavailable: "serverUnavailable";
                         unsupportedOperation: "unsupportedOperation";
                         symbolNotFound: "symbolNotFound";
                         anchorFailed: "anchorFailed";
@@ -307,7 +303,6 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
                 totalItems: z.ZodNumber;
                 empty: z.ZodOptional<z.ZodObject<{
                     category: z.ZodEnum<{
-                        serverUnavailable: "serverUnavailable";
                         unsupportedOperation: "unsupportedOperation";
                         symbolNotFound: "symbolNotFound";
                         anchorFailed: "anchorFailed";
@@ -329,7 +324,6 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
                 warningCount: z.ZodNumber;
                 empty: z.ZodOptional<z.ZodObject<{
                     category: z.ZodEnum<{
-                        serverUnavailable: "serverUnavailable";
                         unsupportedOperation: "unsupportedOperation";
                         symbolNotFound: "symbolNotFound";
                         anchorFailed: "anchorFailed";
@@ -346,7 +340,6 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
             }, z.core.$strip>, z.ZodObject<{
                 kind: z.ZodLiteral<"empty">;
                 category: z.ZodEnum<{
-                    serverUnavailable: "serverUnavailable";
                     unsupportedOperation: "unsupportedOperation";
                     symbolNotFound: "symbolNotFound";
                     anchorFailed: "anchorFailed";
@@ -363,10 +356,10 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
             pagination: z.ZodOptional<z.ZodObject<{
                 currentPage: z.ZodNumber;
                 totalPages: z.ZodNumber;
-                totalResults: z.ZodNumber;
                 hasMore: z.ZodBoolean;
-                itemsPerPage: z.ZodNumber;
                 nextPage: z.ZodOptional<z.ZodNumber>;
+                pageSize: z.ZodOptional<z.ZodNumber>;
+                totalItems: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
             summary: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -393,11 +386,11 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
                 foundAtLine: z.ZodNumber;
                 orderHint: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
-            lsp: z.ZodObject<{
+            lsp: z.ZodOptional<z.ZodObject<{
                 serverAvailable: z.ZodOptional<z.ZodBoolean>;
                 provider: z.ZodOptional<z.ZodString>;
                 source: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>;
+            }, z.core.$strip>>;
             payload: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"definition">;
                 locations: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
@@ -454,7 +447,6 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
                 totalFiles: z.ZodNumber;
                 empty: z.ZodOptional<z.ZodObject<{
                     category: z.ZodEnum<{
-                        serverUnavailable: "serverUnavailable";
                         unsupportedOperation: "unsupportedOperation";
                         symbolNotFound: "symbolNotFound";
                         anchorFailed: "anchorFailed";
@@ -516,7 +508,6 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
                 }, z.core.$strip>;
                 empty: z.ZodOptional<z.ZodObject<{
                     category: z.ZodEnum<{
-                        serverUnavailable: "serverUnavailable";
                         unsupportedOperation: "unsupportedOperation";
                         symbolNotFound: "symbolNotFound";
                         anchorFailed: "anchorFailed";
@@ -559,7 +550,6 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
                 topLevelSymbols: z.ZodOptional<z.ZodNumber>;
                 empty: z.ZodOptional<z.ZodObject<{
                     category: z.ZodEnum<{
-                        serverUnavailable: "serverUnavailable";
                         unsupportedOperation: "unsupportedOperation";
                         symbolNotFound: "symbolNotFound";
                         anchorFailed: "anchorFailed";
@@ -580,7 +570,6 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
                 totalSymbols: z.ZodNumber;
                 empty: z.ZodOptional<z.ZodObject<{
                     category: z.ZodEnum<{
-                        serverUnavailable: "serverUnavailable";
                         unsupportedOperation: "unsupportedOperation";
                         symbolNotFound: "symbolNotFound";
                         anchorFailed: "anchorFailed";
@@ -605,7 +594,6 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
                 totalItems: z.ZodNumber;
                 empty: z.ZodOptional<z.ZodObject<{
                     category: z.ZodEnum<{
-                        serverUnavailable: "serverUnavailable";
                         unsupportedOperation: "unsupportedOperation";
                         symbolNotFound: "symbolNotFound";
                         anchorFailed: "anchorFailed";
@@ -627,7 +615,6 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
                 warningCount: z.ZodNumber;
                 empty: z.ZodOptional<z.ZodObject<{
                     category: z.ZodEnum<{
-                        serverUnavailable: "serverUnavailable";
                         unsupportedOperation: "unsupportedOperation";
                         symbolNotFound: "symbolNotFound";
                         anchorFailed: "anchorFailed";
@@ -644,7 +631,6 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
             }, z.core.$strip>, z.ZodObject<{
                 kind: z.ZodLiteral<"empty">;
                 category: z.ZodEnum<{
-                    serverUnavailable: "serverUnavailable";
                     unsupportedOperation: "unsupportedOperation";
                     symbolNotFound: "symbolNotFound";
                     anchorFailed: "anchorFailed";
@@ -661,10 +647,10 @@ export declare const LspGetSemanticsOutputSchema: z.ZodObject<{
             pagination: z.ZodOptional<z.ZodObject<{
                 currentPage: z.ZodNumber;
                 totalPages: z.ZodNumber;
-                totalResults: z.ZodNumber;
                 hasMore: z.ZodBoolean;
-                itemsPerPage: z.ZodNumber;
                 nextPage: z.ZodOptional<z.ZodNumber>;
+                pageSize: z.ZodOptional<z.ZodNumber>;
+                totalItems: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
             summary: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;

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

@@ -0,0 +1,17 @@
+import type { LspReadiness } from '@octocodeai/octocode-engine/lsp/types';
+import type { LspSemanticEnvelope, SemanticEmptyCategory } from './semanticTypes.js';
+/**
+ * The "server returned nothing" category of an envelope, whether the emptiness
+ * is expressed as an `empty`-kind payload (definition/hover) or a nested
+ * `empty` on an otherwise-shaped payload (references/callers). Returns
+ * `undefined` when the envelope carries real results.
+ */
+export declare function zeroResultEmptyCategory(envelope: LspSemanticEnvelope): SemanticEmptyCategory | undefined;
+/**
+ * Attach a caveat when a semantic query came back empty AND the language server
+ * never confirmed it finished indexing (readiness other than `progressIdle`).
+ * Without this, an agent reads a zero as "symbol is unused" when it may just be
+ * "server not indexed yet". `readiness === undefined` means the wait was
+ * skipped (servers that answer immediately) — those are trusted, no caveat.
+ */
+export declare function attachReadinessWarning(envelope: LspSemanticEnvelope, readiness: LspReadiness | undefined): LspSemanticEnvelope;

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

@@ -1,5 +1,5 @@
 import type { ExactPosition, LSPRange } from '@octocodeai/octocode-engine/lsp/types';
-export { LSP_GET_SEMANTIC_CONTENT_TOOL_NAME } from '../../toolNames.js';
+export { LSP_GET_SEMANTICS_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';
@@ -74,7 +74,7 @@ export declare function compactLocation(snippet: {
     };
     isDefinition?: boolean;
 }): CompactLocation;
-export type SemanticEmptyCategory = 'serverUnavailable' | 'unsupportedOperation' | 'symbolNotFound' | 'anchorFailed' | 'noLocations' | 'noReferences' | 'noHover' | 'noCalls' | 'noWorkspaceSymbols' | 'noTypeHierarchy' | 'noDiagnostics';
+export type SemanticEmptyCategory = 'unsupportedOperation' | 'symbolNotFound' | 'anchorFailed' | 'noLocations' | 'noReferences' | 'noHover' | 'noCalls' | 'noWorkspaceSymbols' | 'noTypeHierarchy' | 'noDiagnostics';
 export type SemanticEmptyState = {
     category: SemanticEmptyCategory;
     reason: string;

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

@@ -3,6 +3,29 @@ 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 PackageData = {
+    name: string;
+    version?: string;
+    description?: string;
+    license?: string;
+    downloads?: number;
+    repository?: string;
+    repositoryDirectory?: string;
+    repositoryId?: string;
+    next?: Record<string, unknown>;
+};
+type PackageRepositoryData = {
+    repository: string;
+    owner: string;
+    repo: string;
+    repositoryDirectory?: string;
+    next: Record<string, unknown>;
+};
+type CompactPackageData = {
+    packages: PackageData[];
+    repositories?: Record<string, PackageRepositoryData>;
+};
+export declare function compactPackageRepositories(packages: PackageData[]): CompactPackageData;
 type PackagePagination = {
     currentPage: number;
     totalPages: number;

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

@@ -24,21 +24,27 @@ export declare const NpmSearchOutputLocalSchema: z.ZodObject<{
                 downloads: z.ZodOptional<z.ZodNumber>;
                 repository: z.ZodOptional<z.ZodString>;
                 repositoryDirectory: z.ZodOptional<z.ZodString>;
+                repositoryId: z.ZodOptional<z.ZodString>;
                 next: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             }, z.core.$loose>>>;
+            repositories: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                repository: z.ZodString;
+                owner: z.ZodString;
+                repo: z.ZodString;
+                repositoryDirectory: z.ZodOptional<z.ZodString>;
+                next: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$loose>>>;
             pagination: z.ZodOptional<z.ZodObject<{
                 currentPage: z.ZodNumber;
                 totalPages: z.ZodNumber;
-                perPage: z.ZodNumber;
-                totalFound: z.ZodNumber;
-                returned: z.ZodNumber;
                 hasMore: z.ZodBoolean;
                 nextPage: z.ZodOptional<z.ZodNumber>;
+                pageSize: z.ZodOptional<z.ZodNumber>;
+                totalItems: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
         }, z.core.$loose>>;
         status: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>>>;
-    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<{

package/dist/tools/toolNames.d.ts

@@ -1,4 +1,5 @@
 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 LSP_GET_SEMANTICS_TOOL_NAME: "lspGetSemantics";
 export declare const OQL_SEARCH_TOOL_NAME = "oqlSearch";
+export declare function isOqlEnabled(env?: NodeJS.ProcessEnv): boolean;
 export declare function isLocalTool(toolName: string): boolean;

package/dist/types/server.d.ts

@@ -1,4 +1,4 @@
-export type TokenSourceType = 'env:OCTOCODE_TOKEN' | 'env:GH_TOKEN' | 'env:GITHUB_TOKEN' | 'gh-cli' | 'octocode-storage' | 'none';
+export type TokenSourceType = 'env:OCTOCODE_TOKEN' | 'env:GH_TOKEN' | 'env:GITHUB_TOKEN' | 'env:GITHUB_PERSONAL_ACCESS_TOKEN' | 'gh-cli' | 'octocode-storage' | 'none';
 export interface ServerConfig {
     version: string;
     githubApiUrl: string;

package/dist/utils/response/bulk.d.ts

@@ -3,3 +3,4 @@ import type { ProcessedBulkResult } from '../../types/toolResults.js';
 import type { BulkResponseConfig, BulkResponsePagination } from '../../types/bulk.js';
 export declare function computeQueryTimeout(queryCount: number, concurrency: number, minTimeoutMs?: number): number;
 export declare function executeBulkOperation<TQuery extends object, TOutput extends Record<string, unknown> = Record<string, unknown>>(queries: Array<TQuery>, processor: (query: TQuery, index: number) => Promise<ProcessedBulkResult>, config: BulkResponseConfig<TQuery, TOutput>, pagination?: BulkResponsePagination): Promise<CallToolResult>;
+export declare function resolveQueryId<TQuery extends object>(originalQuery: TQuery, queryIndex: number): string;

package/dist/utils/response/groupedFinalizer.d.ts

@@ -5,8 +5,13 @@ export type QueryWithPagination = {
     charLength?: unknown;
     charOffset?: unknown;
 };
-export declare function collectFlatErrors(results: readonly FlatQueryResult[]): Array<{
+export type FlatErrorEntry = {
     id: string;
     error: string;
-}>;
+    status?: number;
+    retryAfterSeconds?: number;
+    rateLimitRemaining?: number;
+    rateLimitReset?: number;
+};
+export declare function collectFlatErrors(results: readonly FlatQueryResult[]): FlatErrorEntry[];
 export declare function formatFinalizedResponse<T extends Record<string, unknown>>(responseData: T, keysPriority: readonly string[], isError?: boolean): BulkFinalizerOutput<T>;

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "@octocodeai/octocode-tools-core",
-  "version": "16.6.0",
+  "version": "16.6.3",
   "description": "Core tool implementations for Octocode: GitHub, local filesystem, LSP, and package search tools.",
   "author": "Guy Bary <bgauryy@octocodeai.com>",
   "license": "MIT",
   "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -80,8 +83,8 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@octocodeai/octocode-core": "^16.5.3",
-    "@octocodeai/octocode-engine": "^16.6.0",
+    "@octocodeai/octocode-core": "^16.6.3",
+    "@octocodeai/octocode-engine": "^16.7.0",
     "@octokit/oauth-methods": "^6.0.2",
     "@octokit/plugin-throttling": "^11.0.3",
     "@octokit/request": "^10.0.10",
@@ -90,6 +93,7 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
+    "@octocodeai/config": "workspace:*",
     "@octokit/core": "^7.0.6",
     "@octokit/openapi-types": "^27.0.0",
     "@octokit/plugin-rest-endpoint-methods": "^17.0.0",

package/dist/oql/adapters/v2.d.ts

@@ -1,32 +0,0 @@
-import type { AdapterResult } from './local.js';
-import type { OqlQuery } from '../types.js';
-export declare function executeRepositories(query: OqlQuery): Promise<AdapterResult>;
-export declare function executePackages(query: OqlQuery): Promise<AdapterResult>;
-export declare function executeHistory(query: OqlQuery): Promise<AdapterResult>;
-/**
- * `target:"diff"` has two typed lanes, discriminated by params shape:
- *   - PR patch:    { prNumber, files? }            -> ghHistoryResearch patches
- *   - direct file: { baseRef, headRef, path }      -> two ghGetFileContent reads
- *                                                     + a pure local line diff
- * A request that fits neither returns a repair diagnostic rather than silently
- * falling through to a PR-patch call (see OCTOCODE_SEARCH_PARITY_CHECKLIST.md gap log #8).
- */
-export declare function executeDiff(query: OqlQuery): Promise<AdapterResult>;
-export interface LineDiff {
-    additions: number;
-    deletions: number;
-    unchanged: number;
-    /** Unified-style patch text (`+`/`-`/` ` line prefixes). */
-    patch: string;
-}
-/**
- * Minimal LCS-based line diff between two file bodies. Pure and dependency-free
- * so it is unit-testable without any backend. Not a byte-perfect git patch —
- * a line-granular additions/deletions view for direct two-ref comparison.
- */
-export declare function computeLineDiff(baseText: string, headText: string): LineDiff;
-export declare function executeArtifacts(query: OqlQuery): Promise<AdapterResult>;
-export declare function executeSemantics(query: OqlQuery): Promise<AdapterResult>;
-export declare function executeResearch(query: OqlQuery): Promise<AdapterResult>;
-/** Dispatch map: V2 target -> adapter. */
-export declare const V2_ADAPTERS: Record<string, (q: OqlQuery) => Promise<AdapterResult>>;

package/dist/oql/v2params.d.ts

@@ -1,22 +0,0 @@
-/**
- * Typed V2-target `params` schemas.
- *
- * V2 research targets (semantics/repositories/packages/pullRequests/commits/
- * artifacts/diff/research) carry a `params` bag that the backing tool validates
- * exhaustively. These schemas type the *documented, commonly-used* fields so a
- * type mistake (e.g. `prNumber:"abc"`) is caught at the OQL layer with a clear
- * `invalidQuery` instead of failing opaquely at the tool — while `.passthrough()`
- * keeps the backing tool the exhaustive source of truth for the rest.
- *
- * This is the typed-contract layer for OCTOCODE_SEARCH_PARITY_CHECKLIST gap #3.
- */
-import { z } from 'zod';
-import type { OqlActiveTarget } from './types.js';
-/** Per-target params schema; targets without a `params` bag are absent. */
-export declare const V2_PARAM_SCHEMAS: Partial<Record<OqlActiveTarget, z.ZodTypeAny>>;
-/**
- * Validate a target's `params` bag against its typed schema. Returns `null` when
- * valid (or no schema applies), or a Zod-style error message string the caller
- * raises as `invalidQuery`.
- */
-export declare function validateV2Params(target: OqlActiveTarget, params: unknown): string | null;

package/dist/shared/config/defaults.d.ts

@@ -1,14 +0,0 @@
-import type { RequiredGitHubConfig, RequiredLocalConfig, RequiredToolsConfig, RequiredNetworkConfig, RequiredLspConfig, RequiredOutputConfig, ResolvedConfig } from './types.js';
-export declare const DEFAULT_GITHUB_CONFIG: RequiredGitHubConfig;
-export declare const DEFAULT_LOCAL_CONFIG: RequiredLocalConfig;
-export declare const DEFAULT_TOOLS_CONFIG: RequiredToolsConfig;
-export declare const DEFAULT_NETWORK_CONFIG: RequiredNetworkConfig;
-export declare const DEFAULT_LSP_CONFIG: RequiredLspConfig;
-export declare const DEFAULT_OUTPUT_CONFIG: RequiredOutputConfig;
-export declare const DEFAULT_CONFIG: Omit<ResolvedConfig, 'source' | 'configPath'>;
-export declare const MIN_TIMEOUT = 5000;
-export declare const MAX_TIMEOUT = 300000;
-export declare const MIN_RETRIES = 0;
-export declare const MAX_RETRIES = 10;
-export declare const MIN_OUTPUT_DEFAULT_CHAR_LENGTH = 1000;
-export declare const MAX_OUTPUT_DEFAULT_CHAR_LENGTH = 50000;

package/dist/shared/config/loader.d.ts

@@ -1,7 +0,0 @@
-import type { LoadConfigResult } from './types.js';
-export declare const CONFIG_FILE_PATH: string;
-export declare function configExists(): boolean;
-export declare function loadConfig(): Promise<LoadConfigResult>;
-export declare function loadConfigSync(): LoadConfigResult;
-export declare function getConfigPath(): string;
-export declare function getOctocodeDir(): string;

package/dist/shared/config/resolver.d.ts

@@ -1,2 +0,0 @@
-export { resolveConfigSync, resolveConfig, getConfig, getConfigSync, reloadConfig, invalidateConfigCache, _resetConfigCache, _getCacheState, } from './resolverCache.js';
-export declare function getConfigValue<T = unknown>(path: string): T | undefined;

package/dist/shared/config/resolverCache.d.ts

@@ -1,12 +0,0 @@
-import type { ResolvedConfig } from './types.js';
-export declare function resolveConfigSync(): ResolvedConfig;
-export declare function resolveConfig(): Promise<ResolvedConfig>;
-export declare function getConfigSync(): ResolvedConfig;
-export declare function getConfig(): Promise<ResolvedConfig>;
-export declare function reloadConfig(): Promise<ResolvedConfig>;
-export declare function invalidateConfigCache(): void;
-export declare function _resetConfigCache(): void;
-export declare function _getCacheState(): {
-    cached: boolean;
-    timestamp: number;
-};

package/dist/shared/config/resolverSections.d.ts

@@ -1,10 +0,0 @@
-import type { OctocodeConfig, RequiredGitHubConfig, RequiredLocalConfig, RequiredToolsConfig, RequiredNetworkConfig, RequiredLspConfig, RequiredOutputConfig } from './types.js';
-export declare function parseBooleanEnv(value: string | undefined): boolean | undefined;
-export declare function parseIntEnv(value: string | undefined): number | undefined;
-export declare function parseStringArrayEnv(value: string | undefined): string[] | undefined;
-export declare function resolveGitHub(fileConfig?: OctocodeConfig['github']): RequiredGitHubConfig;
-export declare function resolveLocal(fileConfig?: OctocodeConfig['local']): RequiredLocalConfig;
-export declare function resolveTools(fileConfig?: OctocodeConfig['tools']): RequiredToolsConfig;
-export declare function resolveNetwork(fileConfig?: OctocodeConfig['network']): RequiredNetworkConfig;
-export declare function resolveLsp(fileConfig?: OctocodeConfig['lsp']): RequiredLspConfig;
-export declare function resolveOutput(fileConfig?: OctocodeConfig['output']): RequiredOutputConfig;