@octocodeai/octocode-tools-core 18.1.2 → 18.2.0

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

@@ -1,5 +1,5 @@
 import type { GitHubAPIError } from '../../github/githubAPI.js';
-import type { BaseQueryLocal } from '@octocodeai/octocode-core/extra-types';
+import type { BaseQueryLocal } from '../../types/execution.js';
 type PartialBaseQuery = Partial<BaseQueryLocal>;
 export interface UnifiedErrorResult {
     status: 'error';
@@ -43,9 +43,8 @@ export type SafeParseOutcome<T> = {
  * Validate `input` against `schema`, returning either the parsed data or a
  * structured {@link UnifiedErrorResult} built via {@link createErrorResult}.
  *
- * Replaces the per-tool `safeParse → issues.map(...).join('; ') →
- * createErrorResult('Validation error: …')` block. Pass `prefix: false` to
- * omit the "Validation error: " prefix (github_fetch_content parity).
+ * Replaces per-tool issue joining. Messages are direct by default; pass
+ * `prefix: true` only when a caller needs the legacy "Validation error: " label.
  */
 export declare function safeParseOrError<T>(schema: SafeParseableSchema<T>, query: PartialBaseQuery, options?: {
     toolName?: string;

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

@@ -1,12 +1,8 @@
 import type { BulkFinalizerOutput } from '../../types/bulk.js';
 import type { FlatQueryResult } from '../../types/toolResults.js';
-export type QueryWithPagination = {
-    id?: unknown;
-    charLength?: unknown;
-    charOffset?: unknown;
-};
+export type QueryWithPagination = object;
 export type FlatErrorEntry = {
-    id: string;
+    index: number;
     error: string;
     status?: number;
     retryAfterSeconds?: number;

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

@@ -0,0 +1,6 @@
+export interface NormalizedError {
+    name: string;
+    message: string;
+    code?: string;
+}
+export declare function normalizeError(error: unknown): NormalizedError;

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

@@ -0,0 +1,4 @@
+export declare function buildResponseChannels<T extends object>(responseData: T, keysPriority: readonly string[]): {
+    text: string;
+    structuredContent: T;
+};

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@octocodeai/octocode-tools-core",
   "description": "Core tool implementations for Octocode: GitHub, local filesystem, LSP, and package search tools.",
-  "version": "18.1.2",
+  "version": "18.2.0",
   "author": "Guy Bary <bgauryy@octocodeai.com>",
   "bugs": "https://github.com/bgauryy/octocode/issues",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@modelcontextprotocol/server": "^2.0.0",
     "@octocodeai/config": "18.0.1",
-    "@octocodeai/octocode-core": "18.2.0",
-    "@octocodeai/octocode-engine": "18.1.2",
+    "@octocodeai/octocode-core": "18.3.0",
+    "@octocodeai/octocode-engine": "18.2.0",
     "@octokit/oauth-methods": "^6.0.2",
     "@octokit/plugin-throttling": "^11.0.3",
     "@octokit/request": "^10.0.10",
@@ -92,8 +92,9 @@
     "directory": "packages/octocode-tools-core"
   },
   "scripts": {
-    "build": "yarn readme:sync && yarn clean && node build.mjs && tsc --emitDeclarationOnly -p tsconfig.build.json",
-    "build:dev": "yarn readme:sync && node build.mjs && tsc --emitDeclarationOnly -p tsconfig.build.json",
+    "build": "yarn readme:sync && yarn clean && node build.mjs && yarn build:types-deps && tsc --emitDeclarationOnly -p tsconfig.build.json",
+    "build:dev": "yarn readme:sync && node build.mjs && yarn build:types-deps && tsc --emitDeclarationOnly -p tsconfig.build.json",
+    "build:types-deps": "yarn workspace @octocodeai/config build",
     "clean": "rm -rf dist/",
     "lint": "eslint src",
     "lint:fix": "eslint src --fix",

package/dist/github/discussions.d.ts

@@ -1,45 +0,0 @@
-import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
-import type { GitHubAPIResponse } from './githubAPI.js';
-type DiscussionRow = {
-    number: number;
-    title: string;
-    url: string;
-    author?: string;
-    category?: string;
-    createdAt?: string;
-    updatedAt?: string;
-    /** True when a comment has been accepted as the answer (Q&A categories). */
-    answered?: true;
-    upvotes?: number;
-    comments?: number;
-};
-export type DiscussionsResult = {
-    type: 'discussions';
-    owner: string;
-    repo: string;
-    totalCount: number;
-    discussions: DiscussionRow[];
-    pagination: {
-        perPage: number;
-        hasMore: boolean;
-        /** Opaque cursor to pass back as `after` for the next page. */
-        nextCursor?: string;
-    };
-    /**
-     * Whether the repository has Discussions enabled at all. Omitted (not
-     * `false`) when the repo-level probe itself failed/was inconclusive — a
-     * `totalCount:0` response is otherwise ambiguous between "disabled" and
-     * "enabled, nothing posted yet", which this field disambiguates without a
-     * second call.
-     */
-    hasDiscussionsEnabled?: boolean;
-};
-type FetchDiscussionsParams = {
-    owner: string;
-    repo: string;
-    keywords?: string[];
-    perPage: number;
-    after?: string;
-};
-export declare function fetchDiscussions(params: FetchDiscussionsParams, authInfo?: AuthInfo, sessionId?: string): Promise<GitHubAPIResponse<DiscussionsResult>>;
-export {};

package/dist/github/releases.d.ts

@@ -1,45 +0,0 @@
-import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
-import type { GitHubAPIResponse } from './githubAPI.js';
-type ReleaseAsset = {
-    name: string;
-    size: number;
-    downloadCount: number;
-    url: string;
-};
-type ReleaseRow = {
-    tagName: string;
-    name?: string;
-    publishedAt?: string;
-    prerelease?: true;
-    draft?: true;
-    /** Marks the release GitHub reports as "latest" (stable, non-prerelease). */
-    latest?: true;
-    /** Downloadable assets (opt-in via includeAssets). */
-    assets?: ReleaseAsset[];
-};
-export type ReleasesResult = {
-    type: 'releases';
-    owner: string;
-    repo: string;
-    releases: ReleaseRow[];
-    /** The repo's latest stable release, surfaced even when it is not on this page. */
-    latest?: {
-        tagName: string;
-        publishedAt?: string;
-    };
-    pagination: {
-        currentPage: number;
-        perPage: number;
-        hasMore: boolean;
-        nextPage?: number;
-    };
-};
-type FetchReleasesParams = {
-    owner: string;
-    repo: string;
-    page: number;
-    perPage: number;
-    includeAssets?: boolean;
-};
-export declare function fetchReleases(params: FetchReleasesParams, authInfo?: AuthInfo, sessionId?: string): Promise<GitHubAPIResponse<ReleasesResult>>;
-export {};

package/dist/scheme/responseEnvelope.d.ts

@@ -1,88 +0,0 @@
-import { z } from 'zod';
-export declare const responseEnvelopeFields: {
-    readonly base: z.ZodOptional<z.ZodString>;
-    readonly shared: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
-    readonly responsePagination: z.ZodOptional<z.ZodObject<{
-        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>>;
-    readonly 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";
-            high: "high";
-            medium: "medium";
-            low: "low";
-        }>>;
-    }, z.core.$strip>>>;
-};
-export declare function withResponseEnvelope<S extends z.ZodObject>(schema: S): S;
-export declare function makeToolResultRowSchema<TData extends z.ZodTypeAny>(dataSchema: TData): z.ZodObject<{
-    id: z.ZodString;
-    status: z.ZodOptional<z.ZodEnum<{
-        empty: "empty";
-        error: "error";
-    }>>;
-    data: TData;
-    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";
-            high: "high";
-            medium: "medium";
-            low: "low";
-        }>>;
-    }, z.core.$strip>>>;
-}, z.core.$strip>;
-export declare const GenericToolResultRowSchema: z.ZodObject<{
-    id: z.ZodString;
-    status: z.ZodOptional<z.ZodEnum<{
-        empty: "empty";
-        error: "error";
-    }>>;
-    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    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";
-            high: "high";
-            medium: "medium";
-            low: "low";
-        }>>;
-    }, z.core.$strip>>>;
-}, z.core.$strip>;
-export declare const bulkOutputEnvelopeFields: {
-    readonly base: z.ZodOptional<z.ZodString>;
-    readonly shared: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
-    readonly responsePagination: z.ZodOptional<z.ZodObject<{
-        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>>;
-    readonly 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";
-            high: "high";
-            medium: "medium";
-            low: "low";
-        }>>;
-    }, z.core.$strip>>>;
-};

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

