praisonAI 2.3.53__tar.gz → 2.3.55__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (110) hide show
  1. {praisonai-2.3.53 → praisonai-2.3.55}/PKG-INFO +1 -1
  2. {praisonai-2.3.53 → praisonai-2.3.55}/PraisonAI.egg-info/PKG-INFO +1 -1
  3. {praisonai-2.3.53 → praisonai-2.3.55}/PraisonAI.egg-info/SOURCES.txt +2 -0
  4. praisonai-2.3.55/praisonai/__init__.py +34 -0
  5. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/__init__.py +9 -2
  6. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/__init__.py +15 -0
  7. praisonai-2.3.55/praisonai/cli/features/at_mentions.py +416 -0
  8. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/main.py +123 -69
  9. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/deploy.py +1 -1
  10. praisonai-2.3.55/praisonai/profiler.py +465 -0
  11. praisonai-2.3.55/praisonai/version.py +1 -0
  12. praisonai-2.3.53/praisonai/__init__.py +0 -35
  13. praisonai-2.3.53/praisonai/version.py +0 -1
  14. {praisonai-2.3.53 → praisonai-2.3.55}/PraisonAI.egg-info/dependency_links.txt +0 -0
  15. {praisonai-2.3.53 → praisonai-2.3.55}/PraisonAI.egg-info/entry_points.txt +0 -0
  16. {praisonai-2.3.53 → praisonai-2.3.55}/PraisonAI.egg-info/requires.txt +0 -0
  17. {praisonai-2.3.53 → praisonai-2.3.55}/PraisonAI.egg-info/top_level.txt +0 -0
  18. {praisonai-2.3.53 → praisonai-2.3.55}/README.md +0 -0
  19. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/__main__.py +0 -0
  20. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/agents_generator.py +0 -0
  21. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/api/call.py +0 -0
  22. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/auto.py +0 -0
  23. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/chainlit_ui.py +0 -0
  24. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/auto_memory.py +0 -0
  25. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/autonomy_mode.py +0 -0
  26. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/base.py +0 -0
  27. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/cost_tracker.py +0 -0
  28. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/external_agents.py +0 -0
  29. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/fast_context.py +0 -0
  30. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/flow_display.py +0 -0
  31. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/git_integration.py +0 -0
  32. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/guardrail.py +0 -0
  33. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/handoff.py +0 -0
  34. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/image.py +0 -0
  35. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/interactive_tui.py +0 -0
  36. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/knowledge.py +0 -0
  37. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/mcp.py +0 -0
  38. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/message_queue.py +0 -0
  39. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/metrics.py +0 -0
  40. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/n8n.py +0 -0
  41. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/repo_map.py +0 -0
  42. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/router.py +0 -0
  43. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/sandbox_executor.py +0 -0
  44. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/session.py +0 -0
  45. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/slash_commands.py +0 -0
  46. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/telemetry.py +0 -0
  47. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/todo.py +0 -0
  48. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/tools.py +0 -0
  49. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/cli/features/workflow.py +0 -0
  50. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/code/__init__.py +0 -0
  51. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/code/agent_tools.py +0 -0
  52. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/code/diff/__init__.py +0 -0
  53. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/code/diff/diff_strategy.py +0 -0
  54. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/code/tools/__init__.py +0 -0
  55. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/code/tools/apply_diff.py +0 -0
  56. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/code/tools/execute_command.py +0 -0
  57. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/code/tools/list_files.py +0 -0
  58. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/code/tools/read_file.py +0 -0
  59. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/code/tools/search_replace.py +0 -0
  60. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/code/tools/write_file.py +0 -0
  61. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/code/utils/__init__.py +0 -0
  62. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/code/utils/file_utils.py +0 -0
  63. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/code/utils/ignore_utils.py +0 -0
  64. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/code/utils/text_utils.py +0 -0
  65. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/inbuilt_tools/__init__.py +0 -0
  66. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/inbuilt_tools/autogen_tools.py +0 -0
  67. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/inc/__init__.py +0 -0
  68. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/inc/config.py +0 -0
  69. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/inc/models.py +0 -0
  70. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/integrations/__init__.py +0 -0
  71. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/integrations/base.py +0 -0
  72. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/integrations/claude_code.py +0 -0
  73. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/integrations/codex_cli.py +0 -0
  74. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/integrations/cursor_cli.py +0 -0
  75. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/integrations/gemini_cli.py +0 -0
  76. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/scheduler.py +0 -0
  77. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/setup/__init__.py +0 -0
  78. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/setup/build.py +0 -0
  79. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/setup/post_install.py +0 -0
  80. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/setup/setup_conda_env.py +0 -0
  81. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/setup.py +0 -0
  82. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/test.py +0 -0
  83. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/train.py +0 -0
  84. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/train_vision.py +0 -0
  85. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/ui/agents.py +0 -0
  86. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/ui/callbacks.py +0 -0
  87. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/ui/chat.py +0 -0
  88. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/ui/code.py +0 -0
  89. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/ui/colab.py +0 -0
  90. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/ui/colab_chainlit.py +0 -0
  91. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/ui/components/aicoder.py +0 -0
  92. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/ui/context.py +0 -0
  93. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/ui/database_config.py +0 -0
  94. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/ui/db.py +0 -0
  95. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/ui/realtime.py +0 -0
  96. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/ui/realtimeclient/__init__.py +0 -0
  97. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/ui/realtimeclient/tools.py +0 -0
  98. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/ui/sql_alchemy.py +0 -0
  99. {praisonai-2.3.53 → praisonai-2.3.55}/praisonai/upload_vision.py +0 -0
  100. {praisonai-2.3.53 → praisonai-2.3.55}/pyproject.toml +0 -0
  101. {praisonai-2.3.53 → praisonai-2.3.55}/setup.cfg +0 -0
  102. {praisonai-2.3.53 → praisonai-2.3.55}/tests/test.py +0 -0
  103. {praisonai-2.3.53 → praisonai-2.3.55}/tests/test_agents_playbook.py +0 -0
  104. {praisonai-2.3.53 → praisonai-2.3.55}/tests/test_basic.py +0 -0
  105. {praisonai-2.3.53 → praisonai-2.3.55}/tests/test_cli_features.py +0 -0
  106. {praisonai-2.3.53 → praisonai-2.3.55}/tests/test_custom_tools_fix.py +0 -0
  107. {praisonai-2.3.53 → praisonai-2.3.55}/tests/test_double_api_fix.py +0 -0
  108. {praisonai-2.3.53 → praisonai-2.3.55}/tests/test_n8n_integration.py +0 -0
  109. {praisonai-2.3.53 → praisonai-2.3.55}/tests/test_phase2_refactor.py +0 -0
  110. {praisonai-2.3.53 → praisonai-2.3.55}/tests/test_runner.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: PraisonAI
