@octocodeai/octocode-tools-core 18.2.0 → 19.1.0

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

@@ -2,7 +2,16 @@ import { z } from 'zod';
 export type LocalTextResultView = 'paginated' | 'discovery' | 'detailed' | 'content' | 'files' | 'filesWithout' | 'countLines' | 'countMatches' | 'matchOnly';
 export declare function toLegacyTextQuery(query: Record<string, unknown>, resultView: LocalTextResultView): Record<string, unknown>;
 export declare const LocalSearchQuerySchema: z.ZodUnion<readonly [z.ZodObject<{
+    goal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
     path: z.ZodString;
+    page: z.ZodDefault<z.ZodNumber>;
+    contextLines: z.ZodOptional<z.ZodNumber>;
+    regex: z.ZodDefault<z.ZodEnum<{
+        fixed: "fixed";
+        smart: "smart";
+        perl: "perl";
+    }>>;
     sort: z.ZodDefault<z.ZodEnum<{
         path: "path";
         created: "created";
@@ -11,18 +20,10 @@ export declare const LocalSearchQuerySchema: z.ZodUnion<readonly [z.ZodObject<{
         modified: "modified";
         accessed: "accessed";
     }>>;
-    goal: z.ZodOptional<z.ZodString>;
-    reasoning: z.ZodOptional<z.ZodString>;
-    page: z.ZodDefault<z.ZodNumber>;
     maxDepth: z.ZodOptional<z.ZodNumber>;
     include: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    langType: z.ZodOptional<z.ZodString>;
-    contextLines: z.ZodOptional<z.ZodNumber>;
-    regex: z.ZodDefault<z.ZodEnum<{
-        fixed: "fixed";
-        smart: "smart";
-        perl: "perl";
-    }>>;
+    excludeDir: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    maxFiles: z.ZodOptional<z.ZodNumber>;
     caseMode: z.ZodDefault<z.ZodEnum<{
         smart: "smart";
         sensitive: "sensitive";
@@ -31,20 +32,18 @@ export declare const LocalSearchQuerySchema: z.ZodUnion<readonly [z.ZodObject<{
     wholeWord: z.ZodOptional<z.ZodBoolean>;
     invertMatch: z.ZodOptional<z.ZodBoolean>;
     exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    excludeDir: z.ZodOptional<z.ZodArray<z.ZodString>>;
     noIgnore: z.ZodOptional<z.ZodBoolean>;
     hidden: z.ZodOptional<z.ZodBoolean>;
     matchContentLength: z.ZodDefault<z.ZodNumber>;
     maxMatchesPerFile: z.ZodOptional<z.ZodNumber>;
-    maxFiles: z.ZodOptional<z.ZodNumber>;
     multiline: z.ZodDefault<z.ZodEnum<{
         off: "off";
         on: "on";
         dotall: "dotall";
     }>>;
     rankingProfile: z.ZodDefault<z.ZodEnum<{
-        typescript: "typescript";
         auto: "auto";
+        typescript: "typescript";
         javascript: "javascript";
         rust: "rust";
         python: "python";
@@ -56,15 +55,16 @@ export declare const LocalSearchQuerySchema: z.ZodUnion<readonly [z.ZodObject<{
         yaml: "yaml";
         generic: "generic";
     }>>;
+    langType: z.ZodOptional<z.ZodString>;
     matchPage: z.ZodOptional<z.ZodNumber>;
     operation: z.ZodLiteral<"text">;
     searchText: z.ZodString;
     resultView: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
         content: "content";
-        files: "files";
         paginated: "paginated";
         discovery: "discovery";
         detailed: "detailed";
+        files: "files";
         filesWithout: "filesWithout";
         countLines: "countLines";
         countMatches: "countMatches";
@@ -79,7 +79,11 @@ export declare const LocalSearchQuerySchema: z.ZodUnion<readonly [z.ZodObject<{
     }>>;
     matchWindow: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>, z.ZodObject<{
+    goal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
     path: z.ZodString;
+    page: z.ZodDefault<z.ZodNumber>;
+    contextLines: z.ZodOptional<z.ZodNumber>;
     sort: z.ZodDefault<z.ZodEnum<{
         path: "path";
         created: "created";
@@ -88,23 +92,18 @@ export declare const LocalSearchQuerySchema: z.ZodUnion<readonly [z.ZodObject<{
         modified: "modified";
         accessed: "accessed";
     }>>;
-    goal: z.ZodOptional<z.ZodString>;
-    reasoning: z.ZodOptional<z.ZodString>;
-    page: z.ZodDefault<z.ZodNumber>;
     maxDepth: z.ZodOptional<z.ZodNumber>;
     include: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    langType: z.ZodOptional<z.ZodString>;
-    contextLines: z.ZodOptional<z.ZodNumber>;
-    exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
     excludeDir: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    maxFiles: z.ZodOptional<z.ZodNumber>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
     noIgnore: z.ZodOptional<z.ZodBoolean>;
     hidden: z.ZodOptional<z.ZodBoolean>;
     matchContentLength: z.ZodDefault<z.ZodNumber>;
     maxMatchesPerFile: z.ZodOptional<z.ZodNumber>;
-    maxFiles: z.ZodOptional<z.ZodNumber>;
     rankingProfile: z.ZodDefault<z.ZodEnum<{
-        typescript: "typescript";
         auto: "auto";
+        typescript: "typescript";
         javascript: "javascript";
         rust: "rust";
         python: "python";
@@ -116,6 +115,7 @@ export declare const LocalSearchQuerySchema: z.ZodUnion<readonly [z.ZodObject<{
         yaml: "yaml";
         generic: "generic";
     }>>;
+    langType: z.ZodOptional<z.ZodString>;
     captureText: z.ZodOptional<z.ZodBoolean>;
     matchPage: z.ZodOptional<z.ZodNumber>;
     operation: z.ZodLiteral<"structural">;
@@ -128,7 +128,11 @@ export declare const LocalSearchQuerySchema: z.ZodUnion<readonly [z.ZodObject<{
         countMatches: "countMatches";
     }>>>;
 }, z.core.$strict>, z.ZodObject<{
+    goal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
     path: z.ZodString;
+    page: z.ZodDefault<z.ZodNumber>;
+    contextLines: z.ZodOptional<z.ZodNumber>;
     sort: z.ZodDefault<z.ZodEnum<{
         path: "path";
         created: "created";
@@ -137,23 +141,18 @@ export declare const LocalSearchQuerySchema: z.ZodUnion<readonly [z.ZodObject<{
         modified: "modified";
         accessed: "accessed";
     }>>;
-    goal: z.ZodOptional<z.ZodString>;
-    reasoning: z.ZodOptional<z.ZodString>;
-    page: z.ZodDefault<z.ZodNumber>;
     maxDepth: z.ZodOptional<z.ZodNumber>;
     include: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    langType: z.ZodOptional<z.ZodString>;
-    contextLines: z.ZodOptional<z.ZodNumber>;
-    exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
     excludeDir: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    maxFiles: z.ZodOptional<z.ZodNumber>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
     noIgnore: z.ZodOptional<z.ZodBoolean>;
     hidden: z.ZodOptional<z.ZodBoolean>;
     matchContentLength: z.ZodDefault<z.ZodNumber>;
     maxMatchesPerFile: z.ZodOptional<z.ZodNumber>;
-    maxFiles: z.ZodOptional<z.ZodNumber>;
     rankingProfile: z.ZodDefault<z.ZodEnum<{
-        typescript: "typescript";
         auto: "auto";
+        typescript: "typescript";
         javascript: "javascript";
         rust: "rust";
         python: "python";
@@ -165,6 +164,7 @@ export declare const LocalSearchQuerySchema: z.ZodUnion<readonly [z.ZodObject<{
         yaml: "yaml";
         generic: "generic";
     }>>;
+    langType: z.ZodOptional<z.ZodString>;
     captureText: z.ZodOptional<z.ZodBoolean>;
     matchPage: z.ZodOptional<z.ZodNumber>;
     operation: z.ZodLiteral<"structural">;
@@ -177,25 +177,25 @@ export declare const LocalSearchQuerySchema: z.ZodUnion<readonly [z.ZodObject<{
         countMatches: "countMatches";
     }>>>;
 }, z.core.$strict>, z.ZodObject<{
-    path: z.ZodString;
-    empty: z.ZodOptional<z.ZodBoolean>;
     goal: z.ZodOptional<z.ZodString>;
     reasoning: z.ZodOptional<z.ZodString>;
+    path: z.ZodString;
     page: z.ZodDefault<z.ZodNumber>;
+    time: z.ZodOptional<z.ZodObject<{
+        modifiedWithin: z.ZodOptional<z.ZodString>;
+        modifiedBefore: z.ZodOptional<z.ZodString>;
+        accessedWithin: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    empty: z.ZodOptional<z.ZodBoolean>;
     size: z.ZodOptional<z.ZodObject<{
         greater: z.ZodOptional<z.ZodString>;
         less: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     maxDepth: z.ZodOptional<z.ZodNumber>;
-    names: z.ZodOptional<z.ZodArray<z.ZodString>>;
     excludeDir: z.ZodOptional<z.ZodArray<z.ZodString>>;
     minDepth: z.ZodOptional<z.ZodNumber>;
+    names: z.ZodOptional<z.ZodArray<z.ZodString>>;
     pathPattern: z.ZodOptional<z.ZodString>;
-    time: z.ZodOptional<z.ZodObject<{
-        modifiedWithin: z.ZodOptional<z.ZodString>;
-        modifiedBefore: z.ZodOptional<z.ZodString>;
-        accessedWithin: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
     extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
     entryType: z.ZodOptional<z.ZodEnum<{
         f: "f";
@@ -208,26 +208,26 @@ export declare const LocalSearchQuerySchema: z.ZodUnion<readonly [z.ZodObject<{
         writable: "writable";
     }>>;
     detail: z.ZodDefault<z.ZodEnum<{
-        full: "full";
         modified: "modified";
         basic: "basic";
+        full: "full";
     }>>;
     operation: z.ZodLiteral<"files">;
     pathRegex: z.ZodOptional<z.ZodString>;
     limit: z.ZodOptional<z.ZodNumber>;
     sort: z.ZodDefault<z.ZodEnum<{
-        name: "name";
         path: "path";
+        name: "name";
         size: "size";
         modified: "modified";
     }>>;
     pageSize: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>, z.ZodObject<{
-    path: z.ZodString;
-    reverse: z.ZodOptional<z.ZodBoolean>;
     goal: z.ZodOptional<z.ZodString>;
     reasoning: z.ZodOptional<z.ZodString>;
+    path: z.ZodString;
     page: z.ZodDefault<z.ZodNumber>;
+    reverse: z.ZodOptional<z.ZodBoolean>;
     maxDepth: z.ZodOptional<z.ZodNumber>;
     excludeDir: z.ZodOptional<z.ZodArray<z.ZodString>>;
     hidden: z.ZodOptional<z.ZodBoolean>;
@@ -237,24 +237,24 @@ export declare const LocalSearchQuerySchema: z.ZodUnion<readonly [z.ZodObject<{
         d: "d";
     }>>;
     detail: z.ZodDefault<z.ZodEnum<{
-        full: "full";
         modified: "modified";
         basic: "basic";
+        full: "full";
     }>>;
     operation: z.ZodLiteral<"tree">;
     namePattern: z.ZodOptional<z.ZodString>;
     limit: z.ZodOptional<z.ZodNumber>;
     sort: z.ZodDefault<z.ZodEnum<{
+        time: "time";
         name: "name";
         extension: "extension";
         size: "size";
-        time: "time";
     }>>;
     pageSize: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>]>;
 export type LocalSearchQuery = z.infer<typeof LocalSearchQuerySchema>;
 export declare const LocalSearchBulkQuerySchema: z.ZodObject<{
-    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>>>;
+    responseCharOffset: z.ZodOptional<z.ZodPreprocess<z.ZodNumber, unknown>>;
+    responseCharLength: z.ZodOptional<z.ZodPreprocess<z.ZodNumber, unknown>>;
+    queries: z.ZodArray<z.ZodTypeAny<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
 }, z.core.$strict>;

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

@@ -4,16 +4,16 @@ import type { BulkToolOutput } from '../../types/toolOutput.js';
 export declare const LocalViewStructureQuerySchema: z.ZodObject<{
     path: z.ZodString;
     detail: z.ZodDefault<z.ZodEnum<{
-        full: "full";
         modified: "modified";
         basic: "basic";
+        full: "full";
     }>>;
     hidden: z.ZodOptional<z.ZodBoolean>;
     sortBy: z.ZodDefault<z.ZodEnum<{
+        time: "time";
         name: "name";
         extension: "extension";
         size: "size";
-        time: "time";
     }>>;
     reverse: z.ZodOptional<z.ZodBoolean>;
     pattern: z.ZodOptional<z.ZodString>;
@@ -33,9 +33,9 @@ export declare const LocalViewStructureQuerySchema: z.ZodObject<{
 }, z.core.$strip>;
 export type ViewStructureQuery = z.infer<typeof LocalViewStructureQuerySchema>;
 export declare const LocalViewStructureBulkQuerySchema: z.ZodObject<{
-    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>>>;
+    responseCharOffset: z.ZodOptional<z.ZodPreprocess<z.ZodNumber, unknown>>;
+    responseCharLength: z.ZodOptional<z.ZodPreprocess<z.ZodNumber, unknown>>;
+    queries: z.ZodArray<z.ZodTypeAny<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
 }, z.core.$strict>;
 export interface LocalViewStructureEntry {
     name?: string;

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

@@ -1,19 +1,20 @@
 import { z } from 'zod';
+import { type ConsumerWarmupStats } from '../shared/semanticTypes.js';
 import type { ItemPagination, ToolContinuation } from '../../../scheme/pagination.js';
 import type { BulkToolOutput } from '../../../types/toolOutput.js';
 export declare const LspGetSemanticsQuerySchema: z.ZodObject<{
     uri: z.ZodOptional<z.ZodString>;
     type: z.ZodDefault<z.ZodEnum<{
         definition: "definition";
-        documentSymbols: "documentSymbols";
-        workspaceSymbol: "workspaceSymbol";
         references: "references";
         callers: "callers";
         callees: "callees";
         callHierarchy: "callHierarchy";
         hover: "hover";
+        documentSymbols: "documentSymbols";
         typeDefinition: "typeDefinition";
         implementation: "implementation";
+        workspaceSymbol: "workspaceSymbol";
         supertypes: "supertypes";
         subtypes: "subtypes";
         diagnostic: "diagnostic";
@@ -26,19 +27,28 @@ export declare const LspGetSemanticsQuerySchema: z.ZodObject<{
     groupByFile: z.ZodOptional<z.ZodBoolean>;
     page: z.ZodDefault<z.ZodNumber>;
     pageSize: z.ZodOptional<z.ZodNumber>;
+    snapshot: z.ZodOptional<z.ZodString>;
     contextLines: z.ZodOptional<z.ZodNumber>;
     format: z.ZodDefault<z.ZodEnum<{
         structured: "structured";
         compact: "compact";
     }>>;
     workspaceRoot: z.ZodOptional<z.ZodString>;
+    rustContext: z.ZodOptional<z.ZodObject<{
+        features: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodArray<z.ZodString>]>>;
+        noDefaultFeatures: z.ZodDefault<z.ZodBoolean>;
+        target: z.ZodOptional<z.ZodString>;
+        cfgs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        buildScripts: z.ZodDefault<z.ZodBoolean>;
+        procMacros: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
     goal: z.ZodOptional<z.ZodString>;
     reasoning: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const BulkLspGetSemanticsQuerySchema: z.ZodObject<{
-    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>>>;
+    responseCharOffset: z.ZodOptional<z.ZodPreprocess<z.ZodNumber, unknown>>;
+    responseCharLength: z.ZodOptional<z.ZodPreprocess<z.ZodNumber, unknown>>;
+    queries: z.ZodArray<z.ZodTypeAny<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
 }, z.core.$strict>;
 interface LspLocation {
     uri: string;
@@ -74,7 +84,7 @@ interface LspInfo {
     provider?: string;
     source?: string;
 }
-type LspEmptyCategory = 'unsupportedOperation' | 'symbolNotFound' | 'anchorFailed' | 'noLocations' | 'noReferences' | 'noHover' | 'noCalls' | 'noWorkspaceSymbols' | 'noTypeHierarchy' | 'noDiagnostics';
+type LspEmptyCategory = 'unsupportedOperation' | 'symbolNotFound' | 'anchorFailed' | 'paginationChanged' | 'paginationSnapshotRequired' | 'noLocations' | 'noReferences' | 'noHover' | 'noCalls' | 'noWorkspaceSymbols' | 'noTypeHierarchy' | 'noDiagnostics';
 interface LspEmptyState {
     category: LspEmptyCategory;
     reason: string;
@@ -100,6 +110,7 @@ interface LspCompactCall {
 }
 interface LspCompleteness {
     complete: boolean;
+    consumerWarmupIncomplete?: true;
     truncatedByDepth: boolean;
     truncatedByBudget?: boolean;
     visitedNodeCount?: number;
@@ -137,12 +148,15 @@ type LspSemanticPayload = {
 } | {
     kind: 'implementation';
     locations: Array<LspLocation | string>;
+    warmup?: ConsumerWarmupStats;
 } | {
     kind: 'references';
     locations?: Array<LspLocation | string>;
     byFile?: Array<LspReferencesByFile | string>;
     totalReferences: number;
     totalFiles: number;
+    definitionOnly?: boolean;
+    warmup?: ConsumerWarmupStats;
     empty?: LspEmptyState;
 } | {
     kind: 'callers' | 'callees' | 'callHierarchy';
@@ -151,6 +165,7 @@ type LspSemanticPayload = {
     calls: Array<LspCompactCall | string>;
     incomingCalls: number;
     outgoingCalls: number;
+    warmup?: ConsumerWarmupStats;
     completeness: LspCompleteness;
     empty?: LspEmptyState;
 } | {
@@ -188,6 +203,7 @@ type LspSemanticPayload = {
     kind: 'empty';
     category: LspEmptyCategory;
     reason: string;
+    warmup?: ConsumerWarmupStats;
 };
 export interface LspGetSemanticsData {
     type: string;
@@ -198,7 +214,13 @@ export interface LspGetSemanticsData {
     resolvedSymbol?: LspResolvedSymbol;
     lsp?: LspInfo;
     payload: LspSemanticPayload;
-    pagination?: ItemPagination;
+    pagination?: ItemPagination & {
+        snapshot?: string;
+    };
+    snapshot?: {
+        expected?: string;
+        actual?: string;
+    };
     summary?: Record<string, unknown>;
     next?: Record<string, ToolContinuation>;
     hints?: string[];

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

@@ -1,13 +1,6 @@
 import { acquirePooledClient } from '@octocodeai/octocode-engine/lsp/manager';
 import type { SymbolAnchor } from '../shared/resolveSymbolAnchor.js';
-import type { LspSemanticEnvelope, SymbolAnchoredSemanticQuery } from '../shared/semanticTypes.js';
-declare const CONSUMER_SCOPED_TYPES: ReadonlySet<string>;
-export { CONSUMER_SCOPED_TYPES };
-export type ConsumerWarmupStats = {
-    candidates: number;
-    warmedFiles: number;
-    skippedLarge: number;
-    possiblyTruncated: boolean;
-};
+import type { ConsumerWarmupStats, LspSemanticEnvelope, SymbolAnchoredSemanticQuery } from '../shared/semanticTypes.js';
+export declare const CONSUMER_SCOPED_PROVIDERS: Readonly<Partial<Record<SymbolAnchoredSemanticQuery['type'], string>>>;
 export declare function warmLikelyConsumers(client: NonNullable<Awaited<ReturnType<typeof acquirePooledClient>>>, anchor: SymbolAnchor, workspaceRoot: string): Promise<ConsumerWarmupStats>;
 export declare function dispatchAnchoredSemantic(query: SymbolAnchoredSemanticQuery, anchor: SymbolAnchor, client: NonNullable<Awaited<ReturnType<typeof acquirePooledClient>>>, warmupStats?: ConsumerWarmupStats): Promise<LspSemanticEnvelope>;

package/dist/tools/lsp/semantic_content/semanticEnvelopes/callEnvelopes.d.ts

@@ -1,5 +1,5 @@
 import { acquirePooledClient } from '@octocodeai/octocode-engine/lsp/manager';
-import { type LspSemanticEnvelope, type SymbolAnchoredSemanticQuery } from '../../shared/semanticTypes.js';
+import { type LspSemanticEnvelope, type SymbolAnchoredSemanticQuery, type ConsumerWarmupStats } from '../../shared/semanticTypes.js';
 import type { SymbolAnchor } from '../../shared/resolveSymbolAnchor.js';
-export declare function callsEnvelope(query: SymbolAnchoredSemanticQuery, anchor: SymbolAnchor, client: NonNullable<Awaited<ReturnType<typeof acquirePooledClient>>>): Promise<LspSemanticEnvelope>;
+export declare function callsEnvelope(query: SymbolAnchoredSemanticQuery, anchor: SymbolAnchor, client: NonNullable<Awaited<ReturnType<typeof acquirePooledClient>>>, warmupStats?: ConsumerWarmupStats): Promise<LspSemanticEnvelope>;
 export declare function typeHierarchyEnvelope(query: SymbolAnchoredSemanticQuery, anchor: SymbolAnchor, client: NonNullable<Awaited<ReturnType<typeof acquirePooledClient>>>): Promise<LspSemanticEnvelope>;

package/dist/tools/lsp/semantic_content/semanticEnvelopes/envelopeHelpers.d.ts

@@ -10,11 +10,12 @@ export type PaginationInfo = {
     hasMore: boolean;
     pageSize: number;
     nextPage?: number;
+    snapshot?: string;
 };
 export declare function emptyCategoryForReason(type: SemanticContentType, reason: string): SemanticEmptyCategory;
 export declare function failedAnchorEnvelope(query: LspGetSemanticsQuery, reason: string): LspSemanticEnvelope;
 export declare function emptyEnvelope(type: SemanticContentType, anchor: SymbolAnchor, reason: string, serverAvailable?: boolean): LspSemanticEnvelope;
-export declare function paginateItems<T>(items: readonly T[], requestedPage: number, requestedItemsPerPage: number): {
+export declare function paginateItems<T>(items: readonly T[], requestedPage: number, requestedItemsPerPage: number, query?: LspGetSemanticsQuery, identities?: readonly unknown[]): {
     pageItems: T[];
     pagination: PaginationInfo;
 };

package/dist/tools/lsp/semantic_content/semanticEnvelopes/locationEnvelopes.d.ts

@@ -1,8 +1,7 @@
 import type { LSPRange, ReferenceLocation, ReferencesByFile, CodeSnippet } from '@octocodeai/octocode-engine/lsp/types';
-import { type LspSemanticEnvelope, type SymbolAnchoredSemanticQuery } from '../../shared/semanticTypes.js';
+import { type LspSemanticEnvelope, type SymbolAnchoredSemanticQuery, type ConsumerWarmupStats } from '../../shared/semanticTypes.js';
 import type { SymbolAnchor } from '../../shared/resolveSymbolAnchor.js';
-import type { ConsumerWarmupStats } from '../semanticAnchored.js';
-export declare function locationsEnvelope(query: SymbolAnchoredSemanticQuery, anchor: SymbolAnchor, kind: 'definition' | 'typeDefinition' | 'implementation', provider: string, locations: CodeSnippet[]): LspSemanticEnvelope;
+export declare function locationsEnvelope(query: SymbolAnchoredSemanticQuery, anchor: SymbolAnchor, kind: 'definition' | 'typeDefinition' | 'implementation', provider: string, locations: CodeSnippet[], warmupStats?: ConsumerWarmupStats): LspSemanticEnvelope;
 export declare function referencesEnvelope(query: SymbolAnchoredSemanticQuery, anchor: SymbolAnchor, locations: CodeSnippet[], warmupStats?: ConsumerWarmupStats): LspSemanticEnvelope;
 export declare function hoverEnvelope(_query: SymbolAnchoredSemanticQuery, anchor: SymbolAnchor, hover: unknown): Promise<LspSemanticEnvelope>;
 export declare function buildReferencesByFile(locations: readonly ReferenceLocation[]): ReferencesByFile[];

package/dist/tools/lsp/semantic_content/semanticFileOps/anchor.d.ts

@@ -18,7 +18,6 @@ export declare function workspaceSymbolAnchorExtensions(): string[];
 export declare function workspaceSymbolAnchorIncludeGlobs(): string[];
 export declare function findWorkspaceSymbolAnchorByName(query: WorkspaceSymbolSemanticQuery, workspaceRoot: string): Promise<string | undefined>;
 export declare function resolveWorkspaceSymbolAnchor(query: WorkspaceSymbolSemanticQuery, workspaceRoot: string): Promise<string>;
-export declare function lspErrorMessage(error: unknown): string;
 /**
  * Native JS/TS document symbols via oxc, parsed into the LSP `DocumentSymbol[]`
  * shape. Returns `null` when oxc declines the input so the caller can fall back

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

@@ -20,6 +20,7 @@ export type CompactCall = {
     contentPreview?: string;
 };
 export declare function attachSemanticRawEvidence<T extends object>(result: T): T;
+export declare function classifySemanticResult(result: LspSemanticEnvelope | Record<string, unknown>): LspSemanticEnvelope | Record<string, unknown>;
 export declare function formatSemanticResult(query: LspGetSemanticsQuery, result: LspSemanticEnvelope | Record<string, unknown>): LspSemanticEnvelope | Record<string, unknown>;
 export declare function isSemanticEnvelope(value: LspSemanticEnvelope | Record<string, unknown>): value is LspSemanticEnvelope;
 export declare function compactSemanticEnvelope(envelope: LspSemanticEnvelope): LspSemanticEnvelope;

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

@@ -0,0 +1,16 @@
+import type { LspGetSemanticsQuery, LspSemanticEnvelope } from '../shared/semanticTypes.js';
+export declare function describeRustContext(query: LspGetSemanticsQuery): {
+    fingerprint: string;
+    features: string | string[];
+    noDefaultFeatures: boolean;
+    target: string;
+    cfgs: string[];
+    buildScripts: boolean;
+    procMacros: boolean;
+};
+/** Content-addressed guard, independent of process-local caches or server order. */
+export declare function semanticSnapshotItems<T>(items: readonly T[], query: LspGetSemanticsQuery, identities?: readonly unknown[]): {
+    items: T[];
+    snapshot: string;
+};
+export declare function guardSemanticSnapshot(query: LspGetSemanticsQuery, result: LspSemanticEnvelope | Record<string, unknown>): LspSemanticEnvelope | Record<string, unknown>;

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

@@ -8,6 +8,7 @@ export type TraversalResult<T> = {
     requestCount: number;
     cycleCount: number;
     failedRequestCount: number;
+    excludedCallCount?: number;
 };
 export type TraversalBudget = {
     maxNodes: number;
@@ -20,4 +21,4 @@ export type MutableTraversalBudget = TraversalBudget & {
 };
 export declare function createCallItemKey(item: CallHierarchyItem): string;
 export declare function gatherIncomingCallsRecursive(client: LSPClient | null, item: CallHierarchyItem, remainingDepth: number, visited: Set<string>, contextLines: number, budget?: MutableTraversalBudget): Promise<TraversalResult<IncomingCall>>;
-export declare function gatherOutgoingCallsRecursive(client: LSPClient | null, item: CallHierarchyItem, remainingDepth: number, visited: Set<string>, contextLines: number, budget?: MutableTraversalBudget): Promise<TraversalResult<OutgoingCall>>;
+export declare function gatherOutgoingCallsRecursive(client: LSPClient | null, item: CallHierarchyItem, remainingDepth: number, visited: Set<string>, contextLines: number, budget?: MutableTraversalBudget, excludeCall?: (call: OutgoingCall) => boolean): Promise<TraversalResult<OutgoingCall>>;

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

@@ -1,5 +1,4 @@
-import type { ExactPosition, LSPRange } from '@octocodeai/octocode-engine/lsp/types';
-export { LSP_GET_SEMANTICS_TOOL_NAME } from '../../toolNames.js';
+import type { ExactPosition, LSPRange, RustBuildContext } from '@octocodeai/octocode-engine/lsp/types';
 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';
@@ -8,8 +7,10 @@ export type SemanticQueryBase = {
     type: SemanticContentType;
     uri?: string;
     workspaceRoot?: string;
+    rustContext?: RustBuildContext;
     page?: number;
     pageSize?: number;
+    snapshot?: string;
     contextLines?: number;
     format?: SemanticOutputFormat;
     goal?: string;
@@ -77,11 +78,18 @@ export declare function compactLocation(snippet: {
     };
     isDefinition?: boolean;
 }): CompactLocation;
-export type SemanticEmptyCategory = 'unsupportedOperation' | 'symbolNotFound' | 'anchorFailed' | 'noLocations' | 'noReferences' | 'noHover' | 'noCalls' | 'noWorkspaceSymbols' | 'noTypeHierarchy' | 'noDiagnostics';
+export type SemanticEmptyCategory = 'unsupportedOperation' | 'symbolNotFound' | 'anchorFailed' | 'paginationChanged' | 'paginationSnapshotRequired' | 'noLocations' | 'noReferences' | 'noHover' | 'noCalls' | 'noWorkspaceSymbols' | 'noTypeHierarchy' | 'noDiagnostics';
 export type SemanticEmptyState = {
     category: SemanticEmptyCategory;
     reason: string;
 };
+export type ConsumerWarmupStats = {
+    candidates: number;
+    warmedFiles: number;
+    skippedLarge: number;
+    possiblyTruncated: boolean;
+    incompleteReasons?: Array<'fileCap' | 'fileRead' | 'search'>;
+};
 export type LspSemanticEnvelope = {
     type: SemanticContentType;
     uri: string;
@@ -103,12 +111,8 @@ export type LspSemanticEnvelope = {
         byFile?: unknown[];
         totalReferences: number;
         totalFiles: number;
-        warmup?: {
-            candidates: number;
-            warmedFiles: number;
-            skippedLarge: number;
-            possiblyTruncated: boolean;
-        };
+        definitionOnly?: boolean;
+        warmup?: ConsumerWarmupStats;
         empty?: SemanticEmptyState;
     } | {
         kind: 'callers' | 'callees' | 'callHierarchy';
@@ -117,8 +121,10 @@ export type LspSemanticEnvelope = {
         calls: unknown[];
         incomingCalls?: number;
         outgoingCalls?: number;
+        warmup?: ConsumerWarmupStats;
         completeness: {
             complete: boolean;
+            consumerWarmupIncomplete?: true;
             truncatedByDepth: boolean;
             truncatedByBudget?: boolean;
             visitedNodeCount?: number;
@@ -140,6 +146,7 @@ export type LspSemanticEnvelope = {
     } | {
         kind: 'implementation';
         locations: Array<CompactLocation | string>;
+        warmup?: ConsumerWarmupStats;
     } | {
         kind: 'documentSymbols';
         symbols: unknown[];
@@ -170,13 +177,15 @@ export type LspSemanticEnvelope = {
         kind: 'empty';
         category: SemanticEmptyCategory;
         reason: string;
+        warmup?: ConsumerWarmupStats;
     };
     pagination?: unknown;
     warnings?: string[];
     hints?: string[];
     terminalLimit?: boolean;
     truncated?: boolean;
-    partialReasons?: Array<'warmupCap' | 'depth' | 'budget'>;
+    incompleteResults?: boolean;
+    partialReasons?: Array<'warmupCap' | 'warmupIncomplete' | 'depth' | 'budget' | 'readinessUnconfirmed'>;
     next?: Record<string, {
         tool: string;
         query: Record<string, unknown>;

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

@@ -1,13 +1,11 @@
 import type { CallToolResult } from '@modelcontextprotocol/server';
 import type { z } from 'zod';
-import type { NpmSearchQueryLocalSchema } from './scheme.js';
+import { NpmSearchQueryLocalSchema } from './scheme.js';
 type NpmSearchQuery = z.input<typeof NpmSearchQueryLocalSchema> & {
     pageSize?: number;
 };
-export { foldKeywords, isPackageNotFoundError } from './queryHelpers.js';
-import type { PackageResult } from '../../utils/package/common.js';
+import type { PackageResult } from '../../utils/package/types.js';
 import type { ToolExecutionArgs } from '../../types/execution.js';
-export { buildPackagePagination } from './pagination.js';
 /**
  * Normalize the many repository URL shapes npm packages carry
  * (ssh://git@…, git+https://…, git://…, git@host:owner/repo, and npm's
@@ -42,3 +40,4 @@ type CompactPackageData = {
 export declare function formatPackageData(pkg: PackageResult): PackageData;
 export declare function compactPackageRepositories(packages: PackageData[]): CompactPackageData;
 export declare function searchPackages(args: ToolExecutionArgs<NpmSearchQuery>): Promise<CallToolResult>;
+export {};

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

@@ -1,4 +1,5 @@
 type PackagePageQuery = {
+    registry?: string;
     keywords?: string[];
     page?: number;
     pageSize?: number;

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

@@ -4,14 +4,15 @@ import type { BulkToolOutput } from '../../types/toolOutput.js';
 export declare const NpmSearchQueryLocalSchema: z.ZodObject<{
     packageName: z.ZodOptional<z.ZodString>;
     keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    page: z.ZodDefault<z.ZodNumber>;
+    page: z.ZodOptional<z.ZodNumber>;
+    registry: z.ZodOptional<z.ZodString>;
     goal: z.ZodOptional<z.ZodString>;
     reasoning: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const NpmSearchBulkQueryLocalSchema: z.ZodObject<{
-    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>>>;
+    responseCharOffset: z.ZodOptional<z.ZodPreprocess<z.ZodNumber, unknown>>;
+    responseCharLength: z.ZodOptional<z.ZodPreprocess<z.ZodNumber, unknown>>;
+    queries: z.ZodArray<z.ZodTypeAny<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
 }, z.core.$strict>;
 export interface NpmSearchPackage {
     name: string;