@@ -1,15 +0,0 @@
-import { type CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import type { ToolExecutionArgs } from '../../types/execution.js';
-type PartialDiscussionsQuery = {
-    owner?: string;
-    repo?: string;
-    keywordsToSearch?: string[];
-    itemsPerPage?: number;
-    limit?: number;
-    after?: string;
-    mainResearchGoal?: string;
-    researchGoal?: string;
-    reasoning?: string;
-};
-export declare function searchMultipleGitHubDiscussions(args: ToolExecutionArgs<PartialDiscussionsQuery>): Promise<CallToolResult>;
-export {};

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

@@ -1,16 +0,0 @@
-export declare const SearchDiscussionsLocalSchema: import("zod").ZodObject<{
-    owner: import("zod").ZodString;
-    repo: import("zod").ZodString;
-    keywordsToSearch: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    itemsPerPage: import("zod").ZodDefault<import("zod").ZodNumber>;
-    after: import("zod").ZodOptional<import("zod").ZodString>;
-    id: import("zod").ZodOptional<import("zod").ZodString>;
-    mainResearchGoal: import("zod").ZodOptional<import("zod").ZodString>;
-    researchGoal: import("zod").ZodOptional<import("zod").ZodString>;
-    reasoning: import("zod").ZodOptional<import("zod").ZodString>;
-}, import("zod/v4/core").$strip>;
-export declare const SearchDiscussionsBulkLocalSchema: 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>>>;
-}, import("zod/v4/core").$strip>;