3
- Version: 2.3.53
3
+ Version: 2.3.55
4
4
  Summary: PraisonAI is an AI Agents Framework with Self Reflection. PraisonAI application combines PraisonAI Agents, AutoGen, and CrewAI into a low-code solution for building and managing multi-agent LLM systems, focusing on simplicity, customisation, and efficient human-agent collaboration.
5
5
  Author: Mervin Praison
6
6
  License: MIT
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: PraisonAI
3
- Version: 2.3.53
3
+ Version: 2.3.55
4
4
  Summary: PraisonAI is an AI Agents Framework with Self Reflection. PraisonAI application combines PraisonAI Agents, AutoGen, and CrewAI into a low-code solution for building and managing multi-agent LLM systems, focusing on simplicity, customisation, and efficient human-agent collaboration.
5
5
  Author: Mervin Praison
6
6
  License: MIT
@@ -12,6 +12,7 @@ praisonai/agents_generator.py
12
12
  praisonai/auto.py
13
13
  praisonai/chainlit_ui.py
14
14
  praisonai/deploy.py
15
+ praisonai/profiler.py
15
16
  praisonai/scheduler.py
16
17
  praisonai/setup.py
17
18
  praisonai/test.py
@@ -23,6 +24,7 @@ praisonai/api/call.py
23
24
  praisonai/cli/__init__.py
24
25
  praisonai/cli/main.py
25
26
  praisonai/cli/features/__init__.py
27
+ praisonai/cli/features/at_mentions.py
26
28
  praisonai/cli/features/auto_memory.py
27
29
  praisonai/cli/features/autonomy_mode.py
