@zokizuan/satori-mcp 3.3.0 → 3.5.0

package/README.md

@@ -85,7 +85,7 @@ Unified semantic search with runtime/docs scope control, grouped/raw output mode
 
 ### `call_graph`
 
-Traverse the prebuilt TS/Python call graph sidecar for callers/callees/bidirectional symbol relationships.
+Traverse the prebuilt TS/JS/Python call graph sidecar for callers/callees/bidirectional symbol relationships.
 
 | Parameter | Type | Required | Default | Description |
 |---|---|---|---|---|

package/dist/core/call-graph.js

@@ -3,9 +3,10 @@ import * as os from 'node:os';
 import * as path from 'node:path';
 import crypto from 'node:crypto';
 import ignore from 'ignore';
-import { AstCodeSplitter } from '@zokizuan/satori-core';
-const SUPPORTED_SOURCE_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.py']);
-const QUERY_SUPPORTED_EXTENSIONS = new Set(['.ts', '.tsx', '.py']);
+import { AstCodeSplitter, getLanguageIdFromExtension, getSupportedExtensionsForCapability, getSupportedLanguageIdsForCapability, } from '@zokizuan/satori-core';
+const SUPPORTED_SOURCE_EXTENSIONS = new Set(getSupportedExtensionsForCapability('callGraphBuild'));
+const QUERY_SUPPORTED_EXTENSIONS = new Set(getSupportedExtensionsForCapability('callGraphQuery'));
+const QUERY_SUPPORTED_LANGUAGE_IDS = getSupportedLanguageIdsForCapability('callGraphQuery');
 const DEFAULT_IGNORE_PATTERNS = ['**/node_modules/**', '**/.git/**', '**/dist/**', '**/build/**', '**/coverage/**', '**/.next/**'];
 const CALL_KEYWORDS = new Set([
     'if', 'for', 'while', 'switch', 'catch', 'return', 'new', 'typeof', 'function', 'class', 'def', 'await', 'with', 'from', 'import',
@@ -478,11 +479,9 @@ export class CallGraphSidecarManager {
     }
     getSplitLanguage(relativePath) {
         const ext = path.extname(relativePath).toLowerCase();
-        if (ext === '.py') {
-            return 'python';
-        }
-        if (ext === '.ts' || ext === '.tsx' || ext === '.js' || ext === '.jsx' || ext === '.mjs' || ext === '.cjs') {
-            return ext === '.js' || ext === '.jsx' || ext === '.mjs' || ext === '.cjs' ? 'javascript' : 'typescript';
+        const language = getLanguageIdFromExtension(ext, 'unknown');
+        if (language === 'python' || language === 'typescript' || language === 'javascript') {
+            return language;
         }
         return 'unknown';
     }
@@ -495,8 +494,9 @@ export class CallGraphSidecarManager {
             supported: false,
             reason: 'unsupported_language',
             hints: {
-                supportedExtensions: ['.ts', '.tsx', '.py'],
-                message: 'call_graph currently supports TypeScript and Python symbols.',
+                supportedExtensions: Array.from(QUERY_SUPPORTED_EXTENSIONS).sort((a, b) => a.localeCompare(b)),
+                supportedLanguages: QUERY_SUPPORTED_LANGUAGE_IDS,
+                message: 'call_graph currently supports TypeScript, JavaScript, and Python symbols.',
             },
         };
     }

package/dist/core/handlers.d.ts

@@ -16,6 +16,9 @@ export declare class ToolHandlers {
     constructor(context: Context, snapshotManager: SnapshotManager, syncManager: SyncManager, runtimeFingerprint: IndexFingerprint, now?: () => number, callGraphManager?: CallGraphSidecarManager);
     private buildReindexInstruction;
     private buildReindexHint;
+    private summarizeFingerprint;
+    private buildCompatibilityDiagnostics;
+    private buildCompatibilityStatusLines;
     private buildRequiresReindexPayload;
     private buildRequiresReindexSearchResponse;
     private buildRequiresReindexCallGraphPayload;
@@ -199,7 +202,19 @@ export declare class ToolHandlers {
         }[];
         isError: boolean;
     }>;
-    handleGetIndexingStatus(args: any): Promise<any>;
+    handleGetIndexingStatus(args: any): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError?: undefined;
+    }>;
     /**
      * Handle sync request - manually trigger incremental sync for a codebase
      */

package/dist/core/handlers.js

@@ -2,7 +2,7 @@ import * as fs from "fs";
 import * as path from "path";
 import crypto from "node:crypto";
 import ignore from "ignore";
-import { COLLECTION_LIMIT_MESSAGE } from "@zokizuan/satori-core";
+import { COLLECTION_LIMIT_MESSAGE, getSupportedExtensionsForCapability, isLanguageCapabilitySupportedForExtension, isLanguageCapabilitySupportedForLanguage, } from "@zokizuan/satori-core";
 import { ensureAbsolutePath, truncateContent, trackCodebasePath } from "../utils.js";
 import { SEARCH_MAX_CANDIDATES, SEARCH_PROXIMITY_WINDOW, SEARCH_RRF_K, SCOPE_PATH_MULTIPLIERS, STALENESS_THRESHOLDS_MS } from "./search-constants.js";
 import { CallGraphSidecarManager } from "./call-graph.js";
@@ -14,6 +14,7 @@ const COLLECTION_LIMIT_PATTERNS = [
 ];
 const SATORI_COLLECTION_PREFIXES = ['code_chunks_', 'hybrid_code_chunks_'];
 const ZILLIZ_FREE_TIER_COLLECTION_LIMIT = 5;
+const OUTLINE_SUPPORTED_EXTENSIONS = getSupportedExtensionsForCapability('fileOutline');
 function collectErrorFragments(value, output, visited, depth = 0) {
     if (value === null || value === undefined || depth > 4 || output.length >= 8) {
         return;
@@ -119,6 +120,46 @@ export class ToolHandlers {
             }
         };
     }
+    summarizeFingerprint(fingerprint) {
+        return `${fingerprint.embeddingProvider}/${fingerprint.embeddingModel}/${fingerprint.embeddingDimension}/${fingerprint.vectorStoreProvider}/${fingerprint.schemaVersion}`;
+    }
+    buildCompatibilityDiagnostics(codebasePath) {
+        const info = typeof this.snapshotManager.getCodebaseInfo === 'function'
+            ? this.snapshotManager.getCodebaseInfo(codebasePath)
+            : undefined;
+        const statusAtCheck = info?.status
+            || (typeof this.snapshotManager.getCodebaseStatus === 'function'
+                ? this.snapshotManager.getCodebaseStatus(codebasePath)
+                : 'not_found');
+        const diagnostics = {
+            runtimeFingerprint: this.runtimeFingerprint,
+            statusAtCheck
+        };
+        if (info?.indexFingerprint) {
+            diagnostics.indexedFingerprint = info.indexFingerprint;
+        }
+        if (info?.fingerprintSource) {
+            diagnostics.fingerprintSource = info.fingerprintSource;
+        }
+        if (info?.reindexReason) {
+            diagnostics.reindexReason = info.reindexReason;
+        }
+        return diagnostics;
+    }
+    buildCompatibilityStatusLines(codebasePath) {
+        const diagnostics = this.buildCompatibilityDiagnostics(codebasePath);
+        let lines = `\n🧬 Runtime fingerprint: ${this.summarizeFingerprint(diagnostics.runtimeFingerprint)}`;
+        lines += diagnostics.indexedFingerprint
+            ? `\n🧬 Indexed fingerprint: ${this.summarizeFingerprint(diagnostics.indexedFingerprint)}`
+            : `\n🧬 Indexed fingerprint: unavailable`;
+        if (diagnostics.fingerprintSource) {
+            lines += `\n🧬 Fingerprint source: ${diagnostics.fingerprintSource}`;
+        }
+        if (diagnostics.reindexReason) {
+            lines += `\n🧬 Reindex reason: ${diagnostics.reindexReason}`;
+        }
+        return lines;
+    }
     buildRequiresReindexPayload(codebasePath, detail, searchContext) {
         const detailLine = detail ? `${detail}\n\n` : '';
         const base = searchContext ? {
@@ -140,7 +181,8 @@ export class ToolHandlers {
             message: `${detailLine}The index at '${codebasePath}' is incompatible with the current runtime and must be rebuilt. Please run manage_index with {\"action\":\"reindex\",\"path\":\"${codebasePath}\"}.`,
             hints: {
                 reindex: this.buildReindexHint(codebasePath)
-            }
+            },
+            compatibility: this.buildCompatibilityDiagnostics(codebasePath)
         };
     }
     buildRequiresReindexSearchResponse(codebasePath, detail, searchContext) {
@@ -172,7 +214,8 @@ export class ToolHandlers {
             message: `${detailLine}The index at '${codebasePath}' is incompatible with the current runtime and must be rebuilt. Please run manage_index with {"action":"reindex","path":"${codebasePath}"}.`,
             hints: {
                 reindex: this.buildReindexHint(codebasePath)
-            }
+            },
+            compatibility: this.buildCompatibilityDiagnostics(codebasePath)
         };
     }
     getMatchingBlockedRoot(absolutePath) {
@@ -431,13 +474,12 @@ export class ToolHandlers {
         return `grp_${digest}`;
     }
     isCallGraphLanguageSupported(language, file) {
-        const normalized = String(language || '').toLowerCase();
-        if (normalized === 'typescript' || normalized === 'ts' || normalized === 'python' || normalized === 'py') {
+        if (isLanguageCapabilitySupportedForLanguage(language, 'callGraphQuery')) {
             return true;
         }
         if (typeof file === 'string') {
             const ext = path.extname(file).toLowerCase();
-            return ext === '.ts' || ext === '.tsx' || ext === '.py';
+            return isLanguageCapabilitySupportedForExtension(ext, 'callGraphQuery');
         }
         return false;
     }
@@ -1763,7 +1805,7 @@ To force rebuild from scratch: call manage_index with {"action":"create","path":
                     file: normalizedFile,
                     outline: null,
                     hasMore: false,
-                    message: `File '${normalizedFile}' is not supported for sidecar outline. Supported extensions: .ts, .tsx, .py.`
+                    message: `File '${normalizedFile}' is not supported for sidecar outline. Supported extensions: ${OUTLINE_SUPPORTED_EXTENSIONS.join(', ')}.`
                 };
                 return {
                     content: [{ type: "text", text: JSON.stringify(payload, null, 2) }]
@@ -2131,7 +2173,17 @@ To force rebuild from scratch: call manage_index with {"action":"create","path":
             // Check indexing status using new status system
             const statusGate = this.enforceFingerprintGate(absolutePath);
             if (statusGate.blockedResponse) {
-                return statusGate.blockedResponse;
+                const statusMessage = this.buildReindexInstruction(absolutePath, statusGate.message);
+                const compatibilityStatus = this.buildCompatibilityStatusLines(absolutePath);
+                const pathInfo = codebasePath !== absolutePath
+                    ? `\nNote: Input path '${codebasePath}' was resolved to absolute path '${absolutePath}'`
+                    : '';
+                return {
+                    content: [{
+                            type: "text",
+                            text: statusMessage + compatibilityStatus + pathInfo
+                        }]
+                };
             }
             const status = this.snapshotManager.getCodebaseStatus(absolutePath);
             const info = this.snapshotManager.getCodebaseInfo(absolutePath);
@@ -2204,10 +2256,11 @@ To force rebuild from scratch: call manage_index with {"action":"create","path":
             const pathInfo = codebasePath !== absolutePath
                 ? `\nNote: Input path '${codebasePath}' was resolved to absolute path '${absolutePath}'`
                 : '';
+            const compatibilityStatus = this.buildCompatibilityStatusLines(absolutePath);
             return {
                 content: [{
                         type: "text",
-                        text: statusMessage + pathInfo
+                        text: statusMessage + compatibilityStatus + pathInfo
                     }]
             };
         }

package/dist/core/search-types.d.ts

@@ -1,5 +1,6 @@
 import { FreshnessDecision } from "./sync.js";
 import { SearchGroupBy, SearchResultMode, SearchScope } from "./search-constants.js";
+import { FingerprintSource, IndexFingerprint } from "../config.js";
 export type StalenessBucket = "fresh" | "aging" | "stale" | "unknown";
 export interface SearchSpan {
     startLine: number;
@@ -57,6 +58,13 @@ export interface SearchGroupResult {
         topChunkScore: number;
     };
 }
+export interface FingerprintCompatibilityDiagnostics {
+    runtimeFingerprint: IndexFingerprint;
+    indexedFingerprint?: IndexFingerprint;
+    fingerprintSource?: FingerprintSource;
+    reindexReason?: "legacy_unverified_fingerprint" | "fingerprint_mismatch" | "missing_fingerprint";
+    statusAtCheck?: "indexed" | "indexing" | "indexfailed" | "sync_completed" | "requires_reindex" | "not_found";
+}
 interface SearchBaseResponseEnvelope {
     status: "ok" | "requires_reindex" | "not_indexed";
     path: string;
@@ -70,6 +78,7 @@ interface SearchBaseResponseEnvelope {
     warnings?: string[];
     message?: string;
     hints?: Record<string, unknown>;
+    compatibility?: FingerprintCompatibilityDiagnostics;
 }
 export interface SearchGroupedResponseEnvelope extends SearchBaseResponseEnvelope {
     resultMode: "grouped";

package/dist/tools/call_graph.js

@@ -18,7 +18,7 @@ const callGraphInputSchema = z.object({
 });
 export const callGraphTool = {
     name: 'call_graph',
-    description: () => 'Traverse the prebuilt TS/Python call graph sidecar for callers/callees/bidirectional symbol relationships.',
+    description: () => 'Traverse the prebuilt TS/JS/Python call graph sidecar for callers/callees/bidirectional symbol relationships.',
     inputSchemaZod: () => callGraphInputSchema,
     execute: async (args, ctx) => {
         const normalizedArgs = (args && typeof args === 'object')

package/dist/tools/read_file.js

@@ -1,6 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import { z } from "zod";
+import { isLanguageCapabilitySupportedForExtension } from "@zokizuan/satori-core";
 import { formatZodError } from "./types.js";
 import { ensureAbsolutePath } from "../utils.js";
 const readFileInputSchema = z.object({
@@ -27,7 +28,7 @@ function normalizeRelativePath(value) {
 }
 function isOutlineSupportedFile(absolutePath) {
     const ext = path.extname(absolutePath).toLowerCase();
-    return ext === ".ts" || ext === ".tsx" || ext === ".py";
+    return isLanguageCapabilitySupportedForExtension(ext, "fileOutline");
 }
 function resolveCodebaseRootForFile(absolutePath, ctx) {
     const allCodebases = typeof ctx.snapshotManager?.getAllCodebases === "function"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zokizuan/satori-mcp",
-  "version": "3.3.0",
+  "version": "3.5.0",
   "description": "MCP server for Satori with agent-safe semantic search and indexing",
   "type": "module",
   "main": "dist/index.js",