package/dist/tools/github_search_pull_requests/execution/releasesMode.d.ts

@@ -1,4 +0,0 @@
-import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
-import type { ProcessedBulkResult } from '../../../types/toolResults.js';
-import type { GitHubPullRequestSearchInput, GitHubPullRequestSearchQuery } from './types.js';
-export declare function handleReleasesMode(query: GitHubPullRequestSearchInput, parsedData: GitHubPullRequestSearchQuery | undefined, authInfo: AuthInfo | undefined): Promise<ProcessedBulkResult>;

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

@@ -1,4 +0,0 @@
-import { type CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import { type FindDeadCodeQuery } from './scheme.js';
-import type { ToolExecutionArgs } from '../../types/execution.js';
-export declare function executeFindDeadCode(args: ToolExecutionArgs<FindDeadCodeQuery>): Promise<CallToolResult>;

package/dist/tools/local_dead_code/local_dead_code.d.ts

@@ -1,5 +0,0 @@
-import type { WithOptionalMeta } from '../../types/execution.js';
-import type { FindDeadCodeOutput, FindDeadCodeQuery as CoreFindDeadCodeQuery } from './scheme.js';
-type FindDeadCodeQuery = WithOptionalMeta<CoreFindDeadCodeQuery>;
-export declare function findDeadCode(query: FindDeadCodeQuery): Promise<FindDeadCodeOutput>;
-export {};

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

@@ -1,20 +0,0 @@
-import type { FileSystemQueryResult } from '../../utils/contextUtils.js';
-/**
- * Expand shell-style brace alternation (`{a,b,c}`) in a glob pattern into the
- * cartesian product of concrete patterns. The native glob compiler (a
- * hand-rolled glob-to-regex translator, see `octocode-engine`'s `fs_query.rs`)
- * has no brace support — a pattern like `packages/{react,react-reconciler}/**`
- * previously compiled to a regex that silently matched nothing, with no error.
- * Returns the input unchanged as a single-element array when it has no brace
- * groups, so patterns without braces see no behavior change.
- */
-export declare function expandBracePattern(pattern: string): string[];
-/**
- * Merge multiple native `queryFileSystem` results (one per expanded brace
- * alternative) into a single result shape, deduping entries that matched more
- * than one alternative. `totalDiscovered`/`skipped`/`permissionDenied` are
- * summed per-walk (not deduped) — each expanded pattern walks the tree
- * independently, so this is an upper bound on true unique discovery, not an
- * exact count; `wasCapped` is true if any alternative hit its cap.
- */
-export declare function mergeFileSystemQueryResults(results: readonly FileSystemQueryResult[]): FileSystemQueryResult;

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

@@ -1,7 +0,0 @@
-import type { ToolNames } from '@octocodeai/octocode-core/types';
-export interface ToolMetadataGateway {
-    hasTool(toolName: string): boolean;
-    getDescription(toolName: string): string;
-    getToolName<TKey extends keyof ToolNames>(key: TKey): ToolNames[TKey];
-}
-export declare const DEFAULT_TOOL_METADATA_GATEWAY: ToolMetadataGateway;