janito 3.15.0__tar.gz → 3.16.0__tar.gz

{janito-3.15.0 → janito-3.16.0}/PKG-INFO

@@ -1,62 +1,62 @@
-Metadata-Version: 2.4
-Name: janito
-Version: 3.15.0
-Summary: A new Python package called janito.
-Author-email: João Pinto <janito@ikignosis.org>
-Project-URL: Homepage, https://github.com/ikignosis/janito
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: attrs==25.3.0
-Requires-Dist: rich==14.0.0
-Requires-Dist: pathspec==0.12.1
-Requires-Dist: setuptools>=61.0
-Requires-Dist: pyyaml>=6.0
-Requires-Dist: jinja2>=3.0.0
-Requires-Dist: prompt_toolkit>=3.0.51
-Requires-Dist: lxml>=5.4.0
-Requires-Dist: requests>=2.32.4
-Requires-Dist: bs4>=0.0.2
-Requires-Dist: questionary>=2.0.1
-Requires-Dist: openai>=1.68.0
-Requires-Dist: Pillow>=10.0.0
-Provides-Extra: dev
-Requires-Dist: pytest; extra == "dev"
-Requires-Dist: pre-commit; extra == "dev"
-Requires-Dist: ruff==0.11.9; extra == "dev"
-Requires-Dist: detect-secrets==1.4.0; extra == "dev"
-Requires-Dist: codespell==2.4.1; extra == "dev"
-Requires-Dist: black; extra == "dev"
-Requires-Dist: questionary>=2.0.1; extra == "dev"
-Requires-Dist: setuptools_scm>=8.0; extra == "dev"
-Requires-Dist: mkdocs; extra == "dev"
-Requires-Dist: mkdocs-material; extra == "dev"
-Requires-Dist: mkdocs-material-extensions; extra == "dev"
-Dynamic: license-file
-
-# Janito
-
-```bash
-$ janito --help
-Usage: janito <command>
-
-A command-line tool for managing your projects.
-
-Run "janito <command> --help" for more information on a command.
-```
-
-## Setup
-
-```bash
-# Install using pip
-pip install janito
-
-# Or install from source
-git clone https://github.com/yourusername/janito.git
-cd janito
-pip install -e .
-```
-
-## Getting started
-
-* Run `janito --help` to get a list of all available commands
+Metadata-Version: 2.4
+Name: janito
+Version: 3.16.0
+Summary: A new Python package called janito.
+Author-email: João Pinto <janito@ikignosis.org>
+Project-URL: Homepage, https://github.com/ikignosis/janito
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: attrs==25.3.0
+Requires-Dist: rich==14.0.0
+Requires-Dist: pathspec==0.12.1
+Requires-Dist: setuptools>=61.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: jinja2>=3.0.0
+Requires-Dist: prompt_toolkit>=3.0.51
+Requires-Dist: lxml>=5.4.0
+Requires-Dist: requests>=2.32.4
+Requires-Dist: bs4>=0.0.2
+Requires-Dist: questionary>=2.0.1
+Requires-Dist: openai>=1.68.0
+Requires-Dist: Pillow>=10.0.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
+Requires-Dist: ruff==0.11.9; extra == "dev"
+Requires-Dist: detect-secrets==1.4.0; extra == "dev"
+Requires-Dist: codespell==2.4.1; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: questionary>=2.0.1; extra == "dev"
+Requires-Dist: setuptools_scm>=8.0; extra == "dev"
+Requires-Dist: mkdocs; extra == "dev"
+Requires-Dist: mkdocs-material; extra == "dev"
+Requires-Dist: mkdocs-material-extensions; extra == "dev"
+Dynamic: license-file
+
+# Janito
+
+```bash
+$ janito --help
+Usage: janito <command>
+
+A command-line tool for managing your projects.
+
+Run "janito <command> --help" for more information on a command.
+```
+
+## Setup
+
+```bash
+# Install using pip
+pip install janito
+
+# Or install from source
+git clone https://github.com/yourusername/janito.git
+cd janito
+pip install -e .
+```
+
+## Getting started
+
+* Run `janito --help` to get a list of all available commands

{janito-3.15.0 → janito-3.16.0}/docs/anthropic-setup.md