28
30
  praisonai/cli/features/base.py
@@ -0,0 +1,34 @@
1
+ # Suppress crewai.cli.config logger BEFORE any imports to prevent INFO log
2
+ import logging
3
+ logging.getLogger('crewai.cli.config').setLevel(logging.ERROR)
4
+
5
+ # Disable OpenTelemetry SDK
6
+ import os
7
+ os.environ["OTEL_SDK_DISABLED"] = "true"
8
+ os.environ["EC_TELEMETRY"] = "false"
9
+
10
+ # Version is lightweight, import directly
11
+ from .version import __version__
12
+
13
+ # Define __all__ for lazy loading
14
+ __all__ = [
15
+ 'PraisonAI',
16
+ '__version__',
17
+ ]
18
+
19
+ # Lazy loading for heavy imports
20
+ def __getattr__(name):
21
+ """Lazy load heavy modules to improve import time."""
22
+ if name == 'PraisonAI':
23
+ from .cli import PraisonAI
24
+ return PraisonAI
25
+
26
+ # Try praisonaiagents exports
27
+ try:
28
+ import praisonaiagents
29
+ if hasattr(praisonaiagents, name):
30
+ return getattr(praisonaiagents, name)
31
+ except ImportError:
32
+ pass
33
+
34
+ raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
@@ -8,12 +8,19 @@ Structure:
8
8
  - features/: Feature handlers for CLI flags and commands
9
9
  """
10
10
 
11
- from .main import PraisonAI
12
-
13
11
  __all__ = ["PraisonAI"]
14
12
 
15
13
 
14
+ def __getattr__(name):
15
+ """Lazy load PraisonAI to avoid slow imports."""
16
+ if name == "PraisonAI":
17
+ from .main import PraisonAI
18
+ return PraisonAI
19
+ raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
20
+
21
+
16
22
  def main():
17
23
  """CLI entry point function."""
24
+ from .main import PraisonAI
18
25
  praison_ai = PraisonAI()
19
26
  praison_ai.main()
@@ -26,6 +26,7 @@ Features:
26
26
  - autonomy_mode: Autonomy levels (suggest, auto-edit, full-auto)
27
27
  - cost_tracker: Real-time cost and token tracking
28
28
  - message_queue: Message queuing while agent is processing
29
+ - at_mentions: @ mention autocomplete for files and directories
29
30
  """
30
31
 
31
32
  # Type hints available for IDE support
@@ -58,6 +59,10 @@ __all__ = [
58
59
  'GitIntegrationHandler',
59
60
  'SandboxExecutorHandler',
60
61
  'MessageQueueHandler',
62
+ # @ mention autocomplete
63
+ 'AtMentionCompleter',
64
+ 'CombinedCompleter',
65
+ 'FileSearchService',
61
66
  ]
62
67
 
63
68
  def __getattr__(name):
@@ -138,4 +143,14 @@ def __getattr__(name):
138
143
  elif name == 'MessageQueueHandler':
139
144
  from .message_queue import MessageQueueHandler
140
145
  return MessageQueueHandler
146
+ # @ mention autocomplete
147
+ elif name == 'AtMentionCompleter':
148
+ from .at_mentions import AtMentionCompleter
149
+ return AtMentionCompleter
150
+ elif name == 'CombinedCompleter':
151
+ from .at_mentions import CombinedCompleter
152
+ return CombinedCompleter
153
+ elif name == 'FileSearchService':
154
+ from .at_mentions import FileSearchService
155
+ return FileSearchService
141
156
  raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
