claude-mem 3.0.2 → 3.0.4

package/dist/constants.d.ts

@@ -0,0 +1,516 @@
+/**
+ * Claude Memory System - Constants and Templates
+ *
+ * This file consolidates all prompts, instructions, and output templates
+ * used throughout the claude-mem system for better maintainability,
+ * DRYness, and easier auditing of LLM logic.
+ */
+/**
+ * Entity naming patterns for the knowledge graph
+ */
+export declare const ENTITY_NAMING_PATTERNS: {
+    readonly component: "Component_Name";
+    readonly decision: "Decision_Name";
+    readonly pattern: "Pattern_Name";
+    readonly tool: "Tool_Name";
+    readonly fix: "Fix_Name";
+    readonly workflow: "Workflow_Name";
+};
+/**
+ * Available entity types for classification
+ */
+export declare const ENTITY_TYPES: {
+    readonly component: "component";
+    readonly pattern: "pattern";
+    readonly workflow: "workflow";
+    readonly integration: "integration";
+    readonly concept: "concept";
+    readonly decision: "decision";
+    readonly tool: "tool";
+    readonly fix: "fix";
+};
+/**
+ * Standard observation fields for entities
+ */
+export declare const OBSERVATION_FIELDS: readonly ["Core purpose: [what it fundamentally does]", "Brief description: [one-line summary for session-start display]", "Implementation: [key technical details, code patterns]", "Dependencies: [what it requires or builds upon]", "Usage context: [when/why it's used]", "Performance characteristics: [speed, reliability, constraints]", "Integration points: [how it connects to other systems]", "Keywords: [searchable terms for this concept]", "Decision rationale: [why this approach was chosen]", "Next steps: [what needs to be done next with this component]", "Files modified: [list of files changed]", "Tools used: [development tools/commands used]"];
+/**
+ * Relationship types for creating meaningful entity connections
+ */
+export declare const RELATIONSHIP_TYPES: readonly ["executes_via", "orchestrates_through", "validates_using", "provides_auth_to", "manages_state_for", "processes_events_from", "caches_data_from", "routes_requests_to", "transforms_data_for", "extends", "enhances_performance_of", "builds_upon", "fixes_issue_in", "replaces", "optimizes", "uses_tool_chain", "triggers_tool", "receives_result_from"];
+/**
+ * Creates the main analysis prompt for transcript compression
+ */
+export declare function createAnalysisPrompt(projectName: string, sessionId: string, hasCompressedContent: boolean, existingMemoriesText: string, toolUseChains: Array<{
+    id: string;
+    tools: string[];
+}>): string;
+/**
+ * System message templates for context priming
+ */
+export declare const CONTEXT_TEMPLATES: {
+    readonly PRIMARY_CONTEXT: (projectName: string) => string;
+    readonly RECENT_SESSIONS: (sessionList: string) => string;
+    readonly AVAILABLE_ENTITIES: (type: string, entities: string[], hasMore: boolean, moreCount: number) => string;
+    readonly SESSION_START_HEADER: "🧠 Active Working Context from Previous Sessions:";
+    readonly SESSION_START_SEPARATOR: string;
+    readonly RESUME_INSTRUCTIONS: "💡 TO RESUME: Load active components with open_nodes([\"<exact_names>\"])\n📊 TO EXPLORE: Search related work with search_nodes(\"<keywords>\")";
+};
+/**
+ * Session start formatting templates
+ */
+export declare const SESSION_START_TEMPLATES: {
+    readonly FOCUS_LINE: (focus: string) => string;
+    readonly LAST_WORKED: (timeAgo: string, projectName: string) => string;
+    readonly SECTIONS: {
+        readonly COMPONENTS: "🎯 ACTIVE COMPONENTS (load these for context):";
+        readonly DECISIONS: "🔄 RECENT DECISIONS & PATTERNS:";
+        readonly TOOLS: "🛠️ TOOLS & INFRASTRUCTURE:";
+        readonly FIXES: "🐛 RECENT FIXES:";
+        readonly ACTIONS: "⚡ NEXT ACTIONS:";
+    };
+    readonly ACTION_PREFIX: "□ ";
+    readonly ENTITY_BULLET: "• ";
+};
+/**
+ * Time formatting for "time ago" displays
+ */
+export declare const TIME_FORMATS: {
+    readonly JUST_NOW: "just now";
+    readonly HOURS_AGO: (hours: number) => string;
+    readonly DAYS_AGO: (days: number) => string;
+    readonly RECENTLY: "recently";
+};
+/**
+ * Standard hook response structures for Claude Code integration
+ */
+export declare const HOOK_RESPONSES: {
+    readonly SUCCESS: (hookEventName: string, message: string) => {
+        hookSpecificOutput: {
+            hookEventName: string;
+            status: string;
+            message: string;
+        };
+        suppressOutput: boolean;
+    };
+    readonly SKIPPED: (hookEventName: string, message: string) => {
+        hookSpecificOutput: {
+            hookEventName: string;
+            status: string;
+            message: string;
+        };
+        suppressOutput: boolean;
+    };
+    readonly BLOCKED: (reason: string) => {
+        decision: string;
+        reason: string;
+    };
+    readonly CONTINUE: (hookEventName: string, additionalContext?: string) => {
+        hookSpecificOutput?: {
+            hookEventName: string;
+            additionalContext: string;
+        } | undefined;
+        continue: boolean;
+    };
+    readonly ERROR: (reason: string) => {
+        decision: string;
+        reason: string;
+    };
+};
+/**
+ * Pre-defined hook messages
+ */
+export declare const HOOK_MESSAGES: {
+    readonly COMPRESSION_SUCCESS: "Memory compression completed successfully";
+    readonly COMPRESSION_SKIPPED: "Compression skipped - Claude SDK not available in this context";
+    readonly COMPRESSION_FAILED: (stderr: string) => string;
+    readonly CONTEXT_LOADED: "Project context loaded successfully";
+    readonly CONTEXT_SKIPPED: "Continuing session - context loading skipped";
+    readonly NO_TRANSCRIPT: "No transcript path provided";
+    readonly HOOK_ERROR: (error: string) => string;
+};
+/**
+ * MCP server configuration template
+ */
+export declare const MCP_CONFIG_TEMPLATE: {
+    readonly "claude-mem": {
+        readonly command: "npx";
+        readonly args: readonly ["-y", "@modelcontextprotocol/server-memory"];
+    };
+};
+/**
+ * Hook configuration templates for Claude settings
+ */
+export declare const HOOK_CONFIG_TEMPLATES: {
+    readonly PRE_COMPACT: (scriptPath: string) => {
+        pattern: string;
+        hooks: {
+            type: string;
+            command: string;
+            timeout: number;
+        }[];
+    };
+    readonly SESSION_START: (scriptPath: string) => {
+        pattern: string;
+        hooks: {
+            type: string;
+            command: string;
+            timeout: number;
+        }[];
+    };
+    readonly SESSION_END: (scriptPath: string) => {
+        pattern: string;
+        hooks: {
+            type: string;
+            command: string;
+            timeout: number;
+        }[];
+    };
+};
+/**
+ * Command-line interface messages
+ */
+export declare const CLI_MESSAGES: {
+    readonly INSTALLATION: {
+        readonly STARTING: "🚀 Installing Claude Memory System with embedded Weaviate...";
+        readonly SUCCESS: "🎉 Installation complete! Embedded vector database ready.";
+        readonly HOOKS_INSTALLED: "✅ Installed hooks to ~/.claude-mem/hooks/";
+        readonly MCP_CONFIGURED: (path: string) => string;
+        readonly EMBEDDED_READY: "🧠 Embedded Weaviate initialized for persistent semantic memory";
+        readonly ALREADY_INSTALLED: "⚠️  Claude Memory hooks are already installed.";
+        readonly USE_FORCE: "   Use --force to overwrite existing installation.";
+        readonly SETTINGS_WRITTEN: (type: string, path: string) => string;
+    };
+    readonly NEXT_STEPS: readonly ["1. Restart Claude Code to load the new hooks", "2. Use `/clear` and `/compact` in Claude Code to save and compress session memories", "3. New sessions will automatically load relevant context"];
+    readonly ERRORS: {
+        readonly HOOKS_NOT_FOUND: "❌ Hook source files not found";
+        readonly SETTINGS_WRITE_FAILED: (path: string, error: string) => string;
+        readonly MCP_CONFIG_PARSE_FAILED: (error: string) => string;
+        readonly MCP_CONFIG_WRITE_FAILED: (error: string) => string;
+        readonly COMPRESSION_FAILED: (error: string) => string;
+        readonly CONTEXT_LOAD_FAILED: (error: string) => string;
+    };
+    readonly STATUS: {
+        readonly NO_INDEX: "📚 No memory index found. Starting fresh session.";
+        readonly NO_MATCHES: "📚 No matching memories found in index.";
+        readonly RECENT_MEMORIES: "🧠 Recent memories from previous sessions:";
+        readonly MEMORY_COUNT: (count: number) => string;
+        readonly FULL_CONTEXT_AVAILABLE: "💡 Full context available via MCP memory tools";
+    };
+};
+/**
+ * Debug logging message templates
+ */
+export declare const DEBUG_MESSAGES: {
+    readonly COMPRESSION_STARTED: "🚀 COMPRESSION STARTED";
+    readonly TRANSCRIPT_PATH: (path: string) => string;
+    readonly SESSION_ID: (id: string) => string;
+    readonly PROJECT_NAME: (name: string) => string;
+    readonly CLAUDE_SDK_CALL: "🤖 Calling Claude SDK to analyze and populate knowledge graph...";
+    readonly TRANSCRIPT_STATS: (size: number, count: number) => string;
+    readonly COMPRESSION_COMPLETE: (count: number) => string;
+    readonly CLAUDE_PATH_FOUND: (path: string) => string;
+    readonly MCP_CONFIG_USED: (path: string) => string;
+};
+/**
+ * Knowledge graph search templates
+ */
+export declare const SEARCH_TEMPLATES: {
+    readonly SEARCH_SCRIPT: (query: string) => string;
+    readonly SEARCH_PREFIX: "Search for: ";
+};
+/**
+ * Weaviate MCP server configuration template
+ */
+export declare const WEAVIATE_MCP_CONFIG: {
+    readonly "claude-mem": {
+        readonly command: "C:\\path\\to\\mcp-server.exe" | "/usr/local/bin/mcp-server-weaviate";
+    };
+};
+/**
+ * Weaviate collection names for entities and relations
+ */
+export declare const WEAVIATE_COLLECTIONS: {
+    readonly ENTITIES: "claude_mem_entities";
+    readonly RELATIONS: "claude_mem_relations";
+};
+/**
+ * Default Weaviate configuration values
+ */
+export declare const WEAVIATE_DEFAULTS: {
+    readonly HOST: "localhost:8080";
+    readonly SCHEME: "http";
+    readonly MCP_PATH: "/usr/local/bin/mcp-server-weaviate";
+};
+/**
+ * Weaviate-specific CLI messages
+ */
+export declare const WEAVIATE_MESSAGES: {
+    readonly CONNECTION: {
+        readonly CONNECTING: "🔗 Connecting to Weaviate server...";
+        readonly CONNECTED: "✅ Connected to Weaviate successfully";
+        readonly FAILED: (error: string) => string;
+        readonly DISCONNECTED: "👋 Disconnected from Weaviate";
+    };
+    readonly MIGRATION: {
+        readonly STARTING: "🚀 Starting migration to Weaviate backend...";
+        readonly READING_INDEX: "📖 Reading existing memory index files...";
+        readonly MIGRATING_ENTITIES: (count: number) => string;
+        readonly MIGRATING_RELATIONS: (count: number) => string;
+        readonly UPDATING_SETTINGS: "⚙️  Updating settings to use Weaviate backend...";
+        readonly COMPLETED: "✅ Migration to Weaviate completed successfully";
+        readonly FAILED: (error: string) => string;
+        readonly NO_DATA: "💡 No existing data found to migrate";
+    };
+    readonly SEARCH: {
+        readonly SEMANTIC_SEARCH: "🧠 Using semantic search with Weaviate...";
+        readonly KEYWORD_SEARCH: "🔍 Using keyword search with Weaviate...";
+        readonly HYBRID_SEARCH: "🔬 Using hybrid search with Weaviate...";
+        readonly NO_RESULTS: "📚 No results found in Weaviate database";
+        readonly RESULTS_FOUND: (count: number) => string;
+    };
+    readonly SETUP: {
+        readonly STARTING_EMBEDDED: "🚀 Starting embedded Weaviate instance...";
+        readonly EMBEDDED_READY: "✅ Embedded Weaviate is ready and accepting connections";
+        readonly DOWNLOADING_BINARIES: "⬇️ Downloading Weaviate binaries (first time only)...";
+        readonly INITIALIZING_SCHEMA: "📋 Initializing knowledge graph schema...";
+    };
+};
+/**
+ * Weaviate error messages
+ */
+export declare const WEAVIATE_ERRORS: {
+    readonly CONNECTION_FAILED: "Could not establish connection to Weaviate server";
+    readonly MCP_SERVER_NOT_FOUND: "Weaviate MCP server binary not found at specified path";
+    readonly INVALID_COLLECTION: (collection: string) => string;
+    readonly QUERY_FAILED: (query: string, error: string) => string;
+    readonly ENTITY_CREATION_FAILED: (name: string) => string;
+    readonly RELATION_CREATION_FAILED: (from: string, to: string) => string;
+    readonly MIGRATION_INCOMPLETE: "Migration was incomplete - some data may not have been transferred";
+    readonly EMBEDDED_START_FAILED: "Failed to start embedded Weaviate instance - check disk space and permissions";
+    readonly SCHEMA_MISMATCH: "Weaviate schema does not match expected structure";
+};
+/**
+ * Export all constants for easy importing
+ */
+export declare const CONSTANTS: {
+    readonly ENTITY_NAMING_PATTERNS: {
+        readonly component: "Component_Name";
+        readonly decision: "Decision_Name";
+        readonly pattern: "Pattern_Name";
+        readonly tool: "Tool_Name";
+        readonly fix: "Fix_Name";
+        readonly workflow: "Workflow_Name";
+    };
+    readonly ENTITY_TYPES: {
+        readonly component: "component";
+        readonly pattern: "pattern";
+        readonly workflow: "workflow";
+        readonly integration: "integration";
+        readonly concept: "concept";
+        readonly decision: "decision";
+        readonly tool: "tool";
+        readonly fix: "fix";
+    };
+    readonly OBSERVATION_FIELDS: readonly ["Core purpose: [what it fundamentally does]", "Brief description: [one-line summary for session-start display]", "Implementation: [key technical details, code patterns]", "Dependencies: [what it requires or builds upon]", "Usage context: [when/why it's used]", "Performance characteristics: [speed, reliability, constraints]", "Integration points: [how it connects to other systems]", "Keywords: [searchable terms for this concept]", "Decision rationale: [why this approach was chosen]", "Next steps: [what needs to be done next with this component]", "Files modified: [list of files changed]", "Tools used: [development tools/commands used]"];
+    readonly RELATIONSHIP_TYPES: readonly ["executes_via", "orchestrates_through", "validates_using", "provides_auth_to", "manages_state_for", "processes_events_from", "caches_data_from", "routes_requests_to", "transforms_data_for", "extends", "enhances_performance_of", "builds_upon", "fixes_issue_in", "replaces", "optimizes", "uses_tool_chain", "triggers_tool", "receives_result_from"];
+    readonly CONTEXT_TEMPLATES: {
+        readonly PRIMARY_CONTEXT: (projectName: string) => string;
+        readonly RECENT_SESSIONS: (sessionList: string) => string;
+        readonly AVAILABLE_ENTITIES: (type: string, entities: string[], hasMore: boolean, moreCount: number) => string;
+        readonly SESSION_START_HEADER: "🧠 Active Working Context from Previous Sessions:";
+        readonly SESSION_START_SEPARATOR: string;
+        readonly RESUME_INSTRUCTIONS: "💡 TO RESUME: Load active components with open_nodes([\"<exact_names>\"])\n📊 TO EXPLORE: Search related work with search_nodes(\"<keywords>\")";
+    };
+    readonly SESSION_START_TEMPLATES: {
+        readonly FOCUS_LINE: (focus: string) => string;
+        readonly LAST_WORKED: (timeAgo: string, projectName: string) => string;
+        readonly SECTIONS: {
+            readonly COMPONENTS: "🎯 ACTIVE COMPONENTS (load these for context):";
+            readonly DECISIONS: "🔄 RECENT DECISIONS & PATTERNS:";
+            readonly TOOLS: "🛠️ TOOLS & INFRASTRUCTURE:";
+            readonly FIXES: "🐛 RECENT FIXES:";
+            readonly ACTIONS: "⚡ NEXT ACTIONS:";
+        };
+        readonly ACTION_PREFIX: "□ ";
+        readonly ENTITY_BULLET: "• ";
+    };
+    readonly TIME_FORMATS: {
+        readonly JUST_NOW: "just now";
+        readonly HOURS_AGO: (hours: number) => string;
+        readonly DAYS_AGO: (days: number) => string;
+        readonly RECENTLY: "recently";
+    };
+    readonly HOOK_RESPONSES: {
+        readonly SUCCESS: (hookEventName: string, message: string) => {
+            hookSpecificOutput: {
+                hookEventName: string;
+                status: string;
+                message: string;
+            };
+            suppressOutput: boolean;
+        };
+        readonly SKIPPED: (hookEventName: string, message: string) => {
+            hookSpecificOutput: {
+                hookEventName: string;
+                status: string;
+                message: string;
+            };
+            suppressOutput: boolean;
+        };
+        readonly BLOCKED: (reason: string) => {
+            decision: string;
+            reason: string;
+        };
+        readonly CONTINUE: (hookEventName: string, additionalContext?: string) => {
+            hookSpecificOutput?: {
+                hookEventName: string;
+                additionalContext: string;
+            } | undefined;
+            continue: boolean;
+        };
+        readonly ERROR: (reason: string) => {
+            decision: string;
+            reason: string;
+        };
+    };
+    readonly HOOK_MESSAGES: {
+        readonly COMPRESSION_SUCCESS: "Memory compression completed successfully";
+        readonly COMPRESSION_SKIPPED: "Compression skipped - Claude SDK not available in this context";
+        readonly COMPRESSION_FAILED: (stderr: string) => string;
+        readonly CONTEXT_LOADED: "Project context loaded successfully";
+        readonly CONTEXT_SKIPPED: "Continuing session - context loading skipped";
+        readonly NO_TRANSCRIPT: "No transcript path provided";
+        readonly HOOK_ERROR: (error: string) => string;
+    };
+    readonly MCP_CONFIG_TEMPLATE: {
+        readonly "claude-mem": {
+            readonly command: "npx";
+            readonly args: readonly ["-y", "@modelcontextprotocol/server-memory"];
+        };
+    };
+    readonly HOOK_CONFIG_TEMPLATES: {
+        readonly PRE_COMPACT: (scriptPath: string) => {
+            pattern: string;
+            hooks: {
+                type: string;
+                command: string;
+                timeout: number;
+            }[];
+        };
+        readonly SESSION_START: (scriptPath: string) => {
+            pattern: string;
+            hooks: {
+                type: string;
+                command: string;
+                timeout: number;
+            }[];
+        };
+        readonly SESSION_END: (scriptPath: string) => {
+            pattern: string;
+            hooks: {
+                type: string;
+                command: string;
+                timeout: number;
+            }[];
+        };
+    };
+    readonly CLI_MESSAGES: {
+        readonly INSTALLATION: {
+            readonly STARTING: "🚀 Installing Claude Memory System with embedded Weaviate...";
+            readonly SUCCESS: "🎉 Installation complete! Embedded vector database ready.";
+            readonly HOOKS_INSTALLED: "✅ Installed hooks to ~/.claude-mem/hooks/";
+            readonly MCP_CONFIGURED: (path: string) => string;
+            readonly EMBEDDED_READY: "🧠 Embedded Weaviate initialized for persistent semantic memory";
+            readonly ALREADY_INSTALLED: "⚠️  Claude Memory hooks are already installed.";
+            readonly USE_FORCE: "   Use --force to overwrite existing installation.";
+            readonly SETTINGS_WRITTEN: (type: string, path: string) => string;
+        };
+        readonly NEXT_STEPS: readonly ["1. Restart Claude Code to load the new hooks", "2. Use `/clear` and `/compact` in Claude Code to save and compress session memories", "3. New sessions will automatically load relevant context"];
+        readonly ERRORS: {
+            readonly HOOKS_NOT_FOUND: "❌ Hook source files not found";
+            readonly SETTINGS_WRITE_FAILED: (path: string, error: string) => string;
+            readonly MCP_CONFIG_PARSE_FAILED: (error: string) => string;
+            readonly MCP_CONFIG_WRITE_FAILED: (error: string) => string;
+            readonly COMPRESSION_FAILED: (error: string) => string;
+            readonly CONTEXT_LOAD_FAILED: (error: string) => string;
+        };
+        readonly STATUS: {
+            readonly NO_INDEX: "📚 No memory index found. Starting fresh session.";
+            readonly NO_MATCHES: "📚 No matching memories found in index.";
+            readonly RECENT_MEMORIES: "🧠 Recent memories from previous sessions:";
+            readonly MEMORY_COUNT: (count: number) => string;
+            readonly FULL_CONTEXT_AVAILABLE: "💡 Full context available via MCP memory tools";
+        };
+    };
+    readonly DEBUG_MESSAGES: {
+        readonly COMPRESSION_STARTED: "🚀 COMPRESSION STARTED";
+        readonly TRANSCRIPT_PATH: (path: string) => string;
+        readonly SESSION_ID: (id: string) => string;
+        readonly PROJECT_NAME: (name: string) => string;
+        readonly CLAUDE_SDK_CALL: "🤖 Calling Claude SDK to analyze and populate knowledge graph...";
+        readonly TRANSCRIPT_STATS: (size: number, count: number) => string;
+        readonly COMPRESSION_COMPLETE: (count: number) => string;
+        readonly CLAUDE_PATH_FOUND: (path: string) => string;
+        readonly MCP_CONFIG_USED: (path: string) => string;
+    };
+    readonly SEARCH_TEMPLATES: {
+        readonly SEARCH_SCRIPT: (query: string) => string;
+        readonly SEARCH_PREFIX: "Search for: ";
+    };
+    readonly WEAVIATE_MCP_CONFIG: {
+        readonly "claude-mem": {
+            readonly command: "C:\\path\\to\\mcp-server.exe" | "/usr/local/bin/mcp-server-weaviate";
+        };
+    };
+    readonly WEAVIATE_COLLECTIONS: {
+        readonly ENTITIES: "claude_mem_entities";
+        readonly RELATIONS: "claude_mem_relations";
+    };
+    readonly WEAVIATE_DEFAULTS: {
+        readonly HOST: "localhost:8080";
+        readonly SCHEME: "http";
+        readonly MCP_PATH: "/usr/local/bin/mcp-server-weaviate";
+    };
+    readonly WEAVIATE_MESSAGES: {
+        readonly CONNECTION: {
+            readonly CONNECTING: "🔗 Connecting to Weaviate server...";
+            readonly CONNECTED: "✅ Connected to Weaviate successfully";
+            readonly FAILED: (error: string) => string;
+            readonly DISCONNECTED: "👋 Disconnected from Weaviate";
+        };
+        readonly MIGRATION: {
+            readonly STARTING: "🚀 Starting migration to Weaviate backend...";
+            readonly READING_INDEX: "📖 Reading existing memory index files...";
+            readonly MIGRATING_ENTITIES: (count: number) => string;
+            readonly MIGRATING_RELATIONS: (count: number) => string;
+            readonly UPDATING_SETTINGS: "⚙️  Updating settings to use Weaviate backend...";
+            readonly COMPLETED: "✅ Migration to Weaviate completed successfully";
+            readonly FAILED: (error: string) => string;
+            readonly NO_DATA: "💡 No existing data found to migrate";
+        };
+        readonly SEARCH: {
+            readonly SEMANTIC_SEARCH: "🧠 Using semantic search with Weaviate...";
+            readonly KEYWORD_SEARCH: "🔍 Using keyword search with Weaviate...";
+            readonly HYBRID_SEARCH: "🔬 Using hybrid search with Weaviate...";
+            readonly NO_RESULTS: "📚 No results found in Weaviate database";
+            readonly RESULTS_FOUND: (count: number) => string;
+        };
+        readonly SETUP: {
+            readonly STARTING_EMBEDDED: "🚀 Starting embedded Weaviate instance...";
+            readonly EMBEDDED_READY: "✅ Embedded Weaviate is ready and accepting connections";
+            readonly DOWNLOADING_BINARIES: "⬇️ Downloading Weaviate binaries (first time only)...";
+            readonly INITIALIZING_SCHEMA: "📋 Initializing knowledge graph schema...";
+        };
+    };
+    readonly WEAVIATE_ERRORS: {
+        readonly CONNECTION_FAILED: "Could not establish connection to Weaviate server";
+        readonly MCP_SERVER_NOT_FOUND: "Weaviate MCP server binary not found at specified path";
+        readonly INVALID_COLLECTION: (collection: string) => string;
+        readonly QUERY_FAILED: (query: string, error: string) => string;
+        readonly ENTITY_CREATION_FAILED: (name: string) => string;
+        readonly RELATION_CREATION_FAILED: (from: string, to: string) => string;
+        readonly MIGRATION_INCOMPLETE: "Migration was incomplete - some data may not have been transferred";
+        readonly EMBEDDED_START_FAILED: "Failed to start embedded Weaviate instance - check disk space and permissions";
+        readonly SCHEMA_MISMATCH: "Weaviate schema does not match expected structure";
+    };
+};