@octocodeai/octocode-tools-core 18.3.0 → 19.1.0

package/dist/toolContract/input/resources/tools/localSearch.d.ts

@@ -2,7 +2,16 @@ import { z } from 'zod';
 import type { ToolSpec } from '../../types/index.js';
 export declare const localSearch: ToolSpec;
 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">;
@@ -130,7 +130,11 @@ export declare const LocalSearchQuerySchema: z.ZodUnion<readonly [z.ZodObject<{
     reverse: z.ZodOptional<z.ZodBoolean>;
     pattern: z.ZodString;
 }, 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";
@@ -139,23 +143,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";
@@ -167,6 +166,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">;
@@ -181,25 +181,25 @@ export declare const LocalSearchQuerySchema: z.ZodUnion<readonly [z.ZodObject<{
     reverse: z.ZodOptional<z.ZodBoolean>;
     rule: z.ZodString;
 }, 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";
@@ -212,9 +212,9 @@ 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>;
@@ -227,11 +227,11 @@ export declare const LocalSearchQuerySchema: z.ZodUnion<readonly [z.ZodObject<{
     }>>;
     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>;
@@ -241,18 +241,18 @@ 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>]>;

package/dist/toolContract/input/resources/tools/localTextOperation.d.ts

@@ -76,8 +76,8 @@ export declare const RipgrepQuerySchema: z.ZodObject<{
     }>>;
     sortReverse: z.ZodOptional<z.ZodBoolean>;
     rankingProfile: z.ZodDefault<z.ZodEnum<{
-        typescript: "typescript";
         auto: "auto";
+        typescript: "typescript";
         javascript: "javascript";
         rust: "rust";
         python: "python";

package/dist/toolContract/input/resources/tools/localTreeOperation.d.ts

@@ -15,16 +15,16 @@ export declare const localTreeOperationDescriptions: {
 export declare const ViewStructureQuerySchema: 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>;

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

@@ -5,15 +5,15 @@ 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,12 +26,21 @@ 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>;

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

@@ -4,7 +4,8 @@ export declare const npmSearch: ToolSpec;
 export declare const NpmPackageQuerySchema: 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>;

package/dist/toolContract/metadata.d.ts

@@ -1,7 +1,7 @@
 /** Shared prompt plus the canonical tools-core-owned executable catalog. */
 export declare const localCompleteMetadata: {
     systemPrompt: string;
-    toolNames: import("./types.js").ToolNames;
+    toolNames: import("./input/types/index.js").ToolNames;
     baseSchema: Record<"goal" | "reasoning", string>;
     tools: {
         [k: string]: {

package/dist/toolContract/runtime.d.ts

@@ -1,5 +1,5 @@
 import type { z } from 'zod';
-import { RipgrepQuerySchema } from './schemas.js';
+import { RipgrepQuerySchema } from './input/resources/tools/localTextOperation.js';
 type RuntimeRipgrepQuery = z.infer<typeof RipgrepQuerySchema>;
 export interface RipgrepValidationResult {
     isValid: boolean;

package/dist/toolContract/types.d.ts

@@ -1,4 +1,3 @@
-export type { ToolNames, ToolSchema, ToolSpec, ToolType, } from './input/types/index.js';
 import type { ToolNames } from './input/types/index.js';
 export interface LocalCompleteMetadata {
     readonly systemPrompt: string;

package/dist/tools/directToolCatalog/toolCatalogDefinitions.d.ts

@@ -1,8 +1,6 @@
 /**
- * Engine-free direct-tool catalog: registry of tool definitions (name +
- * display/bulk zod schemas) plus category/sort/output-field helpers. Split out
- * of `directToolCatalog.meta.ts` (still the public barrel) — see that file's
- * header comment for the full P3 engine-free rationale.
+ * Engine-free registry of tool definitions, schemas, categories, and output fields.
+ * Public schema consumers import @octocodeai/octocode-tools-core/schema.
  */
 import { z } from 'zod';
 export type DirectToolInput = Record<string, unknown> & {

package/dist/tools/directToolCatalog/toolInputPreparation.d.ts

@@ -1,9 +1,6 @@
 /**
- * Input preparation/normalization for the engine-free direct-tool catalog:
- * JSON parsing, envelope handling, default-field filling, and unknown-field
- * detection (with did-you-mean suggestions). Split
- * out of `directToolCatalog.meta.ts` (still the public barrel) — see that
- * file's header comment for the full P3 rationale.
+ * Engine-free input preparation: JSON parsing, envelopes, default fields,
+ * and unknown-field validation with spelling suggestions.
  */
 import { z } from 'zod';
 import { type DirectToolInput, type PrepareDirectToolInputOptions } from './toolCatalogDefinitions.js';

package/dist/tools/directToolCatalog.exec.d.ts

@@ -1,16 +1,19 @@
 /**
- * Direct-tool EXECUTION path (P3). This module imports the engine (native LSP
- * client pool) and every tool's execution function via `ALL_TOOLS`, so it is the
- * one that loads the native `.node` addon at eval. It is reached only when a tool
- * actually runs — schema/help/`--scheme`/`context` use `directToolCatalog.meta.ts`
- * (and the `@octocodeai/octocode-tools-core/schema` subpath), which is engine-free.
+ * Direct-tool EXECUTION path (P3). Shared runtime and security imports load the
+ * native addon here; `ALL_TOOLS` loads each execution handler only when called.
+ * This entry is reached only when a tool actually runs. Schema, help, and
+ * context use the engine-free
+ * `@octocodeai/octocode-tools-core/schema` entry point.
  */
 import type { CallToolResult } from '@modelcontextprotocol/server';
-import { DirectToolInputError } from './directToolCatalog.meta.js';
+import { type CallToolResultProjection } from '../utils/response/callToolResult.js';
+import { DirectToolInputError } from './directToolCatalog/toolCatalogDefinitions.js';
 type InitializeFn = () => Promise<void>;
 /** @internal — test use only; not part of the public API. */
 export declare function _overrideInitialize(fn: InitializeFn): void;
 /** @internal — test use only; not part of the public API. */
 export declare function _resetInitialize(): void;
-export declare function executeDirectTool(name: string, input: unknown): Promise<CallToolResult>;
+export declare function executeDirectTool(name: string, input: unknown, options?: {
+    resultProjection?: CallToolResultProjection;
+}): Promise<CallToolResult>;
 export { DirectToolInputError };

package/dist/tools/github_clone_repo/cache.d.ts

@@ -1,6 +1,4 @@
 import type { CloneCacheMeta, CacheSource } from './types.js';
-export { cleanupStaleCloneArtifacts, tryRecoverStaleCloneLock, writeCloneLockMeta, } from './cacheArtifacts.js';
-export { getReposBaseDir, getCloneBaseDir, getTreeBaseDir, getCloneDir, getTreeDir, } from './cachePaths.js';
 export declare function readCacheMeta(cloneDir: string): CloneCacheMeta | null;
 export declare function writeCacheMeta(cloneDir: string, meta: CloneCacheMeta): void;
 export declare function isCacheValid(meta: CloneCacheMeta): boolean;

package/dist/tools/github_clone_repo/cacheArtifacts.d.ts

@@ -1,3 +1,5 @@
+/** Nonblocking exclusive acquisition shared by cache eviction and writers. */
+export declare function tryAcquireMaterializationLock(lockDir: string): (() => void) | undefined;
 export declare function writeCloneLockMeta(lockDir: string, pid?: number, createdAt?: number): void;
 export declare function tryRecoverStaleCloneLock(lockDir: string, now?: number): boolean;
-export declare function cleanupStaleCloneArtifacts(octocodeDir: string, now?: number): number;
+export declare function cleanupStaleMaterializationArtifacts(octocodeDir: string, now?: number): number;

package/dist/tools/github_clone_repo/cachePaths.d.ts

@@ -1,5 +1,6 @@
-export declare function getReposBaseDir(octocodeDir: string): string;
 export declare function getCloneBaseDir(octocodeDir: string): string;
 export declare function getTreeBaseDir(octocodeDir: string): string;
-export declare function getCloneDir(octocodeDir: string, owner: string, repo: string, branch: string, sparsePath?: string): string;
+export declare function getTreeLockDir(octocodeDir: string, cacheRoot: string): string;
+export declare function getCloneLockDir(octocodeDir: string, cacheRoot: string): string;
+export declare function getCloneDir(octocodeDir: string, owner: string, repo: string, branch: string, sparsePath?: string, endpoint?: string): string;
 export declare function getTreeDir(octocodeDir: string, owner: string, repo: string, commitSha: string): string;

package/dist/tools/github_clone_repo/gitCheckout.d.ts

@@ -0,0 +1,5 @@
+export declare function readHeadCommit(directory: string): Promise<string>;
+export declare function executeCommitClone(commit: string, targetDir: string, sparsePath: string | undefined, url: string, token?: string): Promise<void>;
+export declare function executeFullClone(owner: string, repo: string, branch: string, targetDir: string, url: string, token?: string): Promise<void>;
+export declare function executeSparseClone(owner: string, repo: string, branch: string, targetDir: string, sparsePath: string, url: string, token?: string): Promise<void>;
+export declare function assertGitAvailable(): Promise<void>;

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

@@ -9,9 +9,9 @@ export declare const CloneRepoQueryLocalSchema: import("zod").ZodObject<{
     reasoning: import("zod").ZodOptional<import("zod").ZodString>;
 }, import("zod/v4/core").$strip>;
 export declare const BulkCloneRepoLocalSchema: import("zod").ZodObject<{
-    responseCharOffset: import("zod").ZodOptional<import("zod").ZodPreprocess<import("zod").ZodNumber>>;
-    responseCharLength: import("zod").ZodOptional<import("zod").ZodPreprocess<import("zod").ZodNumber>>;
-    queries: import("zod").ZodArray<import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>>;
+    responseCharOffset: import("zod").ZodOptional<import("zod").ZodPreprocess<import("zod").ZodNumber, unknown>>;
+    responseCharLength: import("zod").ZodOptional<import("zod").ZodPreprocess<import("zod").ZodNumber, unknown>>;
+    queries: import("zod").ZodArray<import("zod").ZodTypeAny<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>>;
 }, import("zod/v4/core").$strict>;
 interface GitHubCloneRepoLocation {
     kind: 'repo' | 'tree';

package/dist/tools/github_clone_repo/types.d.ts

@@ -1,4 +1,4 @@
-export type CacheSource = 'clone' | 'directoryFetch' | 'treeFetch';
+export type CacheSource = 'clone' | 'treeFetch';
 export interface CloneCacheMeta {
     clonedAt: string;
     expiresAt: string;
@@ -10,10 +10,15 @@ export interface CloneCacheMeta {
     sparsePath?: string;
     source: CacheSource;
     sizeBytes?: number;
+    /** Immutable materialization generation selected by this atomic cache record. */
+    snapshotId?: string;
 }
 export interface CloneRepoResult {
     localPath: string;
     cached: boolean;
+    commitSha: string;
+    /** Fresh checkout verification; cached working-tree contents are not reverified. */
+    verified: boolean;
     owner: string;
     repo: string;
     branch: string;

package/dist/tools/github_fetch_content/finalizer/types.d.ts

@@ -1,5 +1,5 @@
 import type { z } from 'zod';
-import type { FileContentQuerySchema } from '../../../toolContract/schemas.js';
+import type { FileContentQuerySchema } from '../../../toolContract/input/resources/tools/ghGetFileContent.js';
 type FileContentQuery = z.infer<typeof FileContentQuerySchema>;
 import type { PaginationInfo } from '../../../types/toolResults.js';
 import type { QueryWithPagination } from '../../../utils/response/groupedFinalizer.js';
@@ -19,6 +19,9 @@ export type FileEntry = {
     commitSha?: string;
     pagination?: PaginationInfo;
     isPartial?: boolean;
+    errorCode?: 'contentSecurityLimit';
+    terminalLimit?: boolean;
+    partialReasons?: Array<'security-selected-view-size-limit'>;
     startLine?: number;
     endLine?: number;
     matchRanges?: Array<{
@@ -36,6 +39,12 @@ export type FileEntry = {
     next?: FileContentNextMap;
 };
 export type FileContentNextMap = {
+    readBoundedLines?: {
+        tool: 'ghGetFileContent';
+        query: Record<string, unknown>;
+        why: string;
+        confidence: 'exact';
+    };
     continueChars?: {
         tool: 'ghGetFileContent';
         query: Record<string, unknown>;
@@ -76,7 +85,6 @@ export type DirectoryEntry = {
     savedFileCount?: number;
     skipped?: {
         nonFile: number;
-        missingDownloadUrl: number;
         oversized: number;
         binary: number;
         fileLimit: number;

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

@@ -32,9 +32,9 @@ export declare const FileContentQueryLocalSchema: z.ZodObject<{
     reasoning: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const FileContentBulkQueryLocalSchema: 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 type GitHubFetchFilePagination = (CharPagination & {
     nextPage?: number;
@@ -86,7 +86,6 @@ export interface GitHubFetchDirectoryEntry {
     savedFileCount?: number;
     skipped?: {
         nonFile: number;
-        missingDownloadUrl: number;
         oversized: number;
         binary: number;
         fileLimit: number;

package/dist/tools/github_fetch_content/types.d.ts

@@ -1,5 +1,5 @@
 import type { z } from 'zod';
-import type { FileContentQuerySchema } from '../../toolContract/schemas.js';
+import type { FileContentQuerySchema } from '../../toolContract/input/resources/tools/ghGetFileContent.js';
 import type { MinifyMode } from '../../scheme/fields.js';
 type FileContentQuery = z.infer<typeof FileContentQuerySchema>;
 import type { PaginationInfo } from '../../types/toolResults.js';
@@ -23,6 +23,9 @@ export interface GitHubFileContentApiData {
     startLine?: number;
     endLine?: number;
     isPartial?: boolean;
+    errorCode?: 'contentSecurityLimit';
+    terminalLimit?: boolean;
+    partialReasons?: Array<'security-selected-view-size-limit'>;
     totalLines?: number;
     sourceChars?: number;
     matchRanges?: Array<{
@@ -39,7 +42,6 @@ export interface GitHubFileContentApiData {
     cached?: boolean;
     matchNotFound?: boolean;
     searchedFor?: string;
-    signaturesExtracted?: boolean;
 }
 interface GitHubFileContentApiResultBase {
     error?: string;
@@ -70,7 +72,6 @@ export interface DirectoryFetchResult {
     savedFileCount: number;
     skipped: {
         nonFile: number;
-        missingDownloadUrl: number;
         oversized: number;
         binary: number;
         fileLimit: number;