janito 3.7.0__tar.gz → 3.9.0__tar.gz

{janito-3.7.0 → janito-3.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: janito
-Version: 3.7.0
+Version: 3.9.0
 Summary: A new Python package called janito.
 Author-email: João Pinto <janito@ikignosis.org>
 Project-URL: Homepage, https://github.com/ikignosis/janito
@@ -33,30 +33,30 @@ Provides-Extra: coder
 Requires-Dist: janito-coder; extra == "coder"
 Dynamic: license-file
 
-# nctl
+# Janito
 
 ```bash
-$ nctl --help
-Usage: nctl <command>
+$ janito --help
+Usage: janito <command>
 
 Interact with Nine API resources. See https://docs.nineapis.ch for the full API docs.
 
-Run "nctl <command> --help" for more information on a command.
+Run "janito <command> --help" for more information on a command.
 ```
 
 ## Setup
 
 ```bash
 # If you have go already installed
-go install github.com/ninech/nctl@latest
+go install github.com/ninech/janito@latest
 
 # Homebrew
-brew install ninech/taps/nctl
+brew install ninech/taps/janito
 
 # Debian/Ubuntu
 echo "deb [trusted=yes] https://repo.nine.ch/deb/ /" | sudo tee /etc/apt/sources.list.d/repo.nine.ch.list
 sudo apt-get update
-sudo apt-get install nctl
+sudo apt-get install janito
 
 # Fedora/RHEL
 cat <<EOF > /etc/yum.repos.d/repo.nine.ch.repo
@@ -66,19 +66,19 @@ baseurl=https://repo.nine.ch/yum/
 enabled=1
 gpgcheck=0
 EOF
-dnf install nctl
+dnf install janito
 
 # Arch
 # Install yay: https://github.com/Jguer/yay#binary
 yay --version
-yay -S nctl-bin
+yay -S janito-bin
 ```
 
-For Windows users, nctl is also built for arm64 and amd64. You can download the
-latest exe file from the [releases](https://github.com/ninech/nctl/releases) and
+For Windows users, janito is also built for arm64 and amd64. You can download the
+latest exe file from the [releases](https://github.com/ninech/janito/releases) and
 install it.
 
 ## Getting started
 
-* login to the API using `nctl auth login`
-* run `nctl --help` to get a list of all available commands
+* login to the API using `janito auth login`
+* run `janito --help` to get a list of all available commands

janito-3.9.0/README.md

@@ -0,0 +1,49 @@
+# Janito
+
+```bash
+$ janito --help
+Usage: janito <command>
+
+Interact with Nine API resources. See https://docs.nineapis.ch for the full API docs.
+
+Run "janito <command> --help" for more information on a command.
+```
+
+## Setup
+
+```bash
+# If you have go already installed
+go install github.com/ninech/janito@latest
+
+# Homebrew
+brew install ninech/taps/janito
+
+# Debian/Ubuntu
+echo "deb [trusted=yes] https://repo.nine.ch/deb/ /" | sudo tee /etc/apt/sources.list.d/repo.nine.ch.list
+sudo apt-get update
+sudo apt-get install janito
+
+# Fedora/RHEL
+cat <<EOF > /etc/yum.repos.d/repo.nine.ch.repo
+[repo.nine.ch]
+name=Nine Repo
+baseurl=https://repo.nine.ch/yum/
+enabled=1
+gpgcheck=0
+EOF
+dnf install janito
+
+# Arch
+# Install yay: https://github.com/Jguer/yay#binary
+yay --version
+yay -S janito-bin
+```
+
+For Windows users, janito is also built for arm64 and amd64. You can download the
+latest exe file from the [releases](https://github.com/ninech/janito/releases) and
+install it.
+
+## Getting started
+
+* login to the API using `janito auth login`
+* run `janito --help` to get a list of all available commands

{janito-3.7.0 → janito-3.9.0}/docs/about/why.md

@@ -12,7 +12,7 @@ Janito is designed to give you maximum control over how AI assists you with your
 
 - 💻 **Not Locked to an Editor:** Janito works in the terminal, scripts, or web—no need for a heavyweight IDE or plugin ecosystem.
 - 🧰 **Composable and Extensible:** Tools can be enabled, disabled, or customized for each session, letting you experiment or automate workflows.
-- 🕒 **Session-Scoped Adjustments:** Temporary overrides (via CLI options or prompt tweaks) let you try new approaches without changing your global setup.
+- 🕒 **Session-Scoped Adjustments:** Session-based overrides (via CLI options or prompt tweaks) let you try new approaches without changing your global setup.
 
 ## 🧑‍💻 Example: Prompt-Driven Focus
 

{janito-3.7.0 → janito-3.9.0}/docs/changelogs/CHANGELOG.md

@@ -384,7 +384,7 @@ For users upgrading from previous versions:
 - Refactored tool system to use latest git tag for version detection in release script.
 - Refined release script to recommend creating a new git tag if version exists on PyPI.
 - Removed termweb: web file viewer and related CLI/editor features, updated docs and config accordingly.
-- Removed temporary file x.txt.
+- Removed test file x.txt.
 - Restored tool permissions to CLI defaults on /restart; store and retrieve default tool permissions in AllowedPermissionsState. Runner now sets and saves default permissions for restoration. Updated conversation_restart to restore or fallback to all-off permissions.
 - Updated disabled execution tools message for clarity.
 - Docs and UX: clarified permissions (read/write/exec), added profiles doc links, and removed localhost references from UI/toolbar.

{janito-3.7.0 → janito-3.9.0}/docs/changelogs/RELEASE_NOTES_2.22.0.md

@@ -19,7 +19,7 @@
 ### Enhanced fetch_url Tool
 - **Error Handling**: Added intelligent error caching for 403 (Forbidden) and 404 (Not Found) responses
 - **Performance**: Reduced redundant network requests when URLs are known to be inaccessible
-- **Reliability**: Better handling of rate limiting and temporary access restrictions
+- **Reliability**: Better handling of rate limiting and session-based access restrictions
 
 ### Documentation Updates
 - **IBM Setup Guide**: Complete step-by-step documentation for IBM WatsonX configuration

{janito-3.7.0 → janito-3.9.0}/docs/guides/disabled-tools.md

@@ -75,8 +75,8 @@ Disable tools you don't use to reduce clutter:
 janito --set disabled_tools="open_url,open_html_in_browser"
 ```
 
-### Temporary Disabling
-Temporarily disable tools for specific sessions:
+### Session-Based Disabling
+Disable tools for specific sessions:
 ```bash
 janito --set disabled_tools=ask_user "Generate code without user interaction"
 ```

{janito-3.7.0 → janito-3.9.0}/docs/guides/security-commands.md

@@ -101,7 +101,7 @@ Fetch Apple's current stock price from tradingview.com
 # List current restrictions
 /security allowed-sites list
 
-# Temporarily allow all sites
+# Allow all sites for testing
 /security allowed-sites clear
 
 # Re-establish restrictions
@@ -174,7 +174,7 @@ Analyze Apple's financial performance
 # Adding "tradingview.com" also allows "www.tradingview.com", "api.tradingview.com", etc.
 ```
 
-**Problem**: Want to temporarily disable whitelist
+**Problem**: Want to disable whitelist temporarily
 ```
 # Clear all restrictions
 /security allowed-sites clear

{janito-3.7.0 → janito-3.9.0}/docs/guides/tools-developer-guide.md

@@ -17,7 +17,7 @@ For a list of all built-in tools and their usage, see the [Tools Reference](../t
 
 ```python
 from janito.tools.tool_base import ToolBase, ToolPermissions
-from janito.tools.adapters.local.adapter import register_local_tool
+from janito.plugins.adapters.local.adapter import register_local_tool
 
 @register_local_tool
 class MyTool(ToolBase):
@@ -48,7 +48,7 @@ class MyTool(ToolBase):
 2. **Add a class-level docstring** summarizing the tool's purpose (user-facing).
 3. **Implement the `run` method** with type hints and a Google-style docstring, including an `Args:` section for every parameter.
 4. **Set permissions** using `permissions = ToolPermissions(read=True, write=True, execute=True)` as needed.
-5. **Register your tool** with `@register_local_tool` from `janito.tools.adapters.local.adapter`. Set a unique class attribute `tool_name = "your_tool_name"`.
+5. **Register your tool** with `@register_local_tool` from `janito.plugins.adapters.local.adapter`. Set a unique class attribute `tool_name = "your_tool_name"`.
 6. **Document your tool:** Update `docs/tools-index.md` with a short description and usage for your new tool.
 
 ## Docstring Style

{janito-3.7.0 → janito-3.9.0}/docs/guides/url-whitelist.md

@@ -111,10 +111,10 @@ janito "Get Apple's 10-K filing"  # ✅ Works (sec.gov)
 janito "Get Apple's stock price"  # ❌ Blocked (needs tradingview.com)
 ```
 
-### Temporary Access for Testing
+### Testing Access
 
 ```bash
-# Add a site temporarily
+# Add a site for testing
 janito --add-allowed-site test-site.com
 
 # Use it for testing
@@ -176,7 +176,7 @@ janito --add-allowed-site missing-site.com
 # Adding "tradingview.com" also allows "www.tradingview.com", "api.tradingview.com", etc.
 ```
 
-**Problem**: Want to temporarily disable whitelist
+**Problem**: Want to disable whitelist temporarily
 
 ```bash
 # Clear all restrictions

{janito-3.7.0 → janito-3.9.0}/docs/moonshot-setup.md

@@ -35,7 +35,7 @@ janito -p moonshot "Your prompt here"
 
 Janito supports the following Moonshot models:
 
-- `kimi-k2-turbo-preview` (default) - Advanced reasoning model with 128k context window
+- `kimi-k2-0905-preview` (default) - Advanced reasoning model with 128k context window
 - `kimi-k2-turbo-preview` - Turbo version of the advanced reasoning model with 128k context window
 - `kimi-k1-8k` - Standard model with 8k context window
 - `kimi-k1-32k` - Standard model with 32k context window

{janito-3.7.0 → janito-3.9.0}/docs/plugins/architecture.md

@@ -27,10 +27,10 @@ plugins/
 
 ### Implementation Layer
 
-The actual tool implementations are located in `janito/tools/adapters/local/`. This separation ensures that the core functionality remains stable while the plugin interfaces can be organized and extended.
+The actual tool implementations are located in `janito/plugins/tools/local/`. This separation ensures that the core functionality remains stable while the plugin interfaces can be organized and extended.
 
 ```
-janito/tools/adapters/local/
+janito/plugins/tools/local/
 ├── create_file.py
 ├── read_files.py
 ├── view_file.py

{janito-3.7.0 → janito-3.9.0}/docs/plugins/testing.md

@@ -124,7 +124,7 @@ def test_plugin_integration():
     from janito.plugins.manager import PluginManager
     from janito.config import Config
     
-    # Create a temporary config
+    # Create a test config
     config = Config()
     config.set("plugins.load.myplugin", True)
     

{janito-3.7.0 → janito-3.9.0}/docs/reference/cli-options.md

@@ -1,6 +1,6 @@
 # 🏁 Janito CLI Options
 
-This page documents all command-line options for Janito, as shown by `janito --help`. These options temporarily override configuration for a single session and do not persist changes to config files unless you use `--set` or a custom config file with `-c`.
+This page documents all command-line options for Janito, as shown by `janito --help`. These options override configuration for a single session and do not persist changes to config files unless you use `--set` or a custom config file with `-c`.
 
 **Syntax:** `janito [options] [prompt]`
 

{janito-3.7.0 → janito-3.9.0}/docs/supported-providers-models.md

@@ -61,7 +61,8 @@ For setup instructions, see the [Mistral Setup Guide](mistral-setup.md).
 
 ### Moonshot
 
-- **Kimi K2 Turbo Preview** (default) - Latest generation with enhanced performance
+- **Kimi K2 0905 Preview** (default) - Latest generation with enhanced performance
+- **Kimi K2 Turbo Preview** - Turbo version with optimized speed
 - **Kimi K2 0711 Preview** - Previous preview version
 
 Moonshot provides open-source Kimi models with competitive performance.

{janito-3.7.0 → janito-3.9.0}/examples/loop_protection_tool_example.py

@@ -8,7 +8,7 @@ using the @protect_against_loops decorator.
 
 from janito.tools.tool_base import ToolBase, ToolPermissions
 from janito.tools.loop_protection_decorator import protect_against_loops
-from janito.tools.adapters.local.adapter import register_local_tool
+from janito.plugins.tools.local.adapter import register_local_tool
 
 
 @register_local_tool

{janito-3.7.0 → janito-3.9.0}/janito/README.md

@@ -79,7 +79,7 @@ janito --set model=kimi-k1-8k
 
 ### Moonshot (Recommended)
 
-- **Models**: kimi-k1-8k, kimi-k1-32k, kimi-k1-128k, kimi-k2-turbo-preview, kimi-k2-0905-preview
+- **Models**: kimi-k1-8k, kimi-k1-32k, kimi-k1-128k, kimi-k2-turbo-preview
 - **Strengths**: Excellent Chinese/English support, competitive pricing, fast responses
 - **Setup**: Get API key from [Moonshot AI Platform](https://platform.moonshot.cn/)
 

{janito-3.7.0 → janito-3.9.0}/janito/cli/cli_commands/list_tools.py

@@ -53,7 +53,7 @@ def _print_tools_table(console, title, tools_info):
 
 
 def handle_list_tools(args=None):
-    from janito.tools.adapters.local.adapter import LocalToolsAdapter
+    from janito.plugins.tools.local.adapter import LocalToolsAdapter
     import janito.tools  # Ensure all tools are registered
     from janito.tools.tool_base import ToolPermissions
 

{janito-3.7.0 → janito-3.9.0}/janito/cli/prompt_core.py

@@ -14,7 +14,7 @@ from janito.driver_events import (
     RequestStatus,
     RateLimitRetry,
 )
-from janito.tools.tool_events import ToolCallError
+from janito.tools.tool_events import ToolCallError, ToolCallStarted
 import threading
 from janito.cli.verbose_output import print_verbose_header
 from janito.event_bus import event_bus as global_event_bus
@@ -52,8 +52,10 @@ class PromptHandler:
     def _handle_inner_event(self, inner_event, on_event, status):
         if on_event:
             on_event(inner_event)
-        from janito.tools.tool_events import ToolCallFinished
+        from janito.tools.tool_events import ToolCallFinished, ToolCallStarted
 
+        if isinstance(inner_event, ToolCallStarted):
+            return self._handle_tool_call_started(inner_event, status)
         if isinstance(inner_event, ToolCallFinished):
             return self._handle_tool_call_finished(inner_event)
         if isinstance(inner_event, RateLimitRetry):
@@ -76,6 +78,14 @@ class PromptHandler:
         )
         return None
 
+    def _handle_tool_call_started(self, inner_event, status):
+        """Handle ToolCallStarted event - pause the timer when ask_user tool is called."""
+        if hasattr(inner_event, 'tool_name') and inner_event.tool_name == 'ask_user':
+            # Pause the status timer by clearing the status
+            if status:
+                status.update("")
+        return None
+
     def _handle_tool_call_finished(self, inner_event):
         if hasattr(self.args, "verbose_tools") and self.args.verbose_tools:
             self.console.print(
@@ -207,7 +217,42 @@ class PromptHandler:
         """
         try:
             self._print_verbose_debug("Calling agent.chat()...")
-            final_event = self.agent.chat(prompt=user_prompt)
+            
+            # Show waiting status with elapsed time
+            start_time = time.time()
+            
+            # Get provider and model info for status display
+            provider_name = self.agent.get_provider_name() if hasattr(self.agent, 'get_provider_name') else 'LLM'
+            model_name = self.agent.get_model_name() if hasattr(self.agent, 'get_model_name') else 'unknown'
+            
+            status = Status(f"[bold blue]Waiting for {provider_name} (model: {model_name})...[/bold blue]")
+            
+            # Thread coordination event
+            stop_updater = threading.Event()
+            
+            def update_status():
+                elapsed = time.time() - start_time
+                status.update(f"[bold blue]Waiting for {provider_name} (model: {model_name})... ({elapsed:.1f}s)[/bold blue]")
+            
+            # Start status display and update timer
+            with status:
+                # Update status every second in a separate thread
+                def status_updater():
+                    while not stop_updater.is_set():
+                        update_status()
+                        stop_updater.wait(1.0)  # Wait for 1 second or until stopped
+                
+                updater_thread = threading.Thread(target=status_updater, daemon=True)
+                updater_thread.start()
+                
+                try:
+                    final_event = self.agent.chat(prompt=user_prompt)
+                finally:
+                    # Signal the updater thread to stop
+                    stop_updater.set()
+                    # Wait a bit for the thread to clean up
+                    updater_thread.join(timeout=0.1)
+                
             if hasattr(self.agent, "set_latest_event"):
                 self.agent.set_latest_event(final_event)
             self.agent.last_event = final_event

{janito-3.7.0 → janito-3.9.0}/janito/cli/rich_terminal_reporter.py

@@ -74,8 +74,16 @@ class RichTerminalReporter(EventHandlerBase):
         """
         Clears the entire current line in the terminal and returns the cursor to column 1.
         """
-        sys.stdout.write("\033[2K\r")
-        sys.stdout.flush()
+        # Use raw ANSI escape sequences but write directly to the underlying file
+        # to bypass Rich's escaping/interpretation
+        if hasattr(self.console, 'file') and hasattr(self.console.file, 'write'):
+            self.console.file.write("\r\033[2K")
+            self.console.file.flush()
+        else:
+            # Fallback to sys.stdout if console.file is not available
+            import sys
+            sys.stdout.write("\r\033[2K")
+            sys.stdout.flush()
 
     def on_RequestFinished(self, event):
         self.delete_current_line()

{janito-3.7.0 → janito-3.9.0}/janito/docs/GETTING_STARTED.md

@@ -124,7 +124,7 @@ export JANITO_MODEL=ibm/granite-3-3-8b-instruct
 - **kimi-k1-32k**: Better for longer contexts
 - **kimi-k1-128k**: Best for very long documents
 - **kimi-k2-turbo-preview**: Latest model with enhanced capabilities
-- **kimi-k2-0905-preview**: Newest model with 256K context window for handling very large documents and complex tasks
+- **kimi-k2-turbo-preview**: Turbo version of the advanced reasoning model
 
 ### OpenAI Models
 - **gpt-5**: Latest GPT model with advanced capabilities

{janito-3.7.0 → janito-3.9.0}/janito/llm/agent.py

@@ -183,6 +183,9 @@ class LLMAgent:
         elapsed = 0.0
         if getattr(self, "verbose_agent", False):
             print("[agent] [DEBUG] Waiting for event from output_queue...")
+        # Show initial wait message
+        if getattr(self, "verbose_agent", False):
+            print(f"[agent] [DEBUG] Starting to wait for LLM response... (timeout: {max_wait_time}s)")
         # Let KeyboardInterrupt propagate to caller
         return self._poll_for_event(poll_timeout, max_wait_time)
 
@@ -197,6 +200,9 @@ class LLMAgent:
                     print(error_msg)
                     print("[DEBUG] Exiting _process_next_response due to timeout")
                     return None, False
+                # Show elapsed time info while waiting
+                if getattr(self, "verbose_agent", False):
+                    print(f"[agent] [DEBUG] Waiting for LLM response... ({elapsed:.1f}s elapsed)")
                 continue
             if getattr(self, "verbose_agent", False):
                 print(f"[agent] [DEBUG] Received event from output_queue: {event}")

{janito-3.7.0 → janito-3.9.0/janito}/plugins/core/filemanager/tools/validate_file_syntax/core.py

@@ -3,9 +3,9 @@ from janito.tools.path_utils import expand_path
 from janito.i18n import tr
 from janito.tools.tool_base import ToolBase, ToolPermissions
 from janito.report_events import ReportAction
-from janito.tools.adapters.local.adapter import register_local_tool
+from janito.plugins.tools.local.adapter import register_local_tool
 from janito.tools.tool_utils import display_path
-from janito.tools.adapters.local.adapter import register_local_tool as register_tool
+from janito.plugins.tools.local.adapter import register_local_tool as register_tool
 
 from .python_validator import validate_python
 from .json_validator import validate_json
@@ -17,6 +17,7 @@ from .markdown_validator import validate_markdown
 from .js_validator import validate_js
 from .css_validator import validate_css
 from .jinja2_validator import validate_jinja2
+from .txt_validator import validate_txt
 from janito.tools.loop_protection_decorator import protect_against_loops
 
 
@@ -37,6 +38,8 @@ def _get_validator(ext):
         ".css": validate_css,
         ".j2": validate_jinja2,
         ".jinja2": validate_jinja2,
+        ".txt": validate_txt,
+        ".text": validate_txt,
     }
     return mapping.get(ext)
 
@@ -79,6 +82,7 @@ class ValidateFileSyntaxTool(ToolBase):
       - Markdown (.md)
       - JavaScript (.js)
       - Jinja2 templates (.j2, .jinja2)
+      - Text files (.txt, .text) [UTF-8 validation]
 
     Args:
         path (str): Path to the file to validate.
@@ -86,6 +90,7 @@ class ValidateFileSyntaxTool(ToolBase):
         str: Validation status message. Example:
             - "✅ Syntax OK"
             - "⚠️ Warning: Syntax error: <error message>"
+            - "⚠️ Warning: UTF-8 decoding error: <error details>"
             - "⚠️ Warning: Unsupported file extension: <ext>"
     """
 

janito-3.9.0/janito/plugins/core/filemanager/tools/validate_file_syntax/txt_validator.py

@@ -0,0 +1,28 @@
+"""Text file validator for UTF-8 encoding validation."""
+
+import codecs
+from pathlib import Path
+
+
+def validate_txt(path: str) -> str:
+    """
+    Validate a text file for UTF-8 encoding issues.
+    
+    Args:
+        path (str): Path to the text file to validate
+        
+    Returns:
+        str: Validation status message
+            - "✅ Syntax OK" if file is valid UTF-8
+            - "⚠️ Warning: UTF-8 decoding error: <error details>" if invalid
+    """
+    try:
+        # Try to read the file with UTF-8 encoding
+        with codecs.open(path, 'r', encoding='utf-8') as f:
+            # Read the entire file to trigger any decoding errors
+            f.read()
+        return "✅ Syntax OK"
+    except UnicodeDecodeError as e:
+        return f"⚠️ Warning: UTF-8 decoding error: {e}"
+    except Exception as e:
+        return f"⚠️ Warning: File read error: {e}"

{janito-3.7.0 → janito-3.9.0}/janito/plugins/manager.py

@@ -14,7 +14,7 @@ from .base import Plugin, PluginMetadata
 from .discovery import discover_plugins
 from .config import load_plugins_config, get_user_plugins_dir
 from .builtin import BuiltinPluginRegistry, load_builtin_plugin
-from janito.tools.adapters.local import LocalToolsAdapter
+from janito.plugins.tools.local import LocalToolsAdapter
 
 logger = logging.getLogger(__name__)
 

{janito-3.7.0/janito/tools/adapters → janito-3.9.0/janito/plugins/tools}/local/adapter.py

@@ -207,7 +207,7 @@ def register_local_tool(tool=None):
         # Register the tool on a *fresh* adapter instance to avoid circular
         # import issues during package initialisation.  This keeps behaviour
         # identical to the original implementation while still allowing
-        # immediate use via the singleton in janito.tools.adapters.local.
+        # immediate use via the singleton in janito.plugins.tools.local.
         LocalToolsAdapter().register_tool(cls)
         return cls
 

{janito-3.7.0/janito/tools/adapters → janito-3.9.0/janito/plugins/tools}/local/ask_user.py

@@ -1,5 +1,5 @@
 from janito.tools.tool_base import ToolBase, ToolPermissions
-from janito.tools.adapters.local.adapter import register_local_tool
+from janito.plugins.tools.local.adapter import register_local_tool
 from janito.tools.loop_protection_decorator import protect_against_loops
 
 from rich import print as rich_print

{janito-3.7.0/plugins/core/filemanager/tools → janito-3.9.0/janito/plugins/tools/local}/copy_file.py

@@ -2,7 +2,7 @@ import os
 from janito.tools.path_utils import expand_path
 import shutil
 from typing import List, Union
-from janito.tools.adapters.local.adapter import register_local_tool
+from janito.plugins.tools.local.adapter import register_local_tool
 from janito.tools.tool_base import ToolBase, ToolPermissions
 from janito.tools.tool_utils import display_path
 from janito.report_events import ReportAction

{janito-3.7.0/plugins/core/filemanager/tools → janito-3.9.0/janito/plugins/tools/local}/create_directory.py

@@ -1,4 +1,4 @@
-from janito.tools.adapters.local.adapter import register_local_tool
+from janito.plugins.tools.local.adapter import register_local_tool
 
 from janito.tools.tool_utils import display_path
 from janito.tools.tool_base import ToolBase, ToolPermissions

{janito-3.7.0/janito/tools/adapters → janito-3.9.0/janito/plugins/tools}/local/create_file.py

@@ -1,6 +1,6 @@
 import os
 from janito.tools.path_utils import expand_path
-from janito.tools.adapters.local.adapter import register_local_tool
+from janito.plugins.tools.local.adapter import register_local_tool
 
 from janito.tools.tool_utils import display_path
 from janito.tools.tool_base import ToolBase, ToolPermissions
@@ -8,7 +8,7 @@ from janito.report_events import ReportAction
 from janito.i18n import tr
 from janito.tools.loop_protection_decorator import protect_against_loops
 
-from janito.tools.adapters.local.validate_file_syntax.core import validate_file_syntax
+from janito.plugins.tools.local.validate_file_syntax.core import validate_file_syntax
 
 
 @register_local_tool
@@ -30,12 +30,12 @@ class CreateFileTool(ToolBase):
     - Cross-platform path handling (Windows, macOS, Linux)
 
     Args:
-        path (str): Target file path. Supports relative and absolute paths, with automatic
+        path (str, required): Target file path. Supports relative and absolute paths, with automatic
                    expansion of user home directory (~) and environment variables.
                    Examples: "src/main.py", "~/Documents/config.json", "$HOME/.env"
-        content (str): File content to write. Empty string creates empty file.
+        content (str, optional): File content to write. Empty string creates empty file.
                       Supports any text content including Unicode characters, newlines,
-                      and binary-safe text representation.
+                      and binary-safe text representation. Default: "" (empty file)
         overwrite (bool, optional): If True, allows overwriting existing files. Default: False.
                                    When False, prevents accidental overwrites by checking
                                    file existence and showing current content. Always review
@@ -71,6 +71,10 @@ class CreateFileTool(ToolBase):
         ✅ Created file 2 lines.
         ✅ Syntax OK
 
+        Creating empty file:
+        >>> create_file("empty.txt", "")
+        ✅ Created file 0 lines.
+
         Overwrite protection:
         >>> create_file("existing.txt", "new content")
         ❗ Cannot create file: file already exists at 'existing.txt'.
@@ -85,7 +89,7 @@ class CreateFileTool(ToolBase):
     tool_name = "create_file"
 
     @protect_against_loops(max_calls=5, time_window=10.0, key_field="path")
-    def run(self, path: str, content: str, overwrite: bool = False) -> str:
+    def run(self, path: str, content: str = "", overwrite: bool = False) -> str:
         path = expand_path(path)
         disp_path = display_path(path)
         if os.path.exists(path) and not overwrite:

{janito-3.7.0/plugins/core/filemanager/tools → janito-3.9.0/janito/plugins/tools/local}/delete_text_in_file.py

@@ -1,9 +1,9 @@
 from janito.tools.tool_base import ToolBase, ToolPermissions
 from janito.report_events import ReportAction
-from janito.tools.adapters.local.adapter import register_local_tool
+from janito.plugins.tools.local.adapter import register_local_tool
 from janito.i18n import tr
 import shutil
-from janito.tools.adapters.local.validate_file_syntax.core import validate_file_syntax
+from janito.plugins.tools.local.validate_file_syntax.core import validate_file_syntax
 
 
 @register_local_tool