@@ -0,0 +1,416 @@
1
+ """
2
+ @ Mention Autocomplete for PraisonAI CLI.
3
+
4
+ Provides file/directory autocomplete when user types @.
5
+ Uses only stdlib imports for zero performance impact.
6
+
7
+ Features:
8
+ - Detect @ trigger in input
9
+ - Fuzzy search files/directories
10
+ - Cache results for performance
11
+ - Integrate with prompt_toolkit
12
+ """
13
+
14
+ import os
15
+ import time
16
+ import fnmatch
17
+ from dataclasses import dataclass
18
+ from typing import List, Optional, Dict, Tuple
19
+
20
+
21
+ # ============================================================================
22
+ # Data Classes
23
+ # ============================================================================
24
+
25
+ @dataclass
26
+ class AtMentionContext:
27
+ """Context for an @ mention in user input."""
28
+ is_active: bool
29
+ query: str
30
+ start_pos: int
31
+ mention_type: str = "file" # file, directory, web, etc.
32
+
33
+
34
+ @dataclass
35
+ class FileSuggestion:
36
+ """A file or directory suggestion."""
37
+ path: str
38
+ file_type: str # "file" or "directory"
39
+ score: int = 100
40
+ display: str = ""
41
+
42
+ def __post_init__(self):
43
+ if not self.display:
44
+ self.display = self.path
45
+
46
+
47
+ # ============================================================================
48
+ # @ Mention Detection
49
+ # ============================================================================
50
+
51
+ def detect_at_mention(text: str, cursor_pos: int) -> Optional[AtMentionContext]:
52
+ """
53
+ Detect if cursor is within an @ mention context.
54
+
55
+ Scans backward from cursor to find @ symbol.
56
+ Returns None if not in @ context.
57
+
58
+ Args:
59
+ text: Full input text
60
+ cursor_pos: Current cursor position
61
+
62
+ Returns:
63
+ AtMentionContext if in @ mention, None otherwise
64
+ """
65
+ if cursor_pos <= 0 or cursor_pos > len(text):
66
+ return None
67
+
68
+ # Scan backward from cursor to find @
69
+ at_pos = -1
70
+ for i in range(cursor_pos - 1, -1, -1):
71
+ char = text[i]
72
+
73
+ # Found @
74
+ if char == '@':
75
+ at_pos = i
76
+ break
77
+
78
+ # Space/newline breaks @ context
79
+ if char in ' \t\n\r':
80
+ return None
81
+
82
+ if at_pos == -1:
83
+ return None
84
+
85
+ # Extract query between @ and cursor
86
+ query = text[at_pos + 1:cursor_pos]
87
+
88
+ return AtMentionContext(
89
+ is_active=True,
90
+ query=query,
91
+ start_pos=at_pos
92
+ )
93
+
94
+
95
+ # ============================================================================
96
+ # File Search Service
97
+ # ============================================================================
98
+
99
+ class FileSearchService:
100
+ """
101
+ Service for searching files in a directory.
102
+
103
+ Features:
104
+ - Walk directory tree
105
+ - Fuzzy match file paths
106
+ - Cache results with TTL
107
+ - Respect .gitignore (basic)
108
+ """
109
+
110
+ def __init__(
111
+ self,
112
+ root_dir: str,
113
+ cache_ttl: int = 30,
114
+ max_depth: int = 5,
115
+ ignore_patterns: Optional[List[str]] = None
116
+ ):
117
+ self._root = os.path.abspath(root_dir)
118
+ self._cache_ttl = cache_ttl
119
+ self._max_depth = max_depth
120
+ self._ignore_patterns = ignore_patterns or [
121
+ '.git', '__pycache__', 'node_modules', '.venv', 'venv',
122
+ '*.pyc', '*.pyo', '.DS_Store', '*.egg-info'
123
+ ]
124
+
125
+ # Cache: query -> (results, timestamp)
126
+ self._cache: Dict[str, Tuple[List[FileSuggestion], float]] = {}
127
+
128
+ # File list cache
129
+ self._file_list: Optional[List[str]] = None
130
+ self._file_list_time: float = 0
131
+
132
+ def _should_ignore(self, name: str) -> bool:
133
+ """Check if file/dir should be ignored."""
134
+ for pattern in self._ignore_patterns:
135
+ if fnmatch.fnmatch(name, pattern):
136
+ return True
137
+ return False
138
+
139
+ def _get_file_list(self) -> List[str]:
140
+ """Get list of all files (cached)."""
141
+ now = time.time()
142
+
143
+ # Return cached if fresh
144
+ if self._file_list is not None and (now - self._file_list_time) < self._cache_ttl:
145
+ return self._file_list
146
+
147
+ files = []
148
+
149
+ try:
150
+ for root, dirs, filenames in os.walk(self._root):
151
+ # Calculate depth
152
+ rel_root = os.path.relpath(root, self._root)
153
+ depth = 0 if rel_root == '.' else rel_root.count(os.sep) + 1
154
+
155
+ if depth > self._max_depth:
156
+ dirs.clear() # Don't descend further
157
+ continue
158
+
159
+ # Filter ignored directories
160
+ dirs[:] = [d for d in dirs if not self._should_ignore(d)]
161
+
162
+ # Add directories
163
+ for d in dirs:
164
+ rel_path = os.path.relpath(os.path.join(root, d), self._root)
165
+ files.append(rel_path + os.sep)
166
+
167
+ # Add files
168
+ for f in filenames:
169
+ if not self._should_ignore(f):
170
+ rel_path = os.path.relpath(os.path.join(root, f), self._root)
171
+ files.append(rel_path)
172
+ except OSError:
173
+ pass
174
+
175
+ self._file_list = files
176
+ self._file_list_time = now
177
+ return files
178
+
179
+ def _fuzzy_match(self, text: str, query: str) -> int:
180
+ """
181
+ Simple fuzzy match scoring.
182
+
183
+ Returns score 0-100, higher is better.
184
+ """
185
+ if not query:
186
+ return 50 # Default score for empty query
187
+
188
+ text_lower = text.lower()
189
+ query_lower = query.lower()
190
+
191
+ # Exact match
192
+ if text_lower == query_lower:
193
+ return 100
194
+
195
+ # Starts with
196
+ if text_lower.startswith(query_lower):
197
+ return 90
198
+
199
+ # Contains
200
+ if query_lower in text_lower:
201
+ return 80
202
+
203
+ # Fuzzy: all query chars appear in order
204
+ text_idx = 0
205
+ query_idx = 0
206
+ matches = 0
207
+
208
+ while text_idx < len(text_lower) and query_idx < len(query_lower):
209
+ if text_lower[text_idx] == query_lower[query_idx]:
210
+ matches += 1
211
+ query_idx += 1
212
+ text_idx += 1
213
+
214
+ if query_idx == len(query_lower):
215
+ # All query chars found
216
+ return 50 + int(30 * matches / len(text))
217
+
218
+ return 0
219
+
220
+ def search(self, query: str, max_results: int = 20) -> List[FileSuggestion]:
221
+ """
222
+ Search for files matching query.
223
+
224
+ Args:
225
+ query: Search query (fuzzy matched)
226
+ max_results: Maximum results to return
227
+
228
+ Returns:
229
+ List of FileSuggestion sorted by score
230
+ """
231
+ # Check cache
232
+ cache_key = f"{query}:{max_results}"
233
+ now = time.time()
234
+
235
+ if cache_key in self._cache:
236
+ results, cached_time = self._cache[cache_key]
237
+ if (now - cached_time) < self._cache_ttl:
238
+ return results
239
+
240
+ # Get all files
241
+ all_files = self._get_file_list()
242
+
243
+ # Score and filter
244
+ scored: List[Tuple[int, str]] = []
245
+ for path in all_files:
246
+ score = self._fuzzy_match(path, query)
247
+ if score > 0:
248
+ scored.append((score, path))
249
+
250
+ # Sort by score descending
251
+ scored.sort(key=lambda x: (-x[0], x[1]))
252
+
253
+ # Build results
254
+ results = []
255
+ for score, path in scored[:max_results]:
256
+ file_type = "directory" if path.endswith(os.sep) else "file"
257
+ results.append(FileSuggestion(
258
+ path=path,
259
+ file_type=file_type,
260
+ score=score
261
+ ))
262
+
263
+ # Cache results
264
+ self._cache[cache_key] = (results, now)
265
+
266
+ return results
267
+
268
+ def clear_cache(self) -> None:
269
+ """Clear all caches."""
270
+ self._cache.clear()
271
+ self._file_list = None
272
+
273
+
274
+ # ============================================================================
275
+ # Completers for prompt_toolkit
276
+ # ============================================================================
277
+
278
+ # Lazy import to avoid performance impact
279
+ _Completer = None
280
+ _Completion = None
281
+
282
+ def _get_prompt_toolkit():
283
+ """Lazy import prompt_toolkit."""
284
+ global _Completer, _Completion
285
+ if _Completer is None:
286
+ from prompt_toolkit.completion import Completer, Completion
287
+ _Completer = Completer
288
+ _Completion = Completion
289
+ return _Completer, _Completion
290
+
291
+
292
+ class AtMentionCompleter:
293
+ """
294
+ Completer for @ mentions.
295
+
296
+ Shows file suggestions when user types @.
297
+ Implements prompt_toolkit Completer interface.
298
+ """
299
+
300
+ def __init__(self, root_dir: str):
301
+ self._file_service = FileSearchService(root_dir)
302
+
303
+ def get_completions(self, document, complete_event):
304
+ """Get completions for @ mentions."""
305
+ _, Completion = _get_prompt_toolkit()
306
+
307
+ text = document.text_before_cursor
308
+ cursor_pos = len(text)
309
+
310
+ # Detect @ context
311
+ context = detect_at_mention(text, cursor_pos)
312
+ if context is None or not context.is_active:
313
+ return
314
+
315
+ # Search files
316
+ results = self._file_service.search(context.query, max_results=15)
317
+
318
+ # Yield completions
319
+ for suggestion in results:
320
+ # Icon based on type
321
+ icon = "📁 " if suggestion.file_type == "directory" else "📄 "
322
+ display = f"{icon}{suggestion.path}"
323
+
324
+ # Calculate replacement position
325
+ # Replace from @ to cursor
326
+ start_position = -(cursor_pos - context.start_pos)
327
+
328
+ yield Completion(
329
+ text=f"@{suggestion.path}",
330
+ start_position=start_position,
331
+ display=display
332
+ )
333
+
334
+
335
+ def create_combined_completer(commands: List[str], root_dir: str):
336
+ """
337
+ Factory function to create a CombinedCompleter.
338
+
339
+ Returns a proper Completer subclass that handles both / and @.
340
+ """
341
+ Completer, Completion = _get_prompt_toolkit()
342
+ file_service = FileSearchService(root_dir)
343
+
344
+ class CombinedCompleter(Completer):
345
+ """
346
+ Combined completer for both / commands and @ mentions.
347
+
348
+ Properly inherits from prompt_toolkit Completer.
349
+ """
350
+
351
+ def get_completions(self, document, complete_event):
352
+ """Get completions for / or @."""
353
+ text = document.text_before_cursor.lstrip()
354
+
355
+ # Check for slash command
356
+ if text.startswith('/'):
357
+ cmd_text = text[1:].lower()
358
+ for cmd in commands:
359
+ if cmd.lower().startswith(cmd_text):
360
+ yield Completion(
361
+ f'/{cmd}',
362
+ start_position=-len(text),
363
+ display=f'/{cmd}'
364
+ )
365
+ return
366
+
367
+ # Check for @ mention
368
+ full_text = document.text_before_cursor
369
+ cursor_pos = len(full_text)
370
+
371
+ context = detect_at_mention(full_text, cursor_pos)
372
+ if context is None or not context.is_active:
373
+ return
374
+
375
+ # Search files
376
+ results = file_service.search(context.query, max_results=15)
377
+
378
+ # Yield completions
379
+ for suggestion in results:
380
+ icon = "📁 " if suggestion.file_type == "directory" else "📄 "
381
+ display = f"{icon}{suggestion.path}"
382
+ start_position = -(cursor_pos - context.start_pos)
383
+
384
+ yield Completion(
385
+ text=f"@{suggestion.path}",
386
+ start_position=start_position,
387
+ display=display
388
+ )
389
+
390
+ return CombinedCompleter()
391
+
392
+
393
+ # Backward compatible alias
394
+ class CombinedCompleter:
395
+ """
396
+ Wrapper class for backward compatibility.
397
+
398
+ Use create_combined_completer() for proper Completer subclass.
399
+ """
400
+
401
+ def __new__(cls, commands: List[str], root_dir: str):
402
+ return create_combined_completer(commands, root_dir)
403
+
404
+
405
+ # ============================================================================
406
+ # Exports
407
+ # ============================================================================
408
+
409
+ __all__ = [
410
+ 'AtMentionContext',
411
+ 'FileSuggestion',
412
+ 'detect_at_mention',
413
+ 'FileSearchService',
414
+ 'AtMentionCompleter',
415
+ 'CombinedCompleter',
416
+ ]