@@ -1,63 +1,65 @@
-# Anthropic Setup
-
-To use Anthropic models with Janito, follow these steps:
-
-## 1. Get Your API Key
-
-1. Sign up at [https://console.anthropic.com/](https://console.anthropic.com/)
-2. Navigate to your API keys page
-3. Create a new API key or copy an existing one
-
-## 2. Set the API Key
-
-Set your Anthropic API key using the CLI:
-
-```bash
-janito set-api-key --provider anthropic --key YOUR_API_KEY_HERE
-```
-
-Or set it as an environment variable:
-
-```bash
-export ANTHROPIC_API_KEY="YOUR_API_KEY_HERE"
-```
-
-## 3. Available Models
-
-Janito supports the following Anthropic models:
-
-- `claude-opus-4-20250514` - Most capable model for complex tasks
-- `claude-sonnet-4-20250514` - Balanced performance and cost
-- `claude-3-7-sonnet-20250219` - High-performance model
-- `claude-3-5-haiku-20241022` - Fast and cost-effective
-- `claude-3-5-sonnet-20241022` - Balanced speed and capability
-- `claude-3-haiku-20240307` - Fastest model for simple tasks
-
-## 4. Usage Examples
-
-### List available models
-
-```bash
-janito list-models --provider anthropic
-```
-
-### Use a specific model
-
-```bash
-janito chat --provider anthropic --model claude-3-5-sonnet-20241022
-```
-
-### Set as default provider
-
-```bash
-janito set-config provider=anthropic
-```
-
-## Notes
-
-- Anthropic is accessed through an OpenAI-compatible API endpoint
-- The default model is `claude-3-7-sonnet-20250219`
-- All models support streaming responses
-- Context window sizes vary by model (see [Supported Models](models/supported_models.md) for details)
-
+# Anthropic Setup
+
+To use Anthropic models with Janito, follow these steps:
+
+## 1. Get Your API Key
+
+1. Sign up at [https://console.anthropic.com/](https://console.anthropic.com/)
+2. Navigate to your API keys page
+3. Create a new API key or copy an existing one
+
+## 2. Set the API Key
+
+Set your Anthropic API key using the CLI:
+
+```bash
+janito set-api-key --provider anthropic --key YOUR_API_KEY_HERE
+```
+
+Or set it as an environment variable:
+
+```bash
+export ANTHROPIC_API_KEY="YOUR_API_KEY_HERE"
+```
+
+## 3. Available Models
+
+Janito supports the following Anthropic models:
+
+- `claude-sonnet-4-5-20250929` - Latest model with enhanced agent and coding capabilities
+- `claude-opus-4-1-20250805` - Exceptional model for specialized complex tasks
+- `claude-opus-4-20250514` - High-capability model for complex tasks
+- `claude-sonnet-4-20250514` - Balanced performance and cost
+- `claude-3-7-sonnet-20250219` - High-performance model
+- `claude-3-5-haiku-20241022` - Fast and cost-effective
+- `claude-3-5-sonnet-20241022` - Balanced speed and capability
+- `claude-3-haiku-20240307` - Fastest model for simple tasks
+
+## 4. Usage Examples
+
+### List available models
+
+```bash
+janito list-models --provider anthropic
+```
+
+### Use a specific model
+
+```bash
+janito chat --provider anthropic --model claude-3-5-sonnet-20241022
+```
+
+### Set as default provider
+
+```bash
+janito set-config provider=anthropic
+```
+
+## Notes
+
+- Anthropic is accessed through an OpenAI-compatible API endpoint
+- The default model is `claude-sonnet-4-5-20250929`
+- All models support streaming responses
+- Context window sizes vary by model (see [Supported Models](models/supported_models.md) for details)
+
 For more information, visit the [Anthropic documentation](https://docs.anthropic.com/).

{janito-3.15.0 → janito-3.16.0}/docs/configuration.md

@@ -1,126 +1,126 @@
-# Configuration
-
-Janito's behavior is controlled through a combination of environment variables, configuration files, and CLI commands.
-
-## Configuration Sources (Priority Order)
-
-1. **Command-line arguments** (highest priority)
-2. **Environment variables**
-3. **Configuration file** (`~/.janito/config.yaml`)
-4. **Default values** (lowest priority)
-
-## Environment Variables
-
-| Variable | Description | Example |
-|----------|-------------|---------|
-| `OPENAI_API_KEY` | OpenAI API key | `sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
-| `ANTHROPIC_API_KEY` | Anthropic API key | `sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
-| `GOOGLE_API_KEY` | Google Gemini API key | `AIzaSyBxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
-| `MISTRAL_API_KEY` | Mistral API key | `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
-| `CEREBRAS_API_KEY` | Cerebras API key | `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
-| `ZAI_API_KEY` | Z.AI API key | `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
-| `ALIBABA_API_KEY` | Alibaba Qwen API key | `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
-| `DEEPSEEK_API_KEY` | DeepSeek API key | `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
-| `MOONSHOT_API_KEY` | Moonshot API key | `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
-| `WATSONX_API_KEY` | IBM WatsonX API key | `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
-| `WATSONX_PROJECT_ID` | IBM WatsonX project ID | `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` |
-| `WATSONX_SPACE_ID` | IBM WatsonX space ID | `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` |
-| `AZURE_OPENAI_API_KEY` | Azure OpenAI API key | `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
-| `JANITO_PROVIDER` | Default provider | `openai` |
-
-## Configuration File
-
-The configuration file is located at `~/.janito/config.yaml` and has the following structure:
-
-```yaml
-provider: openai
-azure_deployment_name: my-deployment
-max_tokens: 4096
-default_temperature: 0.7
-enable_tools: true
-```
-
-You can modify this file directly or use the CLI:
-
-```bash
-# Set default provider
-janito set-config provider=openai
-
-# Set Azure deployment name
-janito set-config azure_deployment_name=my-deployment
-
-# View current config
-janito show-config
-```
-
-## Provider-Specific Configuration
-
-### Azure OpenAI
-
-For Azure OpenAI, you must specify your deployment name:
-
-```bash
-janito set-config azure_deployment_name=my-gpt4o-deployment
-```
-
-This maps to the `--model` parameter in CLI commands:
-
-```bash
-janito chat --provider azure_openai
-# Internally uses model: my-gpt4o-deployment
-```
-
-### IBM WatsonX
-
-For IBM WatsonX, you need both API key and project ID:
-
-```bash
-janito set-config watsonx_project_id=your-project-id
-janito set-config watsonx_space_id=your-space-id
-```
-
-## Model Selection
-
-When no model is specified, Janito uses the provider's default model:
-
-- **OpenAI**: `gpt-5`
-- **Anthropic**: `claude-3-7-sonnet-20250219`
-- **Google**: `gemini-2.5-flash`
-- **Mistral**: `mistral-large-latest`
-- **Cerebras**: `qwen-3-coder-480b`
-- **Z.AI**: `glm-4.5`
-- **Alibaba**: `qwen3-next-80b-a3b-instruct`
-- **DeepSeek**: `deepseek-chat`
-- **Moonshot**: `kimi-k2-0905-preview`
-- **IBM WatsonX**: `ibm/granite-3-3-8b-instruct`
-- **Azure OpenAI**: `azure_openai_deployment`
-
-You can override the default model using `--model MODEL_NAME` on any command:
-
-```bash
-janito chat --provider openai --model gpt-4o
-```
-
-### Model@Provider Syntax
-
-For convenience, you can specify both model and provider in a single argument using the `model@provider` syntax:
-
-```bash
-# These are equivalent:
-janito chat --provider openai --model gpt-4o
-janito chat -m gpt-4o@openai
-
-# More examples:
-janito -m claude-3-5-sonnet-20241022@anthropic "Write a Python function"
-janito -m kimi-k1-8k@moonshot "Translate this to Chinese"
-janito -m deepseek-chat@deepseek "Explain machine learning"
-```
-
-This syntax is particularly useful for:
-- Quick one-off commands
-- Scripts and automation
-- Following conventions from tools like Docker
-
-> **Note**: If you specify both `-m model@provider` and `-p provider`, the explicit `-p` flag takes precedence.
-
+# Configuration
+
+Janito's behavior is controlled through a combination of environment variables, configuration files, and CLI commands.
+
+## Configuration Sources (Priority Order)
+
+1. **Command-line arguments** (highest priority)
+2. **Environment variables**
+3. **Configuration file** (`~/.janito/config.yaml`)
+4. **Default values** (lowest priority)
+
+## Environment Variables
+
+| Variable | Description | Example |
+|----------|-------------|---------|
+| `OPENAI_API_KEY` | OpenAI API key | `sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
+| `ANTHROPIC_API_KEY` | Anthropic API key | `sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
+| `GOOGLE_API_KEY` | Google Gemini API key | `AIzaSyBxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
+| `MISTRAL_API_KEY` | Mistral API key | `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
+| `CEREBRAS_API_KEY` | Cerebras API key | `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
+| `ZAI_API_KEY` | Z.AI API key | `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
+| `ALIBABA_API_KEY` | Alibaba Qwen API key | `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
+| `DEEPSEEK_API_KEY` | DeepSeek API key | `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
+| `MOONSHOT_API_KEY` | Moonshot API key | `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
+| `WATSONX_API_KEY` | IBM WatsonX API key | `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
+| `WATSONX_PROJECT_ID` | IBM WatsonX project ID | `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` |
+| `WATSONX_SPACE_ID` | IBM WatsonX space ID | `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` |
+| `AZURE_OPENAI_API_KEY` | Azure OpenAI API key | `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
+| `JANITO_PROVIDER` | Default provider | `openai` |
+
+## Configuration File
+
+The configuration file is located at `~/.janito/config.yaml` and has the following structure:
+
+```yaml
+provider: openai
+azure_deployment_name: my-deployment
+max_tokens: 4096
+default_temperature: 0.7
+enable_tools: true
+```
+
+You can modify this file directly or use the CLI:
+
+```bash
+# Set default provider
+janito set-config provider=openai
+
+# Set Azure deployment name
+janito set-config azure_deployment_name=my-deployment
+
+# View current config
+janito show-config
+```
+
+## Provider-Specific Configuration
+
+### Azure OpenAI
+
+For Azure OpenAI, you must specify your deployment name:
+
+```bash
+janito set-config azure_deployment_name=my-gpt4o-deployment
+```
+
+This maps to the `--model` parameter in CLI commands:
+
+```bash
+janito chat --provider azure_openai
+# Internally uses model: my-gpt4o-deployment
+```
+
+### IBM WatsonX
+
+For IBM WatsonX, you need both API key and project ID:
+
+```bash
+janito set-config watsonx_project_id=your-project-id
+janito set-config watsonx_space_id=your-space-id
+```
+
+## Model Selection
+
+When no model is specified, Janito uses the provider's default model:
+
+- **OpenAI**: `gpt-5`
+- **Anthropic**: `claude-sonnet-4-5-20250929`
+- **Google**: `gemini-2.5-flash`
+- **Mistral**: `mistral-large-latest`
+- **Cerebras**: `qwen-3-coder-480b`
+- **Z.AI**: `glm-4.5`
+- **Alibaba**: `qwen3-next-80b-a3b-instruct`
+- **DeepSeek**: `deepseek-chat`
+- **Moonshot**: `kimi-k2-0905-preview`
+- **IBM WatsonX**: `ibm/granite-3-3-8b-instruct`
+- **Azure OpenAI**: `azure_openai_deployment`
+
+You can override the default model using `--model MODEL_NAME` on any command:
+
+```bash
+janito chat --provider openai --model gpt-4o
+```
+
+### Model@Provider Syntax
+
+For convenience, you can specify both model and provider in a single argument using the `model@provider` syntax:
+
+```bash
+# These are equivalent:
+janito chat --provider openai --model gpt-4o
+janito chat -m gpt-4o@openai
+
+# More examples:
+janito -m claude-sonnet-4-5-20250929@anthropic "Write a Python function"
+janito -m kimi-k1-8k@moonshot "Translate this to Chinese"
+janito -m deepseek-chat@deepseek "Explain machine learning"
+```
+
+This syntax is particularly useful for:
+- Quick one-off commands
+- Scripts and automation
+- Following conventions from tools like Docker
+
+> **Note**: If you specify both `-m model@provider` and `-p provider`, the explicit `-p` flag takes precedence.
+
 > **Note**: The list of available models is automatically synchronized with the codebase. Use `janito list-models --provider PROVIDER` to see all available options.

{janito-3.15.0 → janito-3.16.0}/docs/guides/single-shot-terminal.md

@@ -1,57 +1,57 @@
-# ⚡ One-Shot Terminal
-
-If you want to run a single command or prompt in the terminal shell without entering interactive mode, you can use the "one-shot" feature. This is useful for quick tasks or scripting.
-
-To use one-shot mode, simply provide your prompt as a command-line argument:
-
-```
-janito "what are the key classes of this project?"
-```
-
-Janito will process your request and exit after displaying the result.
-
-### Model and Provider Selection
-
-You can specify which model and provider to use for your one-shot command:
-
-```bash
-# Traditional approach
-janito -p openai -m gpt-4 "what are the key classes of this project?"
-
-# Shorthand syntax (model@provider)
-janito -m gpt-4@openai "what are the key classes of this project?"
-
-# Using a different provider
-janito -m claude-3-5-sonnet-20241022@anthropic "analyze this codebase"
-```
-
-### Shell Command Execution
-
-Janito supports executing shell commands in one-shot mode using the built-in `run_bash_command` and `run_powershell_command` tools:
-
-```bash
-# Execute a bash command
-janito "run_bash_command('ls -la')"
-
-# Execute a PowerShell command  
-janito "run_powershell_command('Get-Process | Select-Object Name, CPU')"
-```
-
-### Quick Permission Setup
-
-For one-shot mode, you can quickly enable all tool permissions using the `/rwx` prefix:
-
-```bash
-# Enable read, write, and execute permissions
-janito /rwx "create a python script and run it"
-
-# Or use individual flags
-janito -r -w -x "create a python script and run it"
-```
-
-> ⚠️ **Warning:** Some models may not complete all required steps in a single-shot (one-off) run. If the model does not act as expected, try appending "; just do it" to your command-line prompt to encourage direct action.
-
-![One-Shot Terminal Shell](../imgs/terminal-one-shot.png)
-
----
-_generated by janito.dev_
+# ⚡ One-Shot Terminal
+
+If you want to run a single command or prompt in the terminal shell without entering interactive mode, you can use the "one-shot" feature. This is useful for quick tasks or scripting.
+
+To use one-shot mode, simply provide your prompt as a command-line argument:
+
+```
+janito "what are the key classes of this project?"
+```
+
+Janito will process your request and exit after displaying the result.
+
+### Model and Provider Selection
+
+You can specify which model and provider to use for your one-shot command:
+
+```bash
+# Traditional approach
+janito -p openai -m gpt-4 "what are the key classes of this project?"
+
+# Shorthand syntax (model@provider)
+janito -m gpt-4@openai "what are the key classes of this project?"
+
+# Using a different provider
+janito -m claude-sonnet-4-5-20250929@anthropic "analyze this codebase"
+```
+
+### Shell Command Execution
+
+Janito supports executing shell commands in one-shot mode using the built-in `run_bash_command` and `run_powershell_command` tools:
+
+```bash
+# Execute a bash command
+janito "run_bash_command('ls -la')"
+
+# Execute a PowerShell command  
+janito "run_powershell_command('Get-Process | Select-Object Name, CPU')"
+```
+
+### Quick Permission Setup
+
+For one-shot mode, you can quickly enable all tool permissions using the `/rwx` prefix:
+
+```bash
+# Enable read, write, and execute permissions
+janito /rwx "create a python script and run it"
+
+# Or use individual flags
+janito -r -w -x "create a python script and run it"
+```
+
+> ⚠️ **Warning:** Some models may not complete all required steps in a single-shot (one-off) run. If the model does not act as expected, try appending "; just do it" to your command-line prompt to encourage direct action.
+
+![One-Shot Terminal Shell](../imgs/terminal-one-shot.png)
+
+---
+_generated by janito.dev_

{janito-3.15.0 → janito-3.16.0}/docs/models/supported_models.md

@@ -86,7 +86,7 @@ This document lists all supported large language models (LLMs) across providers,
 | `qwen3-30b-a3b-instruct-2507` | 129,024 | 32,768 | Alibaba Qwen3 30B A3B Instruct Model (OpenAI-compatible) |
 | `qwen3-next-80b-a3b-instruct` | 262,144 | 65,536 | Alibaba Qwen3-Max Preview (256K) - 80B A3B Instruct Model (OpenAI-compatible) |
 | `qwen3-next-80b-a3b-thinking` | 262,144 | 65,536 | Alibaba Qwen3-Max Preview (256K) - 80B A3B Thinking Model (OpenAI-compatible) |
-| `qwen3-max-preview` | 262,144 | 65,536 | Alibaba Qwen3-Max Preview (256K) - Standard Model (OpenAI-compatible) |
+| `qwen3-max` | 262,144 | 65,536 | Alibaba Qwen3-Max Preview (256K) - Standard Model (OpenAI-compatible) |
 
 ## DeepSeek
 
@@ -126,6 +126,6 @@ Azure OpenAI supports any deployment name configured by the user. The following
 
 > **Note**: Azure OpenAI deployments are user-defined. Use `--provider azure_openai --model YOUR_DEPLOYMENT_NAME` to use any valid deployment.
 
----
+ 
 
 *Last updated from source code: September